diff --git a/hutool-core/src/main/java/cn/hutool/core/io/resource/StringResource.java b/hutool-core/src/main/java/cn/hutool/core/io/resource/StringResource.java index 5b4e954a6..540056fa4 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/resource/StringResource.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/resource/StringResource.java @@ -6,7 +6,7 @@ import java.nio.charset.Charset; /** * 字符串资源，字符串做为资源 - * + * * @author looly * @since 4.1.0 * @see CharSequenceResource diff --git a/hutool-core/src/main/java/cn/hutool/core/io/resource/UrlResource.java b/hutool-core/src/main/java/cn/hutool/core/io/resource/UrlResource.java index 6c5f69be9..0a7800611 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/resource/UrlResource.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/resource/UrlResource.java @@ -16,10 +16,10 @@ import java.net.URL; */ public class UrlResource implements Resource, Serializable{ private static final long serialVersionUID = 1L; - + protected URL url; protected String name; - + //-------------------------------------------------------------------------------------- Constructor start /** * 构造 @@ -28,7 +28,7 @@ public class UrlResource implements Resource, Serializable{ public UrlResource(URL url) { this(url, null); } - + /** * 构造 * @param url URL，允许为空 @@ -38,7 +38,7 @@ public class UrlResource implements Resource, Serializable{ this.url = url; this.name = ObjectUtil.defaultIfNull(name, (null != url) ? FileUtil.getName(url.getPath()) : null); } - + /** * 构造 * @param file 文件路径 @@ -49,17 +49,17 @@ public class UrlResource implements Resource, Serializable{ this.url = URLUtil.getURL(file); } //-------------------------------------------------------------------------------------- Constructor end - + @Override public String getName() { return this.name; } - + @Override public URL getUrl(){ return this.url; } - + @Override public InputStream getStream() throws NoResourceException{ if(null == this.url){ @@ -67,7 +67,7 @@ public class UrlResource implements Resource, Serializable{ } return URLUtil.getStream(url); } - + /** * 获得File * @return {@link File} @@ -75,7 +75,7 @@ public class UrlResource implements Resource, Serializable{ public File getFile(){ return FileUtil.file(this.url); } - + /** * 返回路径 * @return 返回URL路径 diff --git a/hutool-core/src/main/java/cn/hutool/core/io/resource/WebAppResource.java b/hutool-core/src/main/java/cn/hutool/core/io/resource/WebAppResource.java index 927ec5407..eacae8a62 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/resource/WebAppResource.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/resource/WebAppResource.java @@ -6,7 +6,7 @@ import cn.hutool.core.io.FileUtil; /** * Web root资源访问对象 - * + * * @author looly * @since 4.1.11 */ @@ -15,7 +15,7 @@ public class WebAppResource extends FileResource { /** * 构造 - * + * * @param path 相对于Web root的路径 */ public WebAppResource(String path) { diff --git a/hutool-core/src/main/java/cn/hutool/core/io/resource/package-info.java b/hutool-core/src/main/java/cn/hutool/core/io/resource/package-info.java index 4f50b3a7a..cd01639d6 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/resource/package-info.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/resource/package-info.java @@ -1,6 +1,6 @@ /** * 针对ClassPath和文件中资源读取的封装，主要入口为工具类ResourceUtil - * + * * @author looly * */ diff --git a/hutool-core/src/main/java/cn/hutool/core/io/unit/package-info.java b/hutool-core/src/main/java/cn/hutool/core/io/unit/package-info.java index 7a9f0768e..c5f6693f8 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/unit/package-info.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/unit/package-info.java @@ -1,6 +1,6 @@ /** * 数据单位相关封装，包括DataUnit数据单位和DataSize数据大小 - * + * * @author looly * @since 5.3.10 */ diff --git a/hutool-core/src/main/java/cn/hutool/core/io/watch/SimpleWatcher.java b/hutool-core/src/main/java/cn/hutool/core/io/watch/SimpleWatcher.java index 61eae3bc2..3a1b614e6 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/watch/SimpleWatcher.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/watch/SimpleWatcher.java @@ -9,5 +9,5 @@ import cn.hutool.core.io.watch.watchers.IgnoreWatcher; * */ public class SimpleWatcher extends IgnoreWatcher{ - + } diff --git a/hutool-core/src/main/java/cn/hutool/core/io/watch/WatchUtil.java b/hutool-core/src/main/java/cn/hutool/core/io/watch/WatchUtil.java index c93fc22ef..bddcf8b0a 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/watch/WatchUtil.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/watch/WatchUtil.java @@ -12,14 +12,14 @@ import cn.hutool.core.util.URLUtil; /** * 监听工具类
* 主要负责文件监听器的快捷创建 - * + * * @author Looly * @since 3.1.0 */ public class WatchUtil { /** * 创建并初始化监听 - * + * * @param url URL * @param events 监听的事件列表 * @return 监听对象 @@ -30,7 +30,7 @@ public class WatchUtil { /** * 创建并初始化监听 - * + * * @param url URL * @param events 监听的事件列表 * @param maxDepth 当监听目录时，监听目录的最大深度，当设置值为1（或小于1）时，表示不递归监听子目录 @@ -42,7 +42,7 @@ public class WatchUtil { /** * 创建并初始化监听 - * + * * @param uri URI * @param events 监听的事件列表 * @return 监听对象 @@ -53,7 +53,7 @@ public class WatchUtil { /** * 创建并初始化监听 - * + * * @param uri URI * @param events 监听的事件列表 * @param maxDepth 当监听目录时，监听目录的最大深度，当设置值为1（或小于1）时，表示不递归监听子目录 @@ -65,7 +65,7 @@ public class WatchUtil { /** * 创建并初始化监听 - * + * * @param file 文件 * @param events 监听的事件列表 * @return 监听对象 @@ -76,7 +76,7 @@ public class WatchUtil { /** * 创建并初始化监听 - * + * * @param file 文件 * @param events 监听的事件列表 * @param maxDepth 当监听目录时，监听目录的最大深度，当设置值为1（或小于1）时，表示不递归监听子目录 @@ -88,7 +88,7 @@ public class WatchUtil { /** * 创建并初始化监听 - * + * * @param path 路径 * @param events 监听的事件列表 * @return 监听对象 @@ -99,7 +99,7 @@ public class WatchUtil { /** * 创建并初始化监听 - * + * * @param path 路径 * @param events 监听的事件列表 * @param maxDepth 当监听目录时，监听目录的最大深度，当设置值为1（或小于1）时，表示不递归监听子目录 @@ -111,7 +111,7 @@ public class WatchUtil { /** * 创建并初始化监听 - * + * * @param path 路径 * @param events 监听事件列表 * @return 监听对象 @@ -122,7 +122,7 @@ public class WatchUtil { /** * 创建并初始化监听 - * + * * @param path 路径 * @param events 监听事件列表 * @param maxDepth 当监听目录时，监听目录的最大深度，当设置值为1（或小于1）时，表示不递归监听子目录 @@ -135,7 +135,7 @@ public class WatchUtil { // ---------------------------------------------------------------------------------------------------------- createAll /** * 创建并初始化监听，监听所有事件 - * + * * @param url URL * @param watcher {@link Watcher} * @return {@link WatchMonitor} @@ -143,10 +143,10 @@ public class WatchUtil { public static WatchMonitor createAll(URL url, Watcher watcher) { return createAll(url, 0, watcher); } - + /** * 创建并初始化监听，监听所有事件 - * + * * @param url URL * @param maxDepth 当监听目录时，监听目录的最大深度，当设置值为1（或小于1）时，表示不递归监听子目录 * @param watcher {@link Watcher} @@ -155,10 +155,10 @@ public class WatchUtil { public static WatchMonitor createAll(URL url, int maxDepth, Watcher watcher) { return createAll(URLUtil.toURI(url), maxDepth, watcher); } - + /** * 创建并初始化监听，监听所有事件 - * + * * @param uri URI * @param watcher {@link Watcher} * @return {@link WatchMonitor} @@ -166,10 +166,10 @@ public class WatchUtil { public static WatchMonitor createAll(URI uri, Watcher watcher) { return createAll(uri, 0, watcher); } - + /** * 创建并初始化监听，监听所有事件 - * + * * @param uri URI * @param maxDepth 当监听目录时，监听目录的最大深度，当设置值为1（或小于1）时，表示不递归监听子目录 * @param watcher {@link Watcher} @@ -181,7 +181,7 @@ public class WatchUtil { /** * 创建并初始化监听，监听所有事件 - * + * * @param file 被监听文件 * @param watcher {@link Watcher} * @return {@link WatchMonitor} @@ -189,10 +189,10 @@ public class WatchUtil { public static WatchMonitor createAll(File file, Watcher watcher) { return createAll(file, 0, watcher); } - + /** * 创建并初始化监听，监听所有事件 - * + * * @param file 被监听文件 * @param maxDepth 当监听目录时，监听目录的最大深度，当设置值为1（或小于1）时，表示不递归监听子目录 * @param watcher {@link Watcher} @@ -204,7 +204,7 @@ public class WatchUtil { /** * 创建并初始化监听，监听所有事件 - * + * * @param path 路径 * @param watcher {@link Watcher} * @return {@link WatchMonitor} @@ -212,10 +212,10 @@ public class WatchUtil { public static WatchMonitor createAll(String path, Watcher watcher) { return createAll(path, 0, watcher); } - + /** * 创建并初始化监听，监听所有事件 - * + * * @param path 路径 * @param maxDepth 当监听目录时，监听目录的最大深度，当设置值为1（或小于1）时，表示不递归监听子目录 * @param watcher {@link Watcher} @@ -227,7 +227,7 @@ public class WatchUtil { /** * 创建并初始化监听，监听所有事件 - * + * * @param path 路径 * @param watcher {@link Watcher} * @return {@link WatchMonitor} @@ -235,10 +235,10 @@ public class WatchUtil { public static WatchMonitor createAll(Path path, Watcher watcher) { return createAll(path, 0, watcher); } - + /** * 创建并初始化监听，监听所有事件 - * + * * @param path 路径 * @param maxDepth 当监听目录时，监听目录的最大深度，当设置值为1（或小于1）时，表示不递归监听子目录 * @param watcher {@link Watcher} @@ -249,11 +249,11 @@ public class WatchUtil { watchMonitor.setWatcher(watcher); return watchMonitor; } - + // ---------------------------------------------------------------------------------------------------------- createModify /** * 创建并初始化监听，监听修改事件 - * + * * @param url URL * @param watcher {@link Watcher} * @return {@link WatchMonitor} @@ -262,10 +262,10 @@ public class WatchUtil { public static WatchMonitor createModify(URL url, Watcher watcher) { return createModify(url, 0, watcher); } - + /** * 创建并初始化监听，监听修改事件 - * + * * @param url URL * @param maxDepth 当监听目录时，监听目录的最大深度，当设置值为1（或小于1）时，表示不递归监听子目录 * @param watcher {@link Watcher} @@ -275,10 +275,10 @@ public class WatchUtil { public static WatchMonitor createModify(URL url, int maxDepth, Watcher watcher) { return createModify(URLUtil.toURI(url), maxDepth, watcher); } - + /** * 创建并初始化监听，监听修改事件 - * + * * @param uri URI * @param watcher {@link Watcher} * @return {@link WatchMonitor} @@ -287,10 +287,10 @@ public class WatchUtil { public static WatchMonitor createModify(URI uri, Watcher watcher) { return createModify(uri, 0, watcher); } - + /** * 创建并初始化监听，监听修改事件 - * + * * @param uri URI * @param maxDepth 当监听目录时，监听目录的最大深度，当设置值为1（或小于1）时，表示不递归监听子目录 * @param watcher {@link Watcher} @@ -300,10 +300,10 @@ public class WatchUtil { public static WatchMonitor createModify(URI uri, int maxDepth, Watcher watcher) { return createModify(Paths.get(uri), maxDepth, watcher); } - + /** * 创建并初始化监听，监听修改事件 - * + * * @param file 被监听文件 * @param watcher {@link Watcher} * @return {@link WatchMonitor} @@ -312,10 +312,10 @@ public class WatchUtil { public static WatchMonitor createModify(File file, Watcher watcher) { return createModify(file, 0, watcher); } - + /** * 创建并初始化监听，监听修改事件 - * + * * @param file 被监听文件 * @param maxDepth 当监听目录时，监听目录的最大深度，当设置值为1（或小于1）时，表示不递归监听子目录 * @param watcher {@link Watcher} @@ -325,10 +325,10 @@ public class WatchUtil { public static WatchMonitor createModify(File file, int maxDepth, Watcher watcher) { return createModify(file.toPath(), 0, watcher); } - + /** * 创建并初始化监听，监听修改事件 - * + * * @param path 路径 * @param watcher {@link Watcher} * @return {@link WatchMonitor} @@ -337,10 +337,10 @@ public class WatchUtil { public static WatchMonitor createModify(String path, Watcher watcher) { return createModify(path, 0, watcher); } - + /** * 创建并初始化监听，监听修改事件 - * + * * @param path 路径 * @param maxDepth 当监听目录时，监听目录的最大深度，当设置值为1（或小于1）时，表示不递归监听子目录 * @param watcher {@link Watcher} @@ -350,10 +350,10 @@ public class WatchUtil { public static WatchMonitor createModify(String path, int maxDepth, Watcher watcher) { return createModify(Paths.get(path), maxDepth, watcher); } - + /** * 创建并初始化监听，监听修改事件 - * + * * @param path 路径 * @param watcher {@link Watcher} * @return {@link WatchMonitor} @@ -362,10 +362,10 @@ public class WatchUtil { public static WatchMonitor createModify(Path path, Watcher watcher) { return createModify(path, 0, watcher); } - + /** * 创建并初始化监听，监听修改事件 - * + * * @param path 路径 * @param maxDepth 当监听目录时，监听目录的最大深度，当设置值为1（或小于1）时，表示不递归监听子目录 * @param watcher {@link Watcher} diff --git a/hutool-core/src/main/java/cn/hutool/core/io/watch/package-info.java b/hutool-core/src/main/java/cn/hutool/core/io/watch/package-info.java index 3c3f57105..f4763224e 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/watch/package-info.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/watch/package-info.java @@ -1,6 +1,6 @@ /** * 基于JDK7+ WatchService的文件和目录监听封装，支持多级目录 - * + * * @author looly * */ diff --git a/hutool-core/src/main/java/cn/hutool/core/io/watch/watchers/DelayWatcher.java b/hutool-core/src/main/java/cn/hutool/core/io/watch/watchers/DelayWatcher.java index 64d3143fc..4d6ee2557 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/watch/watchers/DelayWatcher.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/watch/watchers/DelayWatcher.java @@ -17,19 +17,19 @@ import java.util.Set; * 在监听目录或文件时，如果这个文件有修改操作，会多次触发modify方法。
* 此类通过维护一个Set将短时间内相同文件多次modify的事件合并处理触发，从而避免以上问题。
* 注意：延迟只针对modify事件，其它事件无效 - * + * * @author Looly * @since 3.1.0 */ public class DelayWatcher implements Watcher { - + /** Path集合。此集合用于去重在指定delay内多次触发的文件Path */ private final Set eventSet = new ConcurrentHashSet<>(); /** 实际处理 */ private final Watcher watcher; /** 延迟，单位毫秒 */ private final long delay; - + //---------------------------------------------------------------------------------------------------------- Constructor start /** * 构造 @@ -45,7 +45,7 @@ public class DelayWatcher implements Watcher { this.delay = delay; } //---------------------------------------------------------------------------------------------------------- Constructor end - + @Override public void onModify(WatchEvent event, Path currentPath) { if(this.delay < 1) { @@ -54,22 +54,22 @@ public class DelayWatcher implements Watcher { onDelayModify(event, currentPath); } } - + @Override public void onCreate(WatchEvent event, Path currentPath) { watcher.onCreate(event, currentPath); } - + @Override public void onDelete(WatchEvent event, Path currentPath) { watcher.onDelete(event, currentPath); } - + @Override public void onOverflow(WatchEvent event, Path currentPath) { watcher.onOverflow(event, currentPath); } - + //---------------------------------------------------------------------------------------------------------- Private method start /** * 触发延迟修改 @@ -82,15 +82,15 @@ public class DelayWatcher implements Watcher { //此事件已经被触发过，后续事件忽略，等待统一处理。 return; } - + //事件第一次触发，此时标记事件，并启动处理线程延迟处理，处理结束后会删除标记 eventSet.add(eventPath); startHandleModifyThread(event, currentPath); } - + /** * 开启处理线程 - * + * * @param event 事件 * @param currentPath 事件发生的当前Path路径 */ diff --git a/hutool-core/src/main/java/cn/hutool/core/io/watch/watchers/IgnoreWatcher.java b/hutool-core/src/main/java/cn/hutool/core/io/watch/watchers/IgnoreWatcher.java index 2bad47d09..3beed7321 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/watch/watchers/IgnoreWatcher.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/watch/watchers/IgnoreWatcher.java @@ -8,7 +8,7 @@ import cn.hutool.core.io.watch.Watcher; /** * 跳过所有事件处理Watcher
* 用户继承此类后实现需要监听的方法 - * + * * @author Looly * @since 3.1.0 */ diff --git a/hutool-core/src/main/java/cn/hutool/core/io/watch/watchers/WatcherChain.java b/hutool-core/src/main/java/cn/hutool/core/io/watch/watchers/WatcherChain.java index 128574a87..18ba2bea7 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/watch/watchers/WatcherChain.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/watch/watchers/WatcherChain.java @@ -12,7 +12,7 @@ import java.util.List; /** * 观察者链
* 用于加入多个观察者 - * + * * @author Looly * @since 3.1.0 */ @@ -20,7 +20,7 @@ public class WatcherChain implements Watcher, Chain{ /** 观察者列表 */ final private List chain; - + /** * 创建观察者链{@link WatcherChain} * @param watchers 观察者列表 @@ -29,7 +29,7 @@ public class WatcherChain implements Watcher, Chain{ public static WatcherChain create(Watcher... watchers) { return new WatcherChain(watchers); } - + /** * 构造 * @param watchers 观察者列表 @@ -37,7 +37,7 @@ public class WatcherChain implements Watcher, Chain{ public WatcherChain(Watcher... watchers) { chain = CollUtil.newArrayList(watchers); } - + @Override public void onCreate(WatchEvent event, Path currentPath) { for (Watcher watcher : chain) { diff --git a/hutool-core/src/main/java/cn/hutool/core/io/watch/watchers/package-info.java b/hutool-core/src/main/java/cn/hutool/core/io/watch/watchers/package-info.java index 1562c9aed..db4a52482 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/watch/watchers/package-info.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/watch/watchers/package-info.java @@ -1,6 +1,6 @@ /** * 文件监听中的观察者实现类，包括延迟处理、处理链等 - * + * * @author looly * */ diff --git a/hutool-core/src/main/java/cn/hutool/core/lang/ConsistentHash.java b/hutool-core/src/main/java/cn/hutool/core/lang/ConsistentHash.java index 84be21410..d8e50fb65 100644 --- a/hutool-core/src/main/java/cn/hutool/core/lang/ConsistentHash.java +++ b/hutool-core/src/main/java/cn/hutool/core/lang/ConsistentHash.java @@ -18,14 +18,14 @@ import java.util.TreeMap; */ public class ConsistentHash implements Serializable{ private static final long serialVersionUID = 1L; - + /** Hash计算对象，用于自定义hash算法 */ Hash32 hashFunc; /** 复制的节点个数 */ private final int numberOfReplicas; /** 一致性Hash环 */ private final SortedMap circle = new TreeMap<>(); - + /** * 构造，使用Java默认的Hash算法 * @param numberOfReplicas 复制的节点个数，增加每个节点的复制节点有利于负载均衡 diff --git a/hutool-core/src/main/java/cn/hutool/core/lang/Holder.java b/hutool-core/src/main/java/cn/hutool/core/lang/Holder.java index 481882858..446bb69cc 100644 --- a/hutool-core/src/main/java/cn/hutool/core/lang/Holder.java +++ b/hutool-core/src/main/java/cn/hutool/core/lang/Holder.java @@ -13,7 +13,7 @@ public final class Holder extends MutableObj{ /** * 新建Holder类，持有指定值，当值为空时抛出空指针异常 - * + * * @param 被持有的对象类型 * @param value 值，不能为空 * @return Holder @@ -24,14 +24,14 @@ public final class Holder extends MutableObj{ } return new Holder<>(value); } - + //--------------------------------------------------------------------------- Constructor start /** * 构造 */ public Holder() { } - + /** * 构造 * @param value 被包装的对象 diff --git a/hutool-core/src/main/java/cn/hutool/core/lang/ObjectId.java b/hutool-core/src/main/java/cn/hutool/core/lang/ObjectId.java index 45957ab09..8b4740296 100644 --- a/hutool-core/src/main/java/cn/hutool/core/lang/ObjectId.java +++ b/hutool-core/src/main/java/cn/hutool/core/lang/ObjectId.java @@ -14,16 +14,16 @@ import cn.hutool.core.util.StrUtil; /** * MongoDB ID生成策略实现
* ObjectId由以下几部分组成： - * + * * 
  * 1. Time 时间戳。
  * 2. Machine 所在主机的唯一标识符，一般是机器主机名的散列值。
  * 3. PID 进程ID。确保同一机器中不冲突
  * 4. INC 自增计数器。确保同一秒内产生objectId的唯一性。
  *
- * + * * 参考：http://blog.csdn.net/qxc1281/article/details/54021882 - * + * * @author looly * @since 4.0.0 * @@ -37,7 +37,7 @@ public class ObjectId { /** * 给定的字符串是否为有效的ObjectId - * + * * @param s 字符串 * @return 是否为有效的ObjectId */ @@ -70,7 +70,7 @@ public class ObjectId { /** * 获取一个objectId的bytes表现形式 - * + * * @return objectId * @since 4.1.15 */ @@ -85,7 +85,7 @@ public class ObjectId { /** * 获取一个objectId用下划线分割 - * + * * @return objectId */ public static String next() { @@ -94,7 +94,7 @@ public class ObjectId { /** * 获取一个objectId - * + * * @param withHyphen 是否包含分隔符 * @return objectId */ @@ -119,7 +119,7 @@ public class ObjectId { // ----------------------------------------------------------------------------------------- Private method start /** * 获取机器码片段 - * + * * @return 机器码片段 */ private static int getMachinePiece() { @@ -146,7 +146,7 @@ public class ObjectId { /** * 获取进程码片段 - * + * * @return 进程码片段 */ private static int getProcessPiece() { diff --git a/hutool-core/src/main/java/cn/hutool/core/lang/ParameterizedTypeImpl.java b/hutool-core/src/main/java/cn/hutool/core/lang/ParameterizedTypeImpl.java index 1075ce5dd..f702ed5b7 100644 --- a/hutool-core/src/main/java/cn/hutool/core/lang/ParameterizedTypeImpl.java +++ b/hutool-core/src/main/java/cn/hutool/core/lang/ParameterizedTypeImpl.java @@ -9,20 +9,20 @@ import cn.hutool.core.util.StrUtil; /** * {@link ParameterizedType} 接口实现，用于重新定义泛型类型 - * + * * @author looly * @since 4.5.7 */ public class ParameterizedTypeImpl implements ParameterizedType, Serializable { private static final long serialVersionUID = 1L; - + private final Type[] actualTypeArguments; private final Type ownerType; private final Type rawType; /** * 构造 - * + * * @param actualTypeArguments 实际的泛型参数类型 * @param ownerType 拥有者类型 * @param rawType 原始类型 @@ -71,7 +71,7 @@ public class ParameterizedTypeImpl implements ParameterizedType, Serializable { /** * 追加 {@code types} 到 @{code buf}，使用 {@code sep} 分隔 - * + * * @param buf 目标 * @param sep 分隔符 * @param types 加入的类型 @@ -86,14 +86,14 @@ public class ParameterizedTypeImpl implements ParameterizedType, Serializable { } else { buf.append(sep); } - + String typeStr; if(type instanceof Class) { typeStr = ((Class)type).getName(); }else { typeStr = StrUtil.toString(type); } - + buf.append(typeStr); } } diff --git a/hutool-core/src/main/java/cn/hutool/core/lang/Range.java b/hutool-core/src/main/java/cn/hutool/core/lang/Range.java index b70bbfea3..f24e309f4 100644 --- a/hutool-core/src/main/java/cn/hutool/core/lang/Range.java +++ b/hutool-core/src/main/java/cn/hutool/core/lang/Range.java @@ -12,11 +12,11 @@ import java.util.concurrent.locks.ReentrantReadWriteLock; /** * 范围生成器。根据给定的初始值、结束值和步进生成一个步进列表生成器
* 由于用户自行实现{@link Steper}来定义步进，因此Range本身无法判定边界（是否达到end），需在step实现边界判定逻辑。 - * + * *

* 此类使用{@link ReentrantReadWriteLock}保证线程安全 *

- * + * * @author Looly * * @param 生成范围对象的类型 @@ -45,7 +45,7 @@ public class Range implements Iterable, Iterator, Serializable { /** * 构造 - * + * * @param start 起始对象 * @param steper 步进 */ @@ -55,7 +55,7 @@ public class Range implements Iterable, Iterator, Serializable { /** * 构造 - * + * * @param start 起始对象（包含） * @param end 结束对象（包含） * @param steper 步进 @@ -66,7 +66,7 @@ public class Range implements Iterable, Iterator, Serializable { /** * 构造 - * + * * @param start 起始对象 * @param end 结束对象 * @param steper 步进 @@ -86,7 +86,7 @@ public class Range implements Iterable, Iterator, Serializable { /** * 禁用锁，调用此方法后不在 使用锁保护 - * + * * @return this * @since 4.3.1 */ @@ -143,7 +143,7 @@ public class Range implements Iterable, Iterator, Serializable { /** * 不抛异常的获取下一步进的元素，如果获取失败返回{@code null} - * + * * @param base 上一个元素 * @return 下一步进 */ @@ -169,7 +169,7 @@ public class Range implements Iterable, Iterator, Serializable { /** * 重置{@link Range} - * + * * @return this */ public Range reset() { @@ -186,13 +186,13 @@ public class Range implements Iterable, Iterator, Serializable { /** * 步进接口，此接口用于实现如何对一个对象按照指定步进增加步进
* 步进接口可以定义以下逻辑： - * + * * 
 	 * 1、步进规则，即对象如何做步进
 	 * 2、步进大小，通过实现此接口，在实现类中定义一个对象属性，可灵活定义步进大小
 	 * 3、限制range个数，通过实现此接口，在实现类中定义一个对象属性，可灵活定义limit，限制range个数
 	 *
- * + * * @author Looly * * @param 需要增加步进的对象 @@ -202,7 +202,7 @@ public class Range implements Iterable, Iterator, Serializable { * 增加步进
* 增加步进后的返回值如果为{@code null}则表示步进结束
* 用户需根据end参数自行定义边界，当达到边界时返回null表示结束，否则Range中边界对象无效，会导致无限循环 - * + * * @param current 上一次增加步进后的基础对象 * @param end 结束对象 * @param index 当前索引（步进到第几个元素），从0开始计数 diff --git a/hutool-core/src/main/java/cn/hutool/core/lang/Replacer.java b/hutool-core/src/main/java/cn/hutool/core/lang/Replacer.java index 8e29bc4cb..03af67f39 100644 --- a/hutool-core/src/main/java/cn/hutool/core/lang/Replacer.java +++ b/hutool-core/src/main/java/cn/hutool/core/lang/Replacer.java @@ -3,7 +3,7 @@ package cn.hutool.core.lang; /** * 替换器
* 通过实现此接口完成指定类型对象的替换操作，替换后的目标类型依旧为指定类型 - * + * * @author looly * * @param 被替换操作的类型 @@ -11,10 +11,10 @@ package cn.hutool.core.lang; */ @FunctionalInterface public interface Replacer { - + /** * 替换指定类型为目标类型 - * + * * @param t 被替换的对象 * @return 替代后的对象 */ diff --git a/hutool-core/src/main/java/cn/hutool/core/lang/TypeReference.java b/hutool-core/src/main/java/cn/hutool/core/lang/TypeReference.java index df3910b2a..ccb9f18b1 100644 --- a/hutool-core/src/main/java/cn/hutool/core/lang/TypeReference.java +++ b/hutool-core/src/main/java/cn/hutool/core/lang/TypeReference.java @@ -7,17 +7,17 @@ import cn.hutool.core.util.TypeUtil; /** * Type类型参考
* 通过构建一个类型参考子类，可以获取其泛型参数中的Type类型。例如： - * + * * 
  * TypeReference<List<String>> list = new TypeReference<List<String>>() {};
  * Type t = tr.getType();
  *
- * + * * 此类无法应用于通配符泛型参数（wildcard parameters），比如：{@code Class} 或者 {@code List? extends CharSequence>} - * + * *

* 此类参考FastJSON的TypeReference实现 - * + * * @author looly * * @param 需要自定义的参考类型 @@ -37,13 +37,13 @@ public abstract class TypeReference implements Type { /** * 获取用户定义的泛型参数 - * + * * @return 泛型参数 */ public Type getType() { return this.type; } - + @Override public String toString() { return this.type.toString(); diff --git a/hutool-core/src/main/java/cn/hutool/core/lang/WeightRandom.java b/hutool-core/src/main/java/cn/hutool/core/lang/WeightRandom.java index 9d4f86601..e6b7b3305 100644 --- a/hutool-core/src/main/java/cn/hutool/core/lang/WeightRandom.java +++ b/hutool-core/src/main/java/cn/hutool/core/lang/WeightRandom.java @@ -19,11 +19,11 @@ import java.util.TreeMap; *

* 总体思路：累加每个元素的权重A(1)-B(3)-C(6)-D(10)，则4个元素的的权重管辖区间分别为[0,1)、[1,3)、[3,6)、[6,10)。
* 然后随机出一个[0,10)之间的随机数。落在哪个区间，则该区间之后的元素即为按权重命中的元素。
- * + * *

* 参考博客：https://www.cnblogs.com/waterystone/p/5708063.html *

- * + * * @param 权重随机获取的对象类型 * @author looly * @since 3.3.0 @@ -55,7 +55,7 @@ public class WeightRandom implements Serializable { /** * 构造 - * + * * @param weightObj 带有权重的对象 */ public WeightRandom(WeightObj weightObj) { @@ -67,7 +67,7 @@ public class WeightRandom implements Serializable { /** * 构造 - * + * * @param weightObjs 带有权重的对象 */ public WeightRandom(Iterable> weightObjs) { @@ -81,7 +81,7 @@ public class WeightRandom implements Serializable { /** * 构造 - * + * * @param weightObjs 带有权重的对象 */ public WeightRandom(WeightObj[] weightObjs) { @@ -94,7 +94,7 @@ public class WeightRandom implements Serializable { /** * 增加对象 - * + * * @param obj 对象 * @param weight 权重 * @return this @@ -105,7 +105,7 @@ public class WeightRandom implements Serializable { /** * 增加对象权重 - * + * * @param weightObj 权重对象 * @return this */ @@ -122,7 +122,7 @@ public class WeightRandom implements Serializable { /** * 清空权重表 - * + * * @return this */ public WeightRandom clear() { @@ -134,7 +134,7 @@ public class WeightRandom implements Serializable { /** * 下一个随机对象 - * + * * @return 随机对象 */ public T next() { @@ -149,7 +149,7 @@ public class WeightRandom implements Serializable { /** * 带有权重的对象包装 - * + * * @author looly * * @param 对象类型 @@ -162,7 +162,7 @@ public class WeightRandom implements Serializable { /** * 构造 - * + * * @param obj 对象 * @param weight 权重 */ @@ -173,7 +173,7 @@ public class WeightRandom implements Serializable { /** * 获取对象 - * + * * @return 对象 */ public T getObj() { @@ -182,7 +182,7 @@ public class WeightRandom implements Serializable { /** * 设置对象 - * + * * @param obj 对象 */ public void setObj(T obj) { @@ -191,7 +191,7 @@ public class WeightRandom implements Serializable { /** * 获取权重 - * + * * @return 权重 */ public double getWeight() { @@ -231,5 +231,5 @@ public class WeightRandom implements Serializable { return Double.doubleToLongBits(weight) == Double.doubleToLongBits(other.weight); } } - + }