🚀release5.8.43

Author: chinabugotech

CHANGELOG.md

@@ -1,5 +1,42 @@
 
 # 🚀Changelog
+-------------------------------------------------------------------------------------------------------------
+# 5.8.43(2026-01-04)
+
+### 🐣新特性
+* 【core   】      `ColorUtil`颜色名称DARKGOLD、LIGHTGOLD新增蛇形命名匹配（pr#1400@Github）
+* 【core   】      添加`BeanPath`方法中对“*”的处理逻辑（pr#1412@Gitee）
+* 【core   】      `StrUtil`添加`reverseByCodePoint`方法（pr#4187@Github）
+* 【core   】      `JdkUtil`添加`IS_AT_LEAST_JDK25`
+* 【core   】      `HexUtil.toHex`添加对float和double的支持，并提供反向方法（pr#4193@Github）
+* 【core   】      增强`BitSetBloomFilter`构造器的参数有效性校验逻辑（pr#4194@Github）
+* 【core   】      `HexUtil.isHexNumber`增加空检查（pr#1420@Gitee）
+* 【core   】      `BooleanUtil`增加中文、英文及符号布尔值的识别能力（pr#1429@Gitee）
+* 【core   】      `DataBetween`类的构造函数中做 defensive copy（pr#1426@Gitee）
+* 【core   】      `RadixUtil.decode`添加校验（pr#1422@Gitee）
+* 【core   】      `CharUtil.toCloseByNumber`增加下边界检查（pr#1421@Gitee）
+* 【ai     】      增加`gemini`支持（pr#4205@Github）
+
+### 🐞Bug修复
+* 【core       】  修复`Calculator.conversion`方法计算包含科学计数法表达式的值时逻辑有误，结果不符合预期（pr#4172@Github）
+* 【core       】  修复`NumberUtil.getBinaryStr`方法计算Double等丢失小数问题（pr#1411@Gitee）
+* 【core       】  修复`MathUtil.multiple`方法在大整数乘法运算中整数溢出风险（pr#4174@Github）
+* 【core       】  修复`CharSequenceUtil.move`方法在局部循环位移中输出不符合预期问题（issue#IDD181@Gitee）
+* 【bloomFilter】  修复`AbstractFilter`的`init`方法在`maxValue`小于`machineNum`时导致数组越界异常（pr#4189@Github）
+* 【ai         】  修复`Models`枚举命名大小写混用问题（pr#4185@Github）
+* 【core       】  修复`ThreadUtil.getMainThread`在JDK25中返回null的问题（pr#1416@Gitee）
+* 【core       】  修复`NumberUtil.parseNumber`使用中文逗号导致识别问题（issue#4197@Github）
+* 【crypto     】  修复`SecureUtil.hmacSha1`和`hmacSha256`生成随机密钥时存在逻辑问题（pr#4199@Github）
+* 【core       】  修复`StopWatch.stop`时间回拨时计算结果为负的问题（pr#1417@Gitee）
+* 【core       】  修复`SplitIter.reset`后无法重新迭代的问题（pr#1418@Gitee）
+* 【core       】  修复`StrMatcher`连续变量解析导致的歧义问题（pr#1419@Gitee）
+* 【ai         】  修复`BaseAIService`发送请求方法中try/catch块捕获的应该是Exception而不是自定义的AIException（pr#1430@Gitee）
+* 【core       】  修复`StrUtil.truncateByByteLength`在限制长度小于...时报错问题（issue#IDFTJS@Gitee）
+* 【core       】  修复`Calculator.conversion`方法计算包含%连接一元运算符的计算表达式的结果时逻辑缺陷（pr#4191@Github）
+* 【db         】  修复`SqlUtil.PATTERN_IN_CLAUSE`逻辑缺陷导致in语句参数不正确的问题（pr#4203@Github）
+* 【json       】  修复`ObjectMapper`过滤器对Bean复制无效的问题（pr#1431@Gitee）
+* 【core       】  修复`DateUnit`毫秒转换问题（issue#4209@Github）
+
 -------------------------------------------------------------------------------------------------------------
 # 5.8.42(2025-11-28)
 

hutool-ai/pom.xml

