Merge pull request 'v0.1.0' (#17) from dev into master

Reviewed-on: #17

pom.xml

@@ -6,7 +6,7 @@
 
 	<groupId>com.imyeyu.java</groupId>
 	<artifactId>timi-java</artifactId>
-	<version>0.2.0</version>
+	<version>0.1.0</version>
 	<packaging>jar</packaging>
 
 	<properties>

src/main/java/com/imyeyu/java/bean/Language.java

@@ -0,0 +1,74 @@
+package com.imyeyu.java.bean;
+
+import com.imyeyu.java.ref.Ref;
+import lombok.Data;
+
+/**
+ * 多语言
+ *
+ * @author 夜雨
+ * @since 2022-02-23 11:25
+ */
+@Data
+public class Language {
+
+	/**
+	 * 支持语言枚举
+	 *
+	 * @author 夜雨
+	 * @since 2025-12-05 14:31
+	 */
+	public enum Enum {
+
+		/** 英语 */
+		en_US,
+
+		/** 简中 */
+		zh_CN,
+
+		/** 繁中 */
+		zh_TW,
+
+		/** 日语 */
+		ja_JP,
+
+		/** 韩语 */
+		ko_KR,
+
+		/** 俄语 */
+		ru_RU,
+
+		/** 德语 */
+		de_DE;
+	}
+
+	protected String key;
+
+	protected String zhCN;
+
+	protected String zhTW;
+
+	protected String enUS;
+
+	protected String ruRU;
+
+	protected String koKR;
+
+	protected String jaJP;
+
+	protected String deDE;
+
+	/**
+	 * 获取指定语言值
+	 *
+	 * @param language 指定语言
+	 * @return 值
+	 */
+	public String getValue(Enum language) {
+		try {
+			return Ref.getFieldValue(this, language.toString().replace("_", ""), String.class);
+		} catch (IllegalAccessException e) {
+			throw new RuntimeException(e);
+		}
+	}
+}

src/main/java/com/imyeyu/java/bean/LanguageMapping.java

@@ -0,0 +1,54 @@
+package com.imyeyu.java.bean;
+
+import java.util.Map;
+
+/**
+ * 多语言映射接口
+ *
+ * @author 夜雨
+ * @since 2024-04-03 11:27
+ */
+public interface LanguageMapping {
+
+	/**
+	 * 添加映射
+	 *
+	 * @param key   键
+	 * @param value 值
+	 */
+	void add(String key, String value);
+
+	/**
+	 * 是否存在映射
+	 *
+	 * @param key 键
+	 * @return true 为存在
+	 */
+	boolean has(String key);
+
+	/**
+	 * 获取映射值
+	 *
+	 * @param key 键
+	 * @return 值
+	 */
+	String text(String key);
+
+	/**
+	 * 获取映射值，不存在时使用默认值
+	 *
+	 * @param key 键
+	 * @param def 默认值
+	 * @return 值
+	 */
+	String text(String key, String def);
+
+	/**
+	 * 获取映射值并插入参数
+	 *
+	 * @param key     键
+	 * @param argsMap 参数列表
+	 * @return 值
+	 */
+	String textArgs(String key, Map<String, Object> argsMap);
+}

src/main/java/com/imyeyu/java/bean/Multilingual.java

@@ -0,0 +1,21 @@
+package com.imyeyu.java.bean;
+
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+/**
+ * 多语言数据契约
+ *
+ * @author 夜雨
+ * @since 2026-09-18 13:35
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class Multilingual extends Language implements MultilingualValue {
+
+	/** 唯一标识 */
+	private String id;
+
+	/** 业务类型 */
+	private String bizType;
+}

src/main/java/com/imyeyu/java/bean/MultilingualValue.java

@@ -0,0 +1,25 @@
+package com.imyeyu.java.bean;
+
+/**
+ * 多语言值对象
+ *
+ * @author 夜雨
+ * @since 2026-09-18 13:35
+ */
+public interface MultilingualValue {
+
+	/**
+	 * 获取唯一标识
+	 *
+	 * @return 唯一标识
+	 */
+	String getId();
+
+	/**
+	 * 获取指定语言值
+	 *
+	 * @param language 指定语言
+	 * @return 语言值
+	 */
+	String getValue(Language.Enum language);
+}