From b1e5b8286dd0c1673d85653aabd8ab1152e70d08 Mon Sep 17 00:00:00 2001
From: cal101
* Desktop 类允许 Java 应用程序启动已在本机桌面上注册的关联应用程序,以处理 URI 或文件。
- *
+ *
* @author looly
* @since 4.5.7
*/
@@ -19,7 +19,7 @@ public class DesktopUtil {
/**
* 获得{@link Desktop}
- *
+ *
* @return {@link Desktop}
*/
public static Desktop getDsktop() {
@@ -28,16 +28,16 @@ public class DesktopUtil {
/**
* 使用平台默认浏览器打开指定URL地址
- *
+ *
* @param url URL地址
*/
public static void browse(String url) {
browse(URLUtil.toURI(url));
}
-
+
/**
* 使用平台默认浏览器打开指定URI地址
- *
+ *
* @param uri URI地址
* @since 4.6.3
*/
@@ -52,7 +52,7 @@ public class DesktopUtil {
/**
* 启动关联应用程序来打开文件
- *
+ *
* @param file URL地址
*/
public static void open(File file) {
@@ -66,7 +66,7 @@ public class DesktopUtil {
/**
* 启动关联编辑器应用程序并打开用于编辑的文件
- *
+ *
* @param file 文件
*/
public static void edit(File file) {
@@ -80,7 +80,7 @@ public class DesktopUtil {
/**
* 使用关联应用程序的打印命令, 用本机桌面打印设备来打印文件
- *
+ *
* @param file 文件
*/
public static void print(File file) {
@@ -94,7 +94,7 @@ public class DesktopUtil {
/**
* 使用平台默认浏览器打开指定URL地址
- *
+ *
* @param mailAddress 邮件地址
*/
public static void mail(String mailAddress) {
diff --git a/hutool-core/src/main/java/cn/hutool/core/swing/RobotUtil.java b/hutool-core/src/main/java/cn/hutool/core/swing/RobotUtil.java
index c49f76ccd..6d3c31340 100644
--- a/hutool-core/src/main/java/cn/hutool/core/swing/RobotUtil.java
+++ b/hutool-core/src/main/java/cn/hutool/core/swing/RobotUtil.java
@@ -14,7 +14,7 @@ import cn.hutool.core.swing.clipboard.ClipboardUtil;
/**
* {@link Robot} 封装工具类,提供截屏等工具
- *
+ *
* @author looly
* @since 4.1.14
*/
@@ -34,7 +34,7 @@ public class RobotUtil {
/**
* 设置默认的延迟时间
* 当按键执行完后的等待时间,也可以用ThreadUtil.sleep方法代替
- *
+ *
* @param delayMillis 等待毫秒数
* @since 4.5.7
*/
@@ -44,7 +44,7 @@ public class RobotUtil {
/**
* 模拟鼠标移动
- *
+ *
* @param x 移动到的x坐标
* @param y 移动到的y坐标
* @since 4.5.7
@@ -56,7 +56,7 @@ public class RobotUtil {
/**
* 模拟单击
* 鼠标单击包括鼠标左键的按下和释放
- *
+ *
* @since 4.5.7
*/
public static void click() {
@@ -68,7 +68,7 @@ public class RobotUtil {
/**
* 模拟右键单击
* 鼠标单击包括鼠标右键的按下和释放
- *
+ *
* @since 4.5.7
*/
public static void rightClick() {
@@ -79,7 +79,7 @@ public class RobotUtil {
/**
* 模拟鼠标滚轮滚动
- *
+ *
* @param wheelAmt 滚动数,负数表示向前滚动,正数向后滚动
* @since 4.5.7
*/
@@ -91,7 +91,7 @@ public class RobotUtil {
/**
* 模拟键盘点击
* 包括键盘的按下和释放
- *
+ *
* @param keyCodes 按键码列表,见{@link java.awt.event.KeyEvent}
* @since 4.5.7
*/
@@ -105,7 +105,7 @@ public class RobotUtil {
/**
* 打印输出指定字符串(借助剪贴板)
- *
+ *
* @param str 字符串
*/
public static void keyPressString(String str) {
@@ -116,7 +116,7 @@ public class RobotUtil {
/**
* shift+ 按键
- *
+ *
* @param key 按键
*/
public static void keyPressWithShift(int key) {
@@ -129,7 +129,7 @@ public class RobotUtil {
/**
* ctrl+ 按键
- *
+ *
* @param key 按键
*/
public static void keyPressWithCtrl(int key) {
@@ -142,7 +142,7 @@ public class RobotUtil {
/**
* alt+ 按键
- *
+ *
* @param key 按键
*/
public static void keyPressWithAlt(int key) {
@@ -155,7 +155,7 @@ public class RobotUtil {
/**
* 截取全屏
- *
+ *
* @return 截屏的图片
*/
public static BufferedImage captureScreen() {
@@ -164,7 +164,7 @@ public class RobotUtil {
/**
* 截取全屏到文件
- *
+ *
* @param outFile 写出到的文件
* @return 写出到的文件
*/
@@ -175,7 +175,7 @@ public class RobotUtil {
/**
* 截屏
- *
+ *
* @param screenRect 截屏的矩形区域
* @return 截屏的图片
*/
@@ -185,7 +185,7 @@ public class RobotUtil {
/**
* 截屏
- *
+ *
* @param screenRect 截屏的矩形区域
* @param outFile 写出到的文件
* @return 写出到的文件
diff --git a/hutool-core/src/main/java/cn/hutool/core/swing/ScreenUtil.java b/hutool-core/src/main/java/cn/hutool/core/swing/ScreenUtil.java
index 9f3f087b9..047eabb5f 100644
--- a/hutool-core/src/main/java/cn/hutool/core/swing/ScreenUtil.java
+++ b/hutool-core/src/main/java/cn/hutool/core/swing/ScreenUtil.java
@@ -8,7 +8,7 @@ import java.io.File;
/**
* 屏幕相关(当前显示设置)工具类
- *
+ *
* @author looly
* @since 4.1.14
*/
@@ -17,7 +17,7 @@ public class ScreenUtil {
/**
* 获取屏幕宽度
- *
+ *
* @return 屏幕宽度
*/
public static int getWidth() {
@@ -26,13 +26,13 @@ public class ScreenUtil {
/**
* 获取屏幕高度
- *
+ *
* @return 屏幕高度
*/
public static int getHeight() {
return (int) dimension.getHeight();
}
-
+
/**
* 获取屏幕的矩形
* @return 屏幕的矩形
@@ -40,11 +40,11 @@ public class ScreenUtil {
public static Rectangle getRectangle() {
return new Rectangle(getWidth(), getHeight());
}
-
+
//-------------------------------------------------------------------------------------------- 截屏
/**
* 截取全屏
- *
+ *
* @return 截屏的图片
* @see RobotUtil#captureScreen()
*/
@@ -54,7 +54,7 @@ public class ScreenUtil {
/**
* 截取全屏到文件
- *
+ *
* @param outFile 写出到的文件
* @return 写出到的文件
* @see RobotUtil#captureScreen(File)
@@ -65,7 +65,7 @@ public class ScreenUtil {
/**
* 截屏
- *
+ *
* @param screenRect 截屏的矩形区域
* @return 截屏的图片
* @see RobotUtil#captureScreen(Rectangle)
@@ -76,7 +76,7 @@ public class ScreenUtil {
/**
* 截屏
- *
+ *
* @param screenRect 截屏的矩形区域
* @param outFile 写出到的文件
* @return 写出到的文件
diff --git a/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/ClipboardListener.java b/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/ClipboardListener.java
index e5ebeed21..663b953f2 100644
--- a/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/ClipboardListener.java
+++ b/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/ClipboardListener.java
@@ -6,7 +6,7 @@ import java.awt.datatransfer.Transferable;
/**
* 剪贴板监听事件处理接口
* 用户通过实现此接口,实现监听剪贴板内容变化
- *
+ *
* @author looly
*@since 4.5.6
*/
@@ -14,7 +14,7 @@ public interface ClipboardListener {
/**
* 剪贴板变动触发的事件方法
* 在此事件中对剪贴板设置值无效,如若修改,需返回修改内容
- *
+ *
* @param clipboard 剪贴板对象
* @param contents 内容
* @return 如果对剪贴板内容做修改,则返回修改的内容,{@code null}表示保留原内容
diff --git a/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/ClipboardMonitor.java b/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/ClipboardMonitor.java
index 508441303..040fecfcb 100644
--- a/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/ClipboardMonitor.java
+++ b/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/ClipboardMonitor.java
@@ -12,13 +12,13 @@ import java.util.Set;
/**
* 剪贴板监听
- *
+ *
* @author looly
* @since 4.5.6
*/
public enum ClipboardMonitor implements ClipboardOwner, Runnable, Closeable {
INSTANCE;
-
+
/** 默认重试此时:10 */
public static final int DEFAULT_TRY_COUNT = 10;
/** 默认重试等待:100 */
@@ -45,7 +45,7 @@ public enum ClipboardMonitor implements ClipboardOwner, Runnable, Closeable {
/**
* 构造
- *
+ *
* @param tryCount 尝试获取剪贴板内容的次数
* @param delay 响应延迟,当从第二次开始,延迟一定毫秒数等待剪贴板可以获取,当tryCount小于2时无效
*/
@@ -55,7 +55,7 @@ public enum ClipboardMonitor implements ClipboardOwner, Runnable, Closeable {
/**
* 构造
- *
+ *
* @param tryCount 尝试获取剪贴板内容的次数
* @param delay 响应延迟,当从第二次开始,延迟一定毫秒数等待剪贴板可以获取,当tryCount小于2时无效
* @param clipboard 剪贴板对象
@@ -69,7 +69,7 @@ public enum ClipboardMonitor implements ClipboardOwner, Runnable, Closeable {
/**
* 设置重试次数
- *
+ *
* @param tryCount 重试次数
* @return this
*/
@@ -80,7 +80,7 @@ public enum ClipboardMonitor implements ClipboardOwner, Runnable, Closeable {
/**
* 设置重试等待
- *
+ *
* @param delay 重试等待
* @return this
*/
@@ -91,7 +91,7 @@ public enum ClipboardMonitor implements ClipboardOwner, Runnable, Closeable {
/**
* 设置 监听事件处理
- *
+ *
* @param listener 监听事件处理
* @return this
*/
@@ -102,7 +102,7 @@ public enum ClipboardMonitor implements ClipboardOwner, Runnable, Closeable {
/**
* 去除指定监听
- *
+ *
* @param listener 监听
* @return this
*/
@@ -113,7 +113,7 @@ public enum ClipboardMonitor implements ClipboardOwner, Runnable, Closeable {
/**
* 清空监听
- *
+ *
* @return this
*/
public ClipboardMonitor clearListener() {
@@ -157,7 +157,7 @@ public enum ClipboardMonitor implements ClipboardOwner, Runnable, Closeable {
/**
* 开始监听
- *
+ *
* @param sync 是否阻塞
*/
public void listen(boolean sync) {
@@ -179,7 +179,7 @@ public enum ClipboardMonitor implements ClipboardOwner, Runnable, Closeable {
// ------------------------------------------------------------------------------------------------------------------------- Private method start
/**
* 尝试获取剪贴板内容
- *
+ *
* @param clipboard 剪贴板
* @return 剪贴板内容,{@code null} 表示未获取到
* @throws InterruptedException 线程中断
diff --git a/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/ClipboardUtil.java b/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/ClipboardUtil.java
index e9cb710ad..0618ff451 100644
--- a/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/ClipboardUtil.java
+++ b/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/ClipboardUtil.java
@@ -14,7 +14,7 @@ import cn.hutool.core.exceptions.UtilException;
/**
* 系统剪贴板工具类
- *
+ *
* @author looly
* @since 3.2.0
*/
@@ -22,7 +22,7 @@ public class ClipboardUtil {
/**
* 获取系统剪贴板
- *
+ *
* @return {@link Clipboard}
*/
public static Clipboard getClipboard() {
@@ -31,7 +31,7 @@ public class ClipboardUtil {
/**
* 设置内容到剪贴板
- *
+ *
* @param contents 内容
*/
public static void set(Transferable contents) {
@@ -40,7 +40,7 @@ public class ClipboardUtil {
/**
* 设置内容到剪贴板
- *
+ *
* @param contents 内容
* @param owner 所有者
*/
@@ -50,7 +50,7 @@ public class ClipboardUtil {
/**
* 获取剪贴板内容
- *
+ *
* @param flavor 数据元信息,标识数据类型
* @return 剪贴板内容,类型根据flavor不同而不同
*/
@@ -60,7 +60,7 @@ public class ClipboardUtil {
/**
* 获取剪贴板内容
- *
+ *
* @param content {@link Transferable}
* @param flavor 数据元信息,标识数据类型
* @return 剪贴板内容,类型根据flavor不同而不同
@@ -78,7 +78,7 @@ public class ClipboardUtil {
/**
* 设置字符串文本到剪贴板
- *
+ *
* @param text 字符串文本
*/
public static void setStr(String text) {
@@ -87,7 +87,7 @@ public class ClipboardUtil {
/**
* 从剪贴板获取文本
- *
+ *
* @return 文本
*/
public static String getStr() {
@@ -96,7 +96,7 @@ public class ClipboardUtil {
/**
* 从剪贴板的{@link Transferable}获取文本
- *
+ *
* @param content {@link Transferable}
* @return 文本
* @since 4.5.6
@@ -107,7 +107,7 @@ public class ClipboardUtil {
/**
* 设置图片到剪贴板
- *
+ *
* @param image 图像
*/
public static void setImage(Image image) {
@@ -116,7 +116,7 @@ public class ClipboardUtil {
/**
* 从剪贴板获取图片
- *
+ *
* @return 图片{@link Image}
*/
public static Image getImage() {
@@ -125,7 +125,7 @@ public class ClipboardUtil {
/**
* 从剪贴板的{@link Transferable}获取图片
- *
+ *
* @param content {@link Transferable}
* @return 图片
* @since 4.5.6
@@ -136,7 +136,7 @@ public class ClipboardUtil {
/**
* 监听剪贴板修改事件
- *
+ *
* @param listener 监听处理接口
* @since 4.5.6
* @see ClipboardMonitor#listen(boolean)
@@ -147,7 +147,7 @@ public class ClipboardUtil {
/**
* 监听剪贴板修改事件
- *
+ *
* @param listener 监听处理接口
* @param sync 是否同步阻塞
* @since 4.5.6
@@ -159,7 +159,7 @@ public class ClipboardUtil {
/**
* 监听剪贴板修改事件
- *
+ *
* @param tryCount 尝试获取剪贴板内容的次数
* @param delay 响应延迟,当从第二次开始,延迟一定毫秒数等待剪贴板可以获取
* @param listener 监听处理接口
diff --git a/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/ImageSelection.java b/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/ImageSelection.java
index 30d3a33e7..948d278d7 100644
--- a/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/ImageSelection.java
+++ b/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/ImageSelection.java
@@ -9,18 +9,18 @@ import java.io.Serializable;
/**
* 图片转换器,用于将图片对象转换为剪贴板支持的对象
* 此对象也用于将图像文件和{@link DataFlavor#imageFlavor} 元信息对应
- *
+ *
* @author looly
* @since 4.5.6
*/
public class ImageSelection implements Transferable, Serializable {
private static final long serialVersionUID = 1L;
-
+
private final Image image;
/**
* 构造
- *
+ *
* @param image 图片
*/
public ImageSelection(Image image) {
@@ -29,7 +29,7 @@ public class ImageSelection implements Transferable, Serializable {
/**
* 获取元数据类型信息
- *
+ *
* @return 元数据类型列表
*/
@Override
@@ -39,7 +39,7 @@ public class ImageSelection implements Transferable, Serializable {
/**
* 是否支持指定元数据类型
- *
+ *
* @param flavor 元数据类型
* @return 是否支持
*/
@@ -50,7 +50,7 @@ public class ImageSelection implements Transferable, Serializable {
/**
* 获取图片
- *
+ *
* @param flavor 元数据类型
* @return 转换后的对象
*/
diff --git a/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/StrClipboardListener.java b/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/StrClipboardListener.java
index d427d603d..7af403896 100644
--- a/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/StrClipboardListener.java
+++ b/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/StrClipboardListener.java
@@ -7,7 +7,7 @@ import java.io.Serializable;
/**
* 剪贴板字符串内容监听
- *
+ *
* @author looly
* @since 4.5.7
*/
@@ -25,7 +25,7 @@ public abstract class StrClipboardListener implements ClipboardListener, Seriali
/**
* 剪贴板变动触发的事件方法
* 在此事件中对剪贴板设置值无效,如若修改,需返回修改内容
- *
+ *
* @param clipboard 剪贴板对象
* @param contents 内容
* @return 如果对剪贴板内容做修改,则返回修改的内容,{@code null}表示保留原内容
diff --git a/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/package-info.java b/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/package-info.java
index 0a8333297..b7d5e45f4 100644
--- a/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/package-info.java
+++ b/hutool-core/src/main/java/cn/hutool/core/swing/clipboard/package-info.java
@@ -1,6 +1,6 @@
/**
* 剪贴板相关的工具,包括剪贴板监听等
- *
+ *
* @author looly
*
*/
diff --git a/hutool-core/src/main/java/cn/hutool/core/swing/package-info.java b/hutool-core/src/main/java/cn/hutool/core/swing/package-info.java
index f37a33272..4f6cb42b8 100644
--- a/hutool-core/src/main/java/cn/hutool/core/swing/package-info.java
+++ b/hutool-core/src/main/java/cn/hutool/core/swing/package-info.java
@@ -1,6 +1,6 @@
/**
* Swing和awt相关封装
- *
+ *
* @author looly
*
*/
diff --git a/hutool-core/src/main/java/cn/hutool/core/text/ASCIIStrCache.java b/hutool-core/src/main/java/cn/hutool/core/text/ASCIIStrCache.java
index 07e18bb48..fd2b0df29 100644
--- a/hutool-core/src/main/java/cn/hutool/core/text/ASCIIStrCache.java
+++ b/hutool-core/src/main/java/cn/hutool/core/text/ASCIIStrCache.java
@@ -2,13 +2,13 @@ package cn.hutool.core.text;
/**
* ASCII字符对应的字符串缓存
- *
+ *
* @author looly
* @since 4.0.1
*
*/
public class ASCIIStrCache {
-
+
private static final int ASCII_LENGTH = 128;
private static final String[] CACHE = new String[ASCII_LENGTH];
static {
@@ -20,7 +20,7 @@ public class ASCIIStrCache {
/**
* 字符转为字符串
* 如果为ASCII字符,使用缓存
- *
+ *
* @param c 字符
* @return 字符串
*/
diff --git a/hutool-core/src/main/java/cn/hutool/core/text/Simhash.java b/hutool-core/src/main/java/cn/hutool/core/text/Simhash.java
index c235658b1..d84387af9 100644
--- a/hutool-core/src/main/java/cn/hutool/core/text/Simhash.java
+++ b/hutool-core/src/main/java/cn/hutool/core/text/Simhash.java
@@ -15,7 +15,7 @@ import java.util.concurrent.locks.StampedLock;
* Simhash是一种局部敏感hash,用于海量文本去重。
* 算法实现来自:https://github.com/xlturing/Simhash4J
*
* 局部敏感hash定义:假定两个字符串具有一定的相似性,在hash之后,仍然能保持这种相似性,就称之为局部敏感hash。 *
@@ -31,7 +31,7 @@ public class Simhash { private final int fracBitNum; /** 汉明距离的衡量标准,小于此距离标准表示相似 */ private final int hammingThresh; - + /** 按照分段存储simhash,查找更快速 */ private final List