@@ -6,7 +6,11 @@
 	<parent>
 		<groupId>cn.hutool</groupId>
 		<artifactId>hutool-parent</artifactId>
+<<<<<<< HEAD
 		<version>5.8.43-SNAPSHOT</version>
+=======
+		<version>5.8.43</version>
+>>>>>>> v5-dev
 	</parent>
 
 	<artifactId>hutool-ai</artifactId>

hutool-ai/src/main/java/cn/hutool/ai/AIUtil.java

@@ -21,6 +21,7 @@
 import cn.hutool.ai.core.Message;
 import cn.hutool.ai.model.deepseek.DeepSeekService;
 import cn.hutool.ai.model.doubao.DoubaoService;
+import cn.hutool.ai.model.gemini.GeminiService;
 import cn.hutool.ai.model.grok.GrokService;
 import cn.hutool.ai.model.hutool.HutoolService;
 import cn.hutool.ai.model.openai.OpenaiService;
@@ -114,6 +115,17 @@ public static OpenaiService getOpenAIService(final AIConfig config) {
 		return getAIService(config, OpenaiService.class);
 	}
 
+	/**
+	 * 获取Gemini模型服务
+	 *
+	 * @param config 创建的AI服务模型的配置
+	 * @return GeminiService
+	 * @since 5.8.43
+	 */
+	public static GeminiService getGeminiService(final AIConfig config) {
+		return getAIService(config, GeminiService.class);
+	}
+
 	/**
 	 * AI大模型对话功能
 	 *

hutool-ai/src/main/java/cn/hutool/ai/ModelName.java

@@ -47,7 +47,11 @@ public enum ModelName {
 	/**
 	 * ollama
 	 */
-	OLLAMA("ollama");
+	OLLAMA("ollama"),
+	/**
+	 * gemini
+	 */
+	GEMINI("gemini");
 
 	private final String value;
 

hutool-ai/src/main/java/cn/hutool/ai/Models.java

