zhouxy108/hutool
1
0
Fork 0
mirror of https://gitee.com/chinabugotech/hutool.git synced 2025-07-21 15:09:48 +08:00
Code Issues Packages Projects Releases Wiki Activity

fix comment

Browse Source
This commit is contained in:
Looly
2019-10-02 16:05:50 +08:00
parent 3acf9c4e70
commit 522ed4308d
37 changed files with 85 additions and 85 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
hutool-core/src/main/java/cn/hutool/core/codec/Base62Codec.java
View File

@@ -33,7 +33,7 @@ public class Base62Codec implements Serializable{
};
/**
* 反转风格，既将GMP风格中的大小写做转换
* 反转风格，即将GMP风格中的大小写做转换
*/
private static final byte[] INVERTED = { //
'0', '1', '2', '3', '4', '5', '6', '7', //

4
hutool-core/src/main/java/cn/hutool/core/collection/CollUtil.java
View File

@@ -244,7 +244,7 @@ public class CollUtil {
}
/**
* 其中一个集合在另一个集合中是否至少包含一个元素，既是两个集合是否至少有一个共同的元素
* 其中一个集合在另一个集合中是否至少包含一个元素，即是两个集合是否至少有一个共同的元素
*
* @param coll1 集合1
* @param coll2 集合2
@@ -273,7 +273,7 @@ public class CollUtil {
}
/**
* 集合1中是否包含集合2中所有的元素，既集合2是否为集合1的子集
* 集合1中是否包含集合2中所有的元素，即集合2是否为集合1的子集
*
* @param coll1 集合1
* @param coll2 集合2

4
hutool-core/src/main/java/cn/hutool/core/comparator/VersionComparator.java
View File

@@ -10,7 +10,7 @@ import cn.hutool.core.util.StrUtil;
/**
* 版本比较器<br>
* 比较两个版本的大小<br>
* 排序时版本从小到大排序，既比较时小版本在前，大版本在后<br>
* 排序时版本从小到大排序，即比较时小版本在前，大版本在后<br>
* 支持如：1.3.20.8，6.82.20160101，8.5a/8.5c等版本形式<br>
* 参考：https://www.cnblogs.com/shihaiming/p/6286575.html
*
@@ -32,7 +32,7 @@ public class VersionComparator implements Comparator<String>, Serializable {
// -----------------------------------------------------------------------------------------------------
/**
* 比较两个版本<br>
* null版本排在最小：既：
* null版本排在最小：即：
* <pre>
* compare(null, "v1") &lt; 0
* compare("v1", "v1") = 0

2
hutool-core/src/main/java/cn/hutool/core/date/DateModifier.java
View File

@@ -33,7 +33,7 @@ public class DateModifier {
* 修改日期
*
* @param calendar {@link Calendar}
* @param dateField 日期字段，既保留到哪个日期字段
* @param dateField 日期字段，即保留到哪个日期字段
* @param modifyType 修改类型，包括舍去、四舍五入、进一等
* @return 修改后的{@link Calendar}
*/

8
hutool-core/src/main/java/cn/hutool/core/date/DateUtil.java
View File

@@ -908,7 +908,7 @@ public class DateUtil {
}
/**
* 获取秒级别的开始时间，既忽略毫秒部分
* 获取秒级别的开始时间，即忽略毫秒部分
*
* @param date 日期
* @return {@link DateTime}
@@ -919,7 +919,7 @@ public class DateUtil {
}
/**
* 获取秒级别的结束时间，既毫秒设置为999
* 获取秒级别的结束时间，即毫秒设置为999
*
* @param date 日期
* @return {@link DateTime}
@@ -930,7 +930,7 @@ public class DateUtil {
}
/**
* 获取秒级别的开始时间，既忽略毫秒部分
* 获取秒级别的开始时间，即忽略毫秒部分
*
* @param calendar 日期 {@link Calendar}
* @return {@link Calendar}
@@ -941,7 +941,7 @@ public class DateUtil {
}
/**
* 获取秒级别的结束时间，既毫秒设置为999
* 获取秒级别的结束时间，即毫秒设置为999
*
* @param calendar 日期 {@link Calendar}
* @return {@link Calendar}

2
hutool-core/src/main/java/cn/hutool/core/io/FileUtil.java
View File

@@ -1582,7 +1582,7 @@ public class FileUtil {
String element;
for (int i = pathList.size() - 1; i >= 0; i--) {
element = pathList.get(i);
// 只处理非.的目录，既只处理非当前目录
// 只处理非.的目录，即只处理非当前目录
if (false == StrUtil.DOT.equals(element)) {
if (StrUtil.DOUBLE_DOT.equals(element)) {
tops++;

2
hutool-core/src/main/java/cn/hutool/core/io/NullOutputStream.java
View File

@@ -4,7 +4,7 @@ import java.io.IOException;
import java.io.OutputStream;
/**
* 此OutputStream写出数据到<b>/dev/null</b>，既忽略所有数据<br>
* 此OutputStream写出数据到<b>/dev/null</b>，即忽略所有数据<br>
* 来自 Apache Commons io
*
* @author looly

4
hutool-core/src/main/java/cn/hutool/core/lang/Assert.java
View File

@@ -226,7 +226,7 @@ public class Assert {
}
/**
* 断言给定字符串是否不被另一个字符串包含（既是否为子串）
* 断言给定字符串是否不被另一个字符串包含（即是否为子串）
*
* <pre class="code">
* Assert.doesNotContain(name, "rod", "Name must not contain 'rod'");
@@ -247,7 +247,7 @@ public class Assert {
}
/**
* 断言给定字符串是否不被另一个字符串包含（既是否为子串）
* 断言给定字符串是否不被另一个字符串包含（即是否为子串）
*
* <pre class="code">
* Assert.doesNotContain(name, "rod", "Name must not contain 'rod'");

2
hutool-core/src/main/java/cn/hutool/core/lang/Range.java
View File

@@ -187,7 +187,7 @@ public class Range<T> implements Iterable<T>, Iterator<T>, Serializable {
* 步进接口可以定义以下逻辑：
*
* <pre>
* 1、步进规则，既对象如何做步进
* 1、步进规则，即对象如何做步进
* 2、步进大小，通过实现此接口，在实现类中定义一个对象属性，可灵活定义步进大小
* 3、限制range个数，通过实现此接口，在实现类中定义一个对象属性，可灵活定义limit，限制range个数
* </pre>

2
hutool-core/src/main/java/cn/hutool/core/text/escape/InternalEscapeUtil.java
View File

@@ -8,7 +8,7 @@ package cn.hutool.core.text.escape;
class InternalEscapeUtil {
/**
* 将数组中的0和1位置的值互换，既键值转换
* 将数组中的0和1位置的值互换，即键值转换
*
* @param array String[][] 被转换的数组
* @return String[][] 转换后的数组

10
hutool-core/src/main/java/cn/hutool/core/thread/ExecutorBuilder.java
View File

@@ -25,13 +25,13 @@ public class ExecutorBuilder implements Builder<ThreadPoolExecutor> {
private int corePoolSize;
/** 最大池大小（允许同时执行的最大线程数） */
private int maxPoolSize = Integer.MAX_VALUE;
/** 线程存活时间，既当池中线程多于初始大小时，多出的线程保留的时长 */
/** 线程存活时间，即当池中线程多于初始大小时，多出的线程保留的时长 */
private long keepAliveTime = TimeUnit.SECONDS.toNanos(60);
/** 队列，用于存在未执行的线程 */
private BlockingQueue<Runnable> workQueue;
/** 线程工厂，用于自定义线程创建 */
private ThreadFactory threadFactory;
/** 当线程阻塞（block）时的异常处理器，所谓线程阻塞既线程池和等待队列已满，无法处理线程时采取的策略 */
/** 当线程阻塞（block）时的异常处理器，所谓线程阻塞即线程池和等待队列已满，无法处理线程时采取的策略 */
private RejectedExecutionHandler handler;
/** 线程执行超时后是否回收线程 */
private Boolean allowCoreThreadTimeOut;
@@ -59,7 +59,7 @@ public class ExecutorBuilder implements Builder<ThreadPoolExecutor> {
}
/**
* 设置线程存活时间，既当池中线程多于初始大小时，多出的线程保留的时长
* 设置线程存活时间，即当池中线程多于初始大小时，多出的线程保留的时长
*
* @param keepAliveTime 线程存活时间
* @param unit 单位
@@ -70,7 +70,7 @@ public class ExecutorBuilder implements Builder<ThreadPoolExecutor> {
}
/**
* 设置线程存活时间，既当池中线程多于初始大小时，多出的线程保留的时长，单位纳秒
* 设置线程存活时间，即当池中线程多于初始大小时，多出的线程保留的时长，单位纳秒
*
* @param keepAliveTime 线程存活时间，单位纳秒
* @return this
@@ -134,7 +134,7 @@ public class ExecutorBuilder implements Builder<ThreadPoolExecutor> {
}
/**
* 设置当线程阻塞（block）时的异常处理器，所谓线程阻塞既线程池和等待队列已满，无法处理线程时采取的策略
* 设置当线程阻塞（block）时的异常处理器，所谓线程阻塞即线程池和等待队列已满，无法处理线程时采取的策略
* <p>
* 此处可以使用JDK预定义的几种策略，见{@link RejectPolicy}枚举
*

2
hutool-core/src/main/java/cn/hutool/core/thread/GlobalThreadPool.java
View File

@@ -8,7 +8,7 @@ import cn.hutool.core.exceptions.UtilException;
/**
* 全局公共线程池<br>
* 此线程池是一个无限线程池，既加入的线程不等待任何线程，直接执行
* 此线程池是一个无限线程池，即加入的线程不等待任何线程，直接执行
*
* @author Looly
*

4
hutool-core/src/main/java/cn/hutool/core/util/ClassUtil.java
View File

@@ -57,7 +57,7 @@ public class ClassUtil {
}
/**
* 是否为顶层类，既定义在包中的类，而非定义在类中的内部类
* 是否为顶层类，即定义在包中的类，而非定义在类中的内部类
*
* @param clazz 类
* @return 是否为顶层类
@@ -924,7 +924,7 @@ public class ClassUtil {
* 获得给定类的泛型参数
*
* @param clazz 被检查的类，必须是已经确定泛型类型的类
* @param index 泛型类型的索引号，既第几个泛型类型
* @param index 泛型类型的索引号，即第几个泛型类型
* @return {@link Class}
*/
public static Class<?> getTypeArgument(Class<?> clazz, int index) {

2
hutool-core/src/main/java/cn/hutool/core/util/NumberUtil.java
View File

@@ -1654,7 +1654,7 @@ public class NumberUtil {
/**
* 比较大小，值相等 返回true<br>
* 此方法通过调用{@link BigDecimal#compareTo(BigDecimal)}方法来判断是否相等<br>
* 此方法判断值相等时忽略精度的，既0.00 == 0
* 此方法判断值相等时忽略精度的，即0.00 == 0
*
* @param bigNum1 数字1
* @param bigNum2 数字2

2
hutool-core/src/main/java/cn/hutool/core/util/ObjectUtil.java
View File

@@ -471,7 +471,7 @@ public class ObjectUtil {
* 获得给定类的第一个泛型参数
*
* @param obj 被检查的对象
* @param index 泛型类型的索引号，既第几个泛型类型
* @param index 泛型类型的索引号，即第几个泛型类型
* @return {@link Class}
* @since 3.0.8
*/

4
hutool-core/src/main/java/cn/hutool/core/util/StrUtil.java
View File

@@ -3271,7 +3271,7 @@ public class StrUtil {
/**
* 比较两个版本<br>
* null版本排在最小：既：
* null版本排在最小：即：
*
* <pre>
* StrUtil.compareVersion(null, "v1") &lt; 0
@@ -4031,7 +4031,7 @@ public class StrUtil {
/**
* 循环位移指定位置的字符串为指定距离<br>
* 当moveLength大于0向右位移，小于0向左位移，0不位移<br>
* 当moveLength大于字符串长度时采取循环位移策略，既位移到头后从头（尾）位移，例如长度为10，位移13则表示位移3
* 当moveLength大于字符串长度时采取循环位移策略，即位移到头后从头（尾）位移，例如长度为10，位移13则表示位移3
*
* @param str 字符串
* @param startInclude 起始位置（包括）

2
hutool-core/src/main/java/cn/hutool/core/util/TypeUtil.java
View File

@@ -203,7 +203,7 @@ public class TypeUtil {
* 获得给定类的泛型参数
*
* @param type 被检查的类型，必须是已经确定泛型类型的类
* @param index 泛型类型的索引号，既第几个泛型类型
* @param index 泛型类型的索引号，即第几个泛型类型
* @return {@link Type}
*/
public static Type getTypeArgument(Type type, int index) {

4
hutool-core/src/main/java/cn/hutool/core/util/XmlUtil.java
View File

@@ -368,7 +368,7 @@ public class XmlUtil {
// -------------------------------------------------------------------------------------- Create
/**
* 创建XML文档<br>
* 创建的XML默认是utf8编码，修改编码的过程是在toStr和toFile方法里，既XML在转为文本的时候才定义编码
* 创建的XML默认是utf8编码，修改编码的过程是在toStr和toFile方法里，即XML在转为文本的时候才定义编码
*
* @return XML文档
* @since 4.0.8
@@ -397,7 +397,7 @@ public class XmlUtil {
/**
* 创建XML文档<br>
* 创建的XML默认是utf8编码，修改编码的过程是在toStr和toFile方法里，既XML在转为文本的时候才定义编码
* 创建的XML默认是utf8编码，修改编码的过程是在toStr和toFile方法里，即XML在转为文本的时候才定义编码
*
* @param rootElementName 根节点名称
* @return XML文档

2
hutool-core/src/test/java/cn/hutool/core/date/DateUtilTest.java
View File

@@ -421,7 +421,7 @@ public class DateUtilTest {
DateTime dt2 = DateUtil.parse(dateStr1);
Assert.assertEquals(dt, dt2);
// 默认使用Pattern对应的时区，既UTC时区
// 默认使用Pattern对应的时区，即UTC时区
String dateStr = dt.toString();
Assert.assertEquals("2018-09-13 05:34:31", dateStr);

6
hutool-core/src/test/java/cn/hutool/core/util/ArrayUtilTest.java
View File

@@ -191,15 +191,15 @@ public class ArrayUtilTest {
String[] result = ArrayUtil.insert(a, -1, b);
Assert.assertArrayEquals(new String[]{"1", "2", "3", "a", "b", "c", "4"}, result);
// 在第0个位置插入，既在数组前追加
// 在第0个位置插入，即在数组前追加
result = ArrayUtil.insert(a, 0, b);
Assert.assertArrayEquals(new String[]{"a", "b", "c", "1", "2", "3", "4"}, result);
// 在第2个位置插入，既"3"之前
// 在第2个位置插入，即"3"之前
result = ArrayUtil.insert(a, 2, b);
Assert.assertArrayEquals(new String[]{"1", "2", "a", "b", "c", "3", "4"}, result);
// 在第4个位置插入，既"4"之后，相当于追加
// 在第4个位置插入，即"4"之后，相当于追加
result = ArrayUtil.insert(a, 4, b);
Assert.assertArrayEquals(new String[]{"1", "2", "3", "4", "a", "b", "c"}, result);