From 5c7906c1b02fff5d0e2977a5bec38c42bcf154a8 Mon Sep 17 00:00:00 2001 From: Looly Date: Tue, 26 Oct 2021 04:31:50 +0800 Subject: [PATCH] fix comment --- .../hutool/core/bean/copier/CopyOptions.java | 7 ++--- .../main/java/cn/hutool/core/lang/Assert.java | 27 ++++++++++++------- .../main/java/cn/hutool/core/net/RFC3986.java | 2 +- .../java/cn/hutool/core/util/ZipUtil.java | 5 +++- 4 files changed, 27 insertions(+), 14 deletions(-) diff --git a/hutool-core/src/main/java/cn/hutool/core/bean/copier/CopyOptions.java b/hutool-core/src/main/java/cn/hutool/core/bean/copier/CopyOptions.java index 4cab13809..b0e35315f 100644 --- a/hutool-core/src/main/java/cn/hutool/core/bean/copier/CopyOptions.java +++ b/hutool-core/src/main/java/cn/hutool/core/bean/copier/CopyOptions.java @@ -242,10 +242,11 @@ public class CopyOptions implements Serializable { } /** - * 转换字段名为编辑后的字段名 + * 编辑字段值 * - * @param fieldName 字段名 - * @return 编辑后的字段名 + * @param fieldName 字段名 + * @param fieldValue 字段值 + * @return 编辑后的字段值 * @since 5.7.15 */ protected Object editFieldValue(String fieldName, Object fieldValue) { diff --git a/hutool-core/src/main/java/cn/hutool/core/lang/Assert.java b/hutool-core/src/main/java/cn/hutool/core/lang/Assert.java index fd4751d6a..a33b2a4ed 100644 --- a/hutool-core/src/main/java/cn/hutool/core/lang/Assert.java +++ b/hutool-core/src/main/java/cn/hutool/core/lang/Assert.java @@ -840,6 +840,7 @@ public class Assert { /** * 检查值是否在指定范围内 * + * @param 异常类型 * @param value 值 * @param min 最小值（包含） * @param max 最大值（包含） @@ -859,9 +860,11 @@ public class Assert { /** * 检查值是否在指定范围内 * - * @param value 值 - * @param min 最小值（包含） - * @param max 最大值（包含） + * @param value 值 + * @param min 最小值（包含） + * @param max 最大值（包含） + * @param errorMsgTemplate 异常信息模板，类似于"aa{}bb{}cc" + * @param params 异常信息参数，用于替换"{}"占位符 * @return 经过检查后的值 * @since 5.7.15 */ @@ -885,6 +888,7 @@ public class Assert { /** * 检查值是否在指定范围内 * + * @param 异常类型 * @param value 值 * @param min 最小值（包含） * @param max 最大值（包含） @@ -904,9 +908,11 @@ public class Assert { /** * 检查值是否在指定范围内 * - * @param value 值 - * @param min 最小值（包含） - * @param max 最大值（包含） + * @param value 值 + * @param min 最小值（包含） + * @param max 最大值（包含） + * @param errorMsgTemplate 异常信息模板，类似于"aa{}bb{}cc" + * @param params 异常信息参数，用于替换"{}"占位符 * @return 经过检查后的值 * @since 5.7.15 */ @@ -930,6 +936,7 @@ public class Assert { /** * 检查值是否在指定范围内 * + * @param 异常类型 * @param value 值 * @param min 最小值（包含） * @param max 最大值（包含） @@ -949,9 +956,11 @@ public class Assert { /** * 检查值是否在指定范围内 * - * @param value 值 - * @param min 最小值（包含） - * @param max 最大值（包含） + * @param value 值 + * @param min 最小值（包含） + * @param max 最大值（包含） + * @param errorMsgTemplate 异常信息模板，类似于"aa{}bb{}cc" + * @param params 异常信息参数，用于替换"{}"占位符 * @return 经过检查后的值 * @since 5.7.15 */ diff --git a/hutool-core/src/main/java/cn/hutool/core/net/RFC3986.java b/hutool-core/src/main/java/cn/hutool/core/net/RFC3986.java index b8ca1ad72..713b082c2 100644 --- a/hutool-core/src/main/java/cn/hutool/core/net/RFC3986.java +++ b/hutool-core/src/main/java/cn/hutool/core/net/RFC3986.java @@ -16,7 +16,7 @@ public class RFC3986 { public static final PercentCodec GEN_DELIMS = PercentCodec.of(":/?#[]&"); /** - * sub-delims = "!" / "$" / "&" / "'" / "(" / ")" / "*" / "+" / "," / ";" / "=" + * sub-delims = "!" / "$" / "{@code &}" / "'" / "(" / ")" / "*" / "+" / "," / ";" / "=" */ public static final PercentCodec SUB_DELIMS = PercentCodec.of("!$&'()*+,;="); diff --git a/hutool-core/src/main/java/cn/hutool/core/util/ZipUtil.java b/hutool-core/src/main/java/cn/hutool/core/util/ZipUtil.java index a813242bf..37e77b5d5 100644 --- a/hutool-core/src/main/java/cn/hutool/core/util/ZipUtil.java +++ b/hutool-core/src/main/java/cn/hutool/core/util/ZipUtil.java @@ -91,9 +91,10 @@ public class ZipUtil { * @param zipPath zip文件的Path * @param appendFilePath 待添加文件Path(可以是文件夹) * @param options 拷贝选项，可选是否覆盖等 + * @throws IORuntimeException IO异常 * @since 5.7.15 */ - public static void append(Path zipPath, Path appendFilePath, CopyOption... options) throws IOException { + public static void append(Path zipPath, Path appendFilePath, CopyOption... options) throws IORuntimeException { try (FileSystem zipFileSystem = FileSystemUtil.createZip(zipPath.toString())) { if (Files.isDirectory(appendFilePath)) { Path source = appendFilePath.getParent(); @@ -107,6 +108,8 @@ public class ZipUtil { } } catch (FileAlreadyExistsException ignored) { // 不覆盖情况下，文件已存在, 跳过 + } catch (IOException e){ + throw new IORuntimeException(e); } }