@@ -109,10 +109,6 @@ public enum Doubao {
 		DOUBAO_1_5_PRO_32K("doubao-1.5-pro-32k-250115"),
 		DOUBAO_1_5_PRO_256K("doubao-1.5-pro-256k-250115"),
 		DOUBAO_1_5_LITE_32K("doubao-1.5-lite-32k-250115"),
-		DEEPSEEK_R1("deepseek-r1-250120"),
-		DEEPSEEK_R1_DISTILL_QWEN_32B("deepseek-r1-distill-qwen-32b-250120"),
-		DEEPSEEK_R1_DISTILL_QWEN_7B("deepseek-r1-distill-qwen-7b-250120"),
-		DEEPSEEK_V3("deepseek-v3-241226"),
 		DOUBAO_PRO_4K_240515("doubao-pro-4k-240515"),
 		DOUBAO_PRO_4K_CHARACTER_240728("doubao-pro-4k-character-240728"),
 		DOUBAO_PRO_4K_FUNCTIONCALL_240615("doubao-pro-4k-functioncall-240615"),
@@ -127,7 +123,11 @@ public enum Doubao {
 		DOUBAO_LITE_4K_PRETRAIN_CHARACTER_240516("doubao-lite-4k-pretrain-character-240516"),
 		DOUBAO_LITE_32K_240828("doubao-lite-32k-240828"),
 		DOUBAO_LITE_32K_CHARACTER_241015("doubao-lite-32k-character-241015"),
-		DOUBAO_LITE_128K_240828("240828"),
+		DOUBAO_LITE_128K_240828("doubao-lite-128k-240828"),
+		DEEPSEEK_R1("deepseek-r1-250120"),
+		DEEPSEEK_R1_DISTILL_QWEN_32B("deepseek-r1-distill-qwen-32b-250120"),
+		DEEPSEEK_R1_DISTILL_QWEN_7B("deepseek-r1-distill-qwen-7b-250120"),
+		DEEPSEEK_V3("deepseek-v3-241226"),
 		MOONSHOT_V1_8K("moonshot-v1-8k"),
 		MOONSHOT_V1_32K("moonshot-v1-32k"),
 		MOONSHOT_V1_128K("moonshot-v1-128k"),
@@ -141,10 +141,10 @@ public enum Doubao {
 		DOUBAO_EMBEDDING_TEXT_240715("doubao-embedding-text-240715"),
 		DOUBAO_EMBEDDING_VISION("doubao-embedding-vision-241215"),
 		DOUBAO_SEEDREAM_3_0_T2I("doubao-seedream-3-0-t2i-250415"),
-		Doubao_Seedance_1_0_lite_t2v("doubao-seedance-1-0-lite-t2v-250428"),
-		Doubao_Seedance_1_0_lite_i2v("doubao-seedance-1-0-lite-i2v-250428"),
-		Wan2_1_14B_t2v("wan2-1-14b-t2v-250225"),
-		Wan2_1_14B_i2v("wan2-1-14b-i2v-250225");
+		DOUBAO_SEEDDANCE_1_0_LITE_T2V("doubao-seedance-1-0-lite-t2v-250428"),
+		DOUBAO_SEEDDANCE_1_0_lite_I2V("doubao-seedance-1-0-lite-i2v-250428"),
+		WAN2_1_14B_T2V("wan2-1-14b-t2v-250225"),
+		WAN2_1_14B_I2V("wan2-1-14b-i2v-250225");
 
 		private final String model;
 
@@ -174,7 +174,7 @@ public enum Grok {
 		GROK_2_IMAGE_LATEST("grok-2-image-1212"),
 		GROK_2_IMAGE("grok-2-image-1212"),
 		GROK_2_IMAGE_1212("grok-2-image-1212"),
-		grok_2_latest("grok-2-1212"),
+		GROK_2_LATEST("grok-2-1212"),
 		GROK_2("grok-2-1212"),
 		GROK_2_1212("grok-2-1212"),
 		GROK_2_VISION_1212("grok-2-vision-1212"),
@@ -207,4 +207,42 @@ public String getModel() {
 		}
 	}
 
+	// Gemini的模型
+	public enum Gemini {
+		GEMINI_2_5_PRO_PREVIEW_TTS("gemini-2.5-pro-preview-tts"),
+		GEMINI_2_5_FLASH_PREVIEW_TTS("gemini-2.5-flash-preview-tts"),
+		VEO_2_0_GENERATE_001("veo-2.0-generate-001"),
+		VEO_3_0_FAST_GENERATE_001("veo-3.0-fast-generate-001"),
+		VEO_3_0_GENERATE_001("veo-3.0-generate-001"),
+		VEO_3_1_FAST_GENERATE_PREVIEW("veo-3.1-fast-generate-preview"),
+		VEO_3_1_GENERATE_PREVIEW("veo-3.1-generate-preview"),
+		IMAGEN_4_0_GENERATE_001("imagen-4.0-generate-001"),
+		IMAGEN_4_0_ULTRA_GENERATE_001("imagen-4.0-ultra-generate-001"),
+		IMAGEN_4_0_FAST_GENERATE_001("imagen-4.0-fast-generate-001"),
+		IMAGEN_3_0_GENERATE_002("imagen-3.0-generate-002"),
+		GEMINI_3_PRO_PREVIEW("gemini-3-pro-preview"),
+		GEMINI_3_FLASH("gemini-3-flash"),
+		GEMINI_2_5_PRO("gemini-2.5-pro"),
+		GEMINI_2_5_FLASH("gemini-2.5-flash"),
+		GEMINI_2_5_FLASH_LITE("gemini-2.5-flash-lite"),
+		GEMINI_2_5_FLASH_IMAGE("gemini-2.5-flash-image"),
+		GEMINI_2_0_FLASH("gemini-2.0-flash"),
+		GEMINI_2_0_FLASH_LITE("gemini-2.0-flash-lite"),
+		GEMINI_2_0_PRO_EXP("gemini-2.0-pro-exp"),
+		GEMINI_1_5_FLASH("gemini-1.5-flash"),
+		GEMINI_1_5_PRO("gemini-1.5-pro"),
+		GEMINI_1_5_FLASH_8B("gemini-1.5-flash-8b"),
+		GEMINI_1_0_PRO("gemini-1.0-pro");
+
+		private final String model;
+
+		Gemini(String model) {
+			this.model = model;
+		}
+
+		public String getModel() {
+			return model;
+		}
+	}
+
 }

hutool-ai/src/main/java/cn/hutool/ai/core/BaseAIService.java

@@ -66,7 +66,7 @@ protected HttpResponse sendGet(final String endpoint) {
 				httpRequest.setProxy(config.getProxy());
 			}
 			return httpRequest.execute();
-		} catch (final AIException e) {
+		} catch (final Exception e) {
 			throw new AIException("Failed to send GET request: " + e.getMessage(), e);
 		}
 	}
