JTuple

java语言版本的元组数据类型，实现了元组类型的特性（不可变、 可迭代）以及常用操作方法

轻量级，无依赖，线程安全

元组的意义

元组最重要的意义是用来实现多值返现。 很多时候我们需要返回一组值，更可怕的是这组值的类型可能并不完全一样，比如http请求时，有请求的返回码（int）以及响应报文（String）

对于java人员来说，遇到这种情况时，一般的解决方案是编写一个类，类里只有2个属性，分别是以上2个，然后返回给调用者。是不是有种胸闷的感觉。折腾，造孽啊

或者就返回一个列表，但是因为类型不统一，只能用List<Object>，后续处理的代码的可读性会很差，我相信任何一个技术水平过关或者有职业操守的程序员都不会这么做

元组的出现，就是为了解决这种情况的，很多年轻的语言（Python, Scala...）都内置了元组，本项目就是让Java开发人员也可以享受到元组带来的编程时的便捷和快乐

主要实现

类名	描述
Tuple	元组抽象，实现元组数据结构以及常用操作方法
Tuple0	空元组，不包含任何元素
Tuple1	只包含1个元素的元组
Tuple2	只包含2个元素的元组
Tuple3	只包含3个元素的元组
Tuple4	只包含4个元素的元组
Tuple5	只包含5个元素的元组
TupleN	包含N个元素的元组
Tuples	提供优雅使用元组方式的工具类

元组操作

操作API	说明
add	元组合并
foreach	元组迭代
forEachWithIndex	元组带序号迭代
reverse	元组翻转
toArray	元组转成数组
toList	元组转成列表
get	获取元组某一个元素
contains	元组中是否包含某个元素
subTuple	截取子元组
equals	比较2个元组内容是否相同
toString	输出字符串表示的元组，如: (123, 456)
repeat	重复元组内的所有元素
stream	将元组转换成流，类似List.stream
parallelStream	将元组转换成并行流，类似List.parallelStream
sort	将元组列表（数组）进行排序

API使用样例

//静态导入工具类，然后开始优雅的使用元组吧
import static com.github.sd4324530.jtuple.Tuples.tuple;

//读取指定位置元素
Tuple2<String, Integer> tuple = tuple("test", 123);
log.debug("first:{}", tuple2.first);//test
log.debug("second:{}", tuple2.second);//123

//toString
Tuple4<String, Integer, Boolean, Double> tuple = tuple("test", 123, true, 186.5);
log.debug("tuple4:{}", tuple.toString());//(test, 123, true, 186.5)

//元组遍历
Tuple5<String, Integer, Boolean, Double, Character> tuple = tuple("test", 123, true, 186.5, 'A');
//方式1
tuple.forEach(o -> log.debug(Objects.toString(o)));
//方式2
for (Object object : tuple) {
  log.debug(Objects.toString(object));
}

//元组合并
Tuple1<String> tuple1 = tuple("hello");
Tuple2<String, String> tuple2 = tuple("world", "!");
Tuple3<Integer, Integer, Integer> tuple3 = tuple(1, 2, 3);
log.debug("add:{}", tuple1.add(tuple2).toString());//(hello, world, !)
log.debug("add:{}", tuple1.add(tuple2, tuple3).toString());//(hello, world, !, 1, 2, 3)

//元组翻转
Tuple4<String, Integer, Boolean, Double> tuple = tuple("hello", 123, true, 186.5);
log.debug("reverse:{}", tuple.reverse().toString());//(186.5, true, 123, hello)

//元组重复
Tuple2<String, String> tuple2 = tuple("a", "b");
log.debug("repeat:{}", tuple2.repeat(3).toString());//(a, b, a, b, a, b)

//截取子元组
TupleN tupleN = tuple(0, 1, 2, 3, 4, 5, 6);
log.debug("sub:{}", tupleN.subTuple(0, 3).toString());//(0, 1, 2, 3)

//转换成流
Tuple5<String, Integer, Boolean, Object, Double> tuple5 = tuple("hello", 123, true, null, 186.5);
tuple5.stream().forEach(o -> log.debug("元素:{}", o));

//元组列表排序
//静态导入工具类
import static com.github.sd4324530.jtuple.Tuples.tuple;
import static com.github.sd4324530.jtuple.Tuples.sort;

List<Tuple2> list = new ArrayList<>();
list.add(tuple(5, "5"));
list.add(tuple(2, "2"));
list.add(tuple(3, "3"));
list.add(tuple(1, "1"));
list.add(tuple(4, "4"));
log.debug("before:{}", list);
//按第一列Integer类型升序
sort(list, 0, Integer::compare);
log.debug("after:{}", list);//1, 2, 3, 4, 5

//元组数组排序
//静态导入工具类
import static com.github.sd4324530.jtuple.Tuples.tuple;
import static com.github.sd4324530.jtuple.Tuples.sort;

Tuple2[] array = new Tuple2[5];
array[0] = tuple("5", 5);
array[1] = tuple("2", 2);
array[2] = tuple("3", 3);
array[3] = tuple("1", 1);
array[4] = tuple("4", 4);
log.debug("before:{}", Arrays.toString(array));
//按第一列String类型升序
sort(array, 0, String::compareTo);
log.debug("after:{}", Arrays.toString(array));

元组使用场景样例

http请求封装

public class HttpKit {

    /**
     * http get 请求
     *
     * @param url 请求url
     * @return 请求结果元组，第一个元素为请求返回码，第二个参数为返回内容，第三个参数为请求失败时的异常
     */
    public Tuple3<Integer, String, Exception> get(String url) {
        //发送请求，解析结果
        return null;
    }
}

数据库操作封装

public class DbKit {

  import static com.github.sd4324530.jtuple.Tuples.tuple;
    /**
     * 执行查询sql
     *
     * @param sql 查询sql
     * @return 执行结果元组，第一个元素用来判断执行是否出现异常，如果为null，则表示成功；第二个参数为查询结果
     */
    public Tuple2<Exception, List<Object>> query(String sql) {
        try (Connection connection = getConn(); Statement statement = connection.createStatement(); ResultSet resultSet = statement.executeQuery(sql)) {
            List<Object> data = handleResult(resultSet);
            return tuple(null, data);
        } catch (Exception e) {
            return tuple(e, null);
        }
    }
}

引入(jdk >= 1.8)

<dependency>
     <groupId>com.github.sd4324530</groupId>
     <artifactId>JTuple</artifactId>
     <version>1.2.1</version>
</dependency>

sd4324530/JTuple

JTuple

元组的意义

主要实现

元组操作

API使用样例

元组使用场景样例

引入(jdk >= 1.8)

简介

发行版

贡献者

近期动态

sd4324530/JTuple .gitee-modal { width: 500px !important; }

JTuple

元组的意义

主要实现

元组操作

API使用样例

元组使用场景样例

引入(jdk >= 1.8)

简介

发行版

开源评估指数源自 OSS-Compass 评估体系，评估体系围绕以下三个维度对项目展开评估：

贡献者

近期动态

搜索帮助

sd4324530/JTuple