diff --git a/CHANGELOG.md b/CHANGELOG.md index 0ca63c2ce..53fc15f21 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,7 +3,7 @@ ------------------------------------------------------------------------------------------------------------- -# 5.5.7 (2021-01-03) +# 5.5.7 (2021-01-06) ### 新特性 * 【core 】 DynaBean.create增加重载方法(pr#245@Gitee) @@ -11,6 +11,7 @@ * 【poi 】 SheetRidReader增加getRidByIndex方法(issue#1342@Github) * 【extra 】 MailAccount增加sslProtocols配置项(issue#IZN95@Gitee) * 【extra 】 MailUtil增加getSession方法 +* 【setting】 新增setByGroup和putByGroup,set和put标记为过期(issue#I2C42H@Gitee) ### Bug修复 * 【core 】 修复CsvReader读取双引号未转义问题(issur#I2BMP1@Gitee) diff --git a/hutool-setting/src/main/java/cn/hutool/setting/Setting.java b/hutool-setting/src/main/java/cn/hutool/setting/Setting.java index 44eaff7ce..8f0d3a88b 100644 --- a/hutool-setting/src/main/java/cn/hutool/setting/Setting.java +++ b/hutool-setting/src/main/java/cn/hutool/setting/Setting.java @@ -519,11 +519,25 @@ public class Setting extends AbsSetting implements Map { * @param key 键 * @param value 值 * @return 此key之前存在的值,如果没有返回null + * @deprecated 此方法与getXXX参数顺序不一致容易造成问题,建议使用{@link #putByGroup(String, String, String)} */ + @Deprecated public String put(String group, String key, String value) { return this.groupedMap.put(group, key, value); } + /** + * 将键值对加入到对应分组中 + * + * @param key 键 + * @param group 分组 + * @param value 值 + * @return 此key之前存在的值,如果没有返回null + */ + public String putByGroup(String key, String group, String value) { + return this.groupedMap.put(group, key, value); + } + /** * 从指定分组中删除指定值 * @@ -622,12 +636,29 @@ public class Setting extends AbsSetting implements Map { * @param key 键 * @param value 值 * @return 此key之前存在的值,如果没有返回null + * @deprecated 此方法与getXXX参数顺序不一致容易引起,请使用{@link #setByGroup(String, String, String)} */ + @Deprecated public Setting set(String group, String key, String value) { this.put(group, key, value); return this; } + /** + * 将键值对加入到对应分组中
+ * 此方法用于与getXXX统一参数顺序 + * + * @param key 键 + * @param group 分组 + * @param value 值 + * @return 此key之前存在的值,如果没有返回null + * @since 5.5.7 + */ + public Setting setByGroup(String key, String group, String value) { + this.putByGroup(key, group, value); + return this; + } + // ------------------------------------------------- Override Map interface @Override public boolean isEmpty() {