!973 添加三元组ImmutableTriple/MutableTriple

Merge pull request !973 from Kirno7/v6-dev

hutool-core/src/main/java/org/dromara/hutool/core/tuple/ImmutableTriple.java

@@ -0,0 +1,77 @@
+package org.dromara.hutool.core.tuple;
+
+/**
+ * 不可变三元组对象
+ *
+ * @param <L> 左值类型
+ * @param <M> 中值类型
+ * @param <R> 右值类型
+ * @author kirno7
+ * @since 6.0.0
+ */
+public class ImmutableTriple<L, M, R> extends Triple<L, M, R> {
+	private static final long serialVersionUID = 1L;
+
+	protected final L left;
+	protected final M middle;
+	protected final R right;
+
+	/**
+	 * 构建ImmutableTriple对象
+	 *
+	 * @param <L>    左值类型
+	 * @param <M>    中值类型
+	 * @param <R>    右值类型
+	 * @param left   左值
+	 * @param middle 中值
+	 * @param right  右值
+	 * @return ImmutableTriple
+	 * @since 6.0.0
+	 */
+	public static <L, M, R> ImmutableTriple<L, M, R> of(L left, M middle, R right) {
+		return new ImmutableTriple<>(left, middle, right);
+	}
+
+	/**
+	 * 构造
+	 *
+	 * @param left   左值
+	 * @param middle 中值
+	 * @param right  右值
+	 */
+	private ImmutableTriple(L left, M middle, R right) {
+		this.left = left;
+		this.middle = middle;
+		this.right = right;
+	}
+
+	/**
+	 * 获取左值
+	 *
+	 * @return 左值
+	 */
+	@Override
+	public L getLeft() {
+		return this.left;
+	}
+
+	/**
+	 * 获取中值
+	 *
+	 * @return 中值
+	 */
+	@Override
+	public M getMiddle() {
+		return this.middle;
+	}
+
+	/**
+	 * 获取右值
+	 *
+	 * @return 右值
+	 */
+	@Override
+	public R getRight() {
+		return this.right;
+	}
+}

hutool-core/src/main/java/org/dromara/hutool/core/tuple/MutableTriple.java

@@ -0,0 +1,104 @@
+package org.dromara.hutool.core.tuple;
+
+/**
+ * 可变三元组对象
+ *
+ * @param <L> 左值类型
+ * @param <M> 中值类型
+ * @param <R> 右值类型
+ * @author kirno7
+ * @since 6.0.0
+ */
+public class MutableTriple<L, M, R> extends Triple<L, M, R> {
+	private static final long serialVersionUID = 1L;
+
+	protected L left;
+	protected M middle;
+	protected R right;
+
+	/**
+	 * 构建MutableTriple对象
+	 *
+	 * @param <L>    左值类型
+	 * @param <M>    中值类型
+	 * @param <R>    右值类型
+	 * @param left   左值
+	 * @param middle 中值
+	 * @param right  右值
+	 * @return MutableTriple
+	 * @since 6.0.0
+	 */
+	public static <L, M, R> MutableTriple<L, M, R> of(L left, M middle, R right) {
+		return new MutableTriple<>(left, middle, right);
+	}
+
+	/**
+	 * 构造
+	 *
+	 * @param left   左值
+	 * @param middle 中值
+	 * @param right  右值
+	 */
+	private MutableTriple(L left, M middle, R right) {
+		this.left = left;
+		this.middle = middle;
+		this.right = right;
+	}
+
+	/**
+	 * 获取左值
+	 *
+	 * @return 左值
+	 */
+	@Override
+	public L getLeft() {
+		return this.left;
+	}
+
+	/**
+	 * 获取中值
+	 *
+	 * @return 中值
+	 */
+	@Override
+	public M getMiddle() {
+		return this.middle;
+	}
+
+	/**
+	 * 获取右值
+	 *
+	 * @return 右值
+	 */
+	@Override
+	public R getRight() {
+		return this.right;
+	}
+
+	/**
+	 * 设置左值
+	 *
+	 * @param left 左值
+	 */
+	public void setLeft(L left) {
+		this.left = left;
+	}
+
+	/**
+	 * 设置中值
+	 *
+	 * @param middle 中值
+	 */
+	public void setMiddle(M middle) {
+		this.middle = middle;
+	}
+
+	/**
+	 * 设置右值
+	 *
+	 * @param right 右值
+	 */
+	public void setRight(R right) {
+		this.right = right;
+	}
+}

hutool-core/src/main/java/org/dromara/hutool/core/tuple/Triple.java

@@ -0,0 +1,63 @@
+package org.dromara.hutool.core.tuple;
+
+import java.io.Serializable;
+import java.util.Objects;
+
+/**
+ * 三元组抽象类
+ *
+ * @param <L> 左值类型
+ * @param <M> 中值类型
+ * @param <R> 右值类型
+ * @author kirno7
+ * @since 6.0.0
+ */
+public abstract class Triple<L, M, R> implements Serializable {
+	private static final long serialVersionUID = 1L;
+
+	/**
+	 * 获取左值
+	 *
+	 * @return 左值
+	 */
+	public abstract L getLeft();
+
+	/**
+	 * 获取中值
+	 *
+	 * @return 中值
+	 */
+	public abstract M getMiddle();
+
+	/**
+	 * 获取右值
+	 *
+	 * @return 右值
+	 */
+	public abstract R getRight();
+
+	@Override
+	public boolean equals(Object o) {
+		if (this == o) {
+			return true;
+		}
+		if (o instanceof ImmutableTriple) {
+			ImmutableTriple<?, ?, ?> triple = (ImmutableTriple<?, ?, ?>) o;
+			return Objects.equals(getLeft(), triple.getLeft()) &&
+					Objects.equals(getMiddle(), triple.getMiddle()) &&
+					Objects.equals(getRight(), triple.getRight());
+		}
+		return false;
+	}
+
+	@Override
+	public int hashCode() {
+		return Objects.hashCode(getLeft()) ^ Objects.hashCode(getMiddle()) ^ Objects.hashCode(getRight());
+	}
+
+	@Override
+	public String toString() {
+		return "Triple {" + "left=" + getLeft() + ", middle=" + getMiddle() + ", right=" + getRight() + '}';
+	}
+}
+

hutool-core/src/test/java/org/dromara/hutool/core/tuple/TripleTest.java

@@ -0,0 +1,23 @@
+package org.dromara.hutool.core.tuple;
+
+import org.junit.jupiter.api.Test;
+
+/**
+ * {@link ImmutableTriple} 三元组单元测试
+ * {@link MutableTriple} 三元组单元测试
+ *
+ * @author kirno7
+ */
+public class TripleTest {
+	@Test
+	public void tripleTest() {
+		MutableTriple<String, String, String> mutableTriple = MutableTriple.of("1", "1", "1");
+		System.out.println(mutableTriple);
+		mutableTriple.setLeft("2");
+		mutableTriple.setMiddle("2");
+		mutableTriple.setRight("2");
+		System.out.println(mutableTriple);
+		ImmutableTriple<String, String, String> immutableTriple = ImmutableTriple.of("3", "3", "3");
+		System.out.println(immutableTriple);
+	}
+}