@@ -90,7 +90,7 @@ protected HttpResponse sendPost(final String endpoint, final String paramJson) {
 				httpRequest.setProxy(config.getProxy());
 			}
 			return httpRequest.execute();
-		} catch (final AIException e) {
+		} catch (final Exception e) {
 			throw new AIException("Failed to send POST request：" + e.getMessage(), e);
 		}
 
@@ -116,7 +116,7 @@ protected HttpResponse sendFormData(final String endpoint, final Map<String, Obj
 				httpRequest.setProxy(config.getProxy());
 			}
 			return httpRequest.execute();
-		} catch (final AIException e) {
+		} catch (final Exception e) {
 			throw new AIException("Failed to send POST request：" + e.getMessage(), e);
 		}
 	}

hutool-ai/src/main/java/cn/hutool/ai/model/gemini/GeminiCommon.java

@@ -0,0 +1,140 @@
+/*
+ * Copyright (c) 2025 Hutool Team and hutool.cn
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package cn.hutool.ai.model.gemini;
+
+/**
+ * gemini公共类
+ *
+ * @author elichow
+ * @since 5.8.43
+ */
+public class GeminiCommon {
+
+	//要生成的图片数量
+	public enum GeminiImageCount {
+
+		ONE(1),
+		TWO(2),
+		THREE(3),
+		FOUR(4);
+
+		private final int count;
+
+		GeminiImageCount(int count) {
+			this.count = count;
+		}
+
+		public int getCount() {
+			return count;
+		}
+	}
+
+	//生成的图片大小 (imageSize) - 仅限 Standard 和 Ultra
+	public enum GeminiImageSize {
+
+		SIZE_1K("1K"),
+		SIZE_2K("2K");
+
+		private final String value;
+
+		GeminiImageSize(String value) {
+			this.value = value;
+		}
+
+		public String getValue() {
+			return value;
+		}
+	}
+
+	//宽高比
+	public enum GeminiAspectRatio {
+
+		SQUARE("1:1"),
+		PORTRAIT_3_4("3:4"),
+		LANDSCAPE_4_3("4:3"),
+		PORTRAIT_9_16("9:16"),
+		LANDSCAPE_16_9("16:9");
+
+		private final String ratio;
+
+		GeminiAspectRatio(String ratio) {
+			this.ratio = ratio;
+		}
+
+		public String getRatio() {
+			return ratio;
+		}
+
+	}
+
+	//人物生成权限
+	public enum GeminiPersonGeneration {
+
+		DONT_ALLOW("dont_allow"),
+		ALLOW_ADULT("allow_adult"),
+		ALLOW_ALL("allow_all");
+
+		private final String value;
+
+		GeminiPersonGeneration(String value) {
+			this.value = value;
+		}
+
+		public String getValue() {
+			return value;
+		}
+	}
+
+	//生成的视频的时长
+	public enum GeminiDurationSeconds {
+
+		FOUR(4),
+		SIX(6),
+		EIGHT(8);
+
+		private final Integer value;
+
+		GeminiDurationSeconds(Integer value) {
+			this.value = value;
+		}
+
+		public Integer getValue() {
+			return value;
+		}
+	}
+
+	//语音音色
+	public enum GeminiVoice {
+
+		AOEDE("Aoede"),
+		CHARON("Charon"),
+		KORE("Kore"),
+		FENRIR("Fenrir"),
+		PUCK("Puck");
+
+		private final String value;
+
+		GeminiVoice(String value) {
+			this.value = value;
+		}
+
+		public String getValue() {
+			return value;
+		}
+	}
+
+}