diff --git a/CHANGELOG.md b/CHANGELOG.md
index 378476d34..119041a70 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -13,6 +13,7 @@
* 【core】 增加DateUtil.parseCST方法（issue#570@Github）
* 【core】 增加defaultIfEmpty方法
* 【crypto】 修改bigIntToFixexLengthBytes为bigIntToFixedLengthBytes（pr#575@Github）
+* 【core】 RandomUtil增加randomStringWithoutStr（pr#76@Gitee）
### Bug修复
* 【all】 修复阶乘计算错误bug（issue#I12XE4@Gitee）
diff --git a/hutool-core/src/main/java/cn/hutool/core/util/RandomUtil.java b/hutool-core/src/main/java/cn/hutool/core/util/RandomUtil.java
index 8d11c3163..0505546c7 100644
--- a/hutool-core/src/main/java/cn/hutool/core/util/RandomUtil.java
+++ b/hutool-core/src/main/java/cn/hutool/core/util/RandomUtil.java
@@ -25,23 +25,28 @@ import cn.hutool.core.lang.WeightRandom.WeightObj;
/**
* 随机工具类
- *
- * @author xiaoleilu
*
+ * @author xiaoleilu
*/
public class RandomUtil {
- /** 用于随机选的数字 */
+ /**
+ * 用于随机选的数字
+ */
public static final String BASE_NUMBER = "0123456789";
- /** 用于随机选的字符 */
+ /**
+ * 用于随机选的字符
+ */
public static final String BASE_CHAR = "abcdefghijklmnopqrstuvwxyz";
- /** 用于随机选的字符和数字 */
+ /**
+ * 用于随机选的字符和数字
+ */
public static final String BASE_CHAR_NUMBER = BASE_CHAR + BASE_NUMBER;
/**
* 获取随机数生成器对象
* ThreadLocalRandom是JDK 7之后提供并发产生随机数，能够解决多个线程发生的竞争争夺。
- *
+ *
* @return {@link ThreadLocalRandom}
* @since 3.1.2
*/
@@ -51,7 +56,7 @@ public class RandomUtil {
/**
* 创建{@link SecureRandom}，类提供加密的强随机数生成器 (RNG)
- *
+ *
* @param seed 自定义随机种子
* @return {@link SecureRandom}
* @since 4.6.5
@@ -63,10 +68,10 @@ public class RandomUtil {
/**
* 获取{@link SecureRandom}，类提供加密的强随机数生成器 (RNG)
* 注意：此方法获取的是伪随机序列发生器PRNG（pseudo-random number generator）
- *
+ *
*
* 相关说明见：https://stackoverflow.com/questions/137212/how-to-solve-slow-java-securerandom
- *
+ *
* @return {@link SecureRandom}
* @since 3.1.2
*/
@@ -80,12 +85,12 @@ public class RandomUtil {
/**
* 获取随机数产生器
- *
+ *
* @param isSecure 是否为强随机数生成器 (RNG)
* @return {@link Random}
- * @since 4.1.15
* @see #getSecureRandom()
* @see #getRandom()
+ * @since 4.1.15
*/
public static Random getRandom(boolean isSecure) {
return isSecure ? getSecureRandom() : getRandom();
@@ -93,7 +98,7 @@ public class RandomUtil {
/**
* 获得随机Boolean值
- *
+ *
* @return true or false
* @since 4.5.9
*/
@@ -103,7 +108,7 @@ public class RandomUtil {
/**
* 获得指定范围内的随机数
- *
+ *
* @param min 最小数（包含）
* @param max 最大数（不包含）
* @return 随机数
@@ -114,7 +119,7 @@ public class RandomUtil {
/**
* 获得随机数[0, 2^32)
- *
+ *
* @return 随机数
*/
public static int randomInt() {
@@ -123,7 +128,7 @@ public class RandomUtil {
/**
* 获得指定范围内的随机数 [0,limit)
- *
+ *
* @param limit 限制随机数的范围，不包括这个数
* @return 随机数
*/
@@ -133,7 +138,7 @@ public class RandomUtil {
/**
* 获得指定范围内的随机数[min, max)
- *
+ *
* @param min 最小数（包含）
* @param max 最大数（不包含）
* @return 随机数
@@ -145,7 +150,7 @@ public class RandomUtil {
/**
* 获得随机数
- *
+ *
* @return 随机数
* @since 3.3.0
*/
@@ -155,7 +160,7 @@ public class RandomUtil {
/**
* 获得指定范围内的随机数 [0,limit)
- *
+ *
* @param limit 限制随机数的范围，不包括这个数
* @return 随机数
*/
@@ -165,7 +170,7 @@ public class RandomUtil {
/**
* 获得指定范围内的随机数
- *
+ *
* @param min 最小数（包含）
* @param max 最大数（不包含）
* @return 随机数
@@ -177,10 +182,10 @@ public class RandomUtil {
/**
* 获得指定范围内的随机数
- *
- * @param min 最小数（包含）
- * @param max 最大数（不包含）
- * @param scale 保留小数位数
+ *
+ * @param min 最小数（包含）
+ * @param max 最大数（不包含）
+ * @param scale 保留小数位数
* @param roundingMode 保留小数的模式 {@link RoundingMode}
* @return 随机数
* @since 4.0.8
@@ -191,7 +196,7 @@ public class RandomUtil {
/**
* 获得随机数[0, 1)
- *
+ *
* @return 随机数
* @since 3.3.0
*/
@@ -201,8 +206,8 @@ public class RandomUtil {
/**
* 获得指定范围内的随机数
- *
- * @param scale 保留小数位数
+ *
+ * @param scale 保留小数位数
* @param roundingMode 保留小数的模式 {@link RoundingMode}
* @return 随机数
* @since 4.0.8
@@ -213,7 +218,7 @@ public class RandomUtil {
/**
* 获得指定范围内的随机数 [0,limit)
- *
+ *
* @param limit 限制随机数的范围，不包括这个数
* @return 随机数
* @since 3.3.0
@@ -224,9 +229,9 @@ public class RandomUtil {
/**
* 获得指定范围内的随机数
- *
- * @param limit 限制随机数的范围，不包括这个数
- * @param scale 保留小数位数
+ *
+ * @param limit 限制随机数的范围，不包括这个数
+ * @param scale 保留小数位数
* @param roundingMode 保留小数的模式 {@link RoundingMode}
* @return 随机数
* @since 4.0.8
@@ -237,7 +242,7 @@ public class RandomUtil {
/**
* 获得指定范围内的随机数[0, 1)
- *
+ *
* @return 随机数
* @since 4.0.9
*/
@@ -247,7 +252,7 @@ public class RandomUtil {
/**
* 获得指定范围内的随机数 [0,limit)
- *
+ *
* @param limit 最大数（不包含）
* @return 随机数
* @since 4.0.9
@@ -258,7 +263,7 @@ public class RandomUtil {
/**
* 获得指定范围内的随机数
- *
+ *
* @param min 最小数（包含）
* @param max 最大数（不包含）
* @return 随机数
@@ -270,7 +275,7 @@ public class RandomUtil {
/**
* 随机bytes
- *
+ *
* @param length 长度
* @return bytes
*/
@@ -282,8 +287,8 @@ public class RandomUtil {
/**
* 随机获得列表中的元素
- *
- * @param 元素类型
+ *
+ * @param 元素类型
* @param list 列表
* @return 随机元素
*/
@@ -293,9 +298,9 @@ public class RandomUtil {
/**
* 随机获得列表中的元素
- *
- * @param 元素类型
- * @param list 列表
+ *
+ * @param 元素类型
+ * @param list 列表
* @param limit 限制列表的前N项
* @return 随机元素
*/
@@ -305,8 +310,8 @@ public class RandomUtil {
/**
* 随机获得数组中的元素
- *
- * @param 元素类型
+ *
+ * @param 元素类型
* @param array 列表
* @return 随机元素
* @since 3.3.0
@@ -317,8 +322,8 @@ public class RandomUtil {
/**
* 随机获得数组中的元素
- *
- * @param 元素类型
+ *
+ * @param 元素类型
* @param array 列表
* @param limit 限制列表的前N项
* @return 随机元素
@@ -330,9 +335,9 @@ public class RandomUtil {
/**
* 随机获得列表中的一定量元素
- *
- * @param 元素类型
- * @param list 列表
+ *
+ * @param 元素类型
+ * @param list 列表
* @param count 随机取出的个数
* @return 随机元素
*/
@@ -348,10 +353,10 @@ public class RandomUtil {
/**
* 随机获得列表中的一定量的不重复元素，返回Set
- *
- * @param 元素类型
+ *
+ * @param 元素类型
* @param collection 列表
- * @param count 随机取出的个数
+ * @param count 随机取出的个数
* @return 随机元素
* @throws IllegalArgumentException 需要的长度大于给定集合非重复总数
*/
@@ -372,7 +377,7 @@ public class RandomUtil {
/**
* 获得一个随机的字符串（只包含数字和字符）
- *
+ *
* @param length 字符串的长度
* @return 随机字符串
*/
@@ -382,7 +387,7 @@ public class RandomUtil {
/**
* 获得一个随机的字符串（只包含数字和大写字符）
- *
+ *
* @param length 字符串的长度
* @return 随机字符串
* @since 4.0.13
@@ -394,22 +399,19 @@ public class RandomUtil {
/**
* 获得一个随机的字符串（只包含数字和字符） 并排除指定字符串
*
- * @param length 字符串的长度
+ * @param length 字符串的长度
* @param elemData 要排除的字符串
* @return 随机字符串
*/
- public static String randomStringWithoutStr(int length,String elemData) {
- String baseStr=BASE_CHAR_NUMBER;
- baseStr=StrUtil.removeAll(baseStr,elemData.toCharArray());
- if(baseStr.equals("")){
- return "";
- }
+ public static String randomStringWithoutStr(int length, String elemData) {
+ String baseStr = BASE_CHAR_NUMBER;
+ baseStr = StrUtil.removeAll(baseStr, elemData.toCharArray());
return randomString(baseStr, length);
}
/**
* 获得一个只包含数字的字符串
- *
+ *
* @param length 字符串的长度
* @return 随机字符串
*/
@@ -419,12 +421,15 @@ public class RandomUtil {
/**
* 获得一个随机的字符串
- *
+ *
* @param baseString 随机字符选取的样本
- * @param length 字符串的长度
+ * @param length 字符串的长度
* @return 随机字符串
*/
public static String randomString(String baseString, int length) {
+ if (StrUtil.isEmpty(baseString)) {
+ return StrUtil.EMPTY;
+ }
final StringBuilder sb = new StringBuilder(length);
if (length < 1) {
@@ -440,7 +445,7 @@ public class RandomUtil {
/**
* 随机数字，数字为0~9单个数字
- *
+ *
* @return 随机数字字符
* @since 3.1.2
*/
@@ -450,7 +455,7 @@ public class RandomUtil {
/**
* 随机字母或数字，小写
- *
+ *
* @return 随机字符
* @since 3.1.2
*/
@@ -460,7 +465,7 @@ public class RandomUtil {
/**
* 随机字符
- *
+ *
* @param baseString 随机字符选取的样本
* @return 随机字符
* @since 3.1.2
@@ -471,7 +476,7 @@ public class RandomUtil {
/**
* 生成随机颜色
- *
+ *
* @return 随机颜色
* @since 4.1.5
*/
@@ -483,7 +488,7 @@ public class RandomUtil {
/**
* 带有权重的随机生成器
*
- * @param 随机对象类型
+ * @param 随机对象类型
* @param weightObjs 带有权重的对象列表
* @return {@link WeightRandom}
* @since 4.0.3
@@ -495,7 +500,7 @@ public class RandomUtil {
/**
* 带有权重的随机生成器
*
- * @param 随机对象类型
+ * @param 随机对象类型
* @param weightObjs 带有权重的对象列表
* @return {@link WeightRandom}
* @since 4.0.3
@@ -505,6 +510,7 @@ public class RandomUtil {
}
// ------------------------------------------------------------------- UUID
+
/**
* @return 随机UUID
* @deprecated 请使用{@link IdUtil#randomUUID()}
@@ -516,7 +522,7 @@ public class RandomUtil {
/**
* 简化的UUID，去掉了横线
- *
+ *
* @return 简化的UUID，去掉了横线
* @since 3.2.2
* @deprecated 请使用{@link IdUtil#simpleUUID()}
@@ -528,7 +534,7 @@ public class RandomUtil {
/**
* 以当天为基准，随机产生一个日期
- *
+ *
* @param min 偏移最小天，可以为负数表示过去的时间（包含）
* @param max 偏移最大天，可以为负数表示过去的时间（不包含）
* @return 随机日期（随机天，其它时间不变）
@@ -540,11 +546,11 @@ public class RandomUtil {
/**
* 以给定日期为基准，随机产生一个日期
- *
- * @param baseDate 基准日期
+ *
+ * @param baseDate 基准日期
* @param dateField 偏移的时间字段，例如时、分、秒等
- * @param min 偏移最小量，可以为负数表示过去的时间（包含）
- * @param max 偏移最大量，可以为负数表示过去的时间（不包含）
+ * @param min 偏移最小量，可以为负数表示过去的时间（包含）
+ * @param max 偏移最大量，可以为负数表示过去的时间（不包含）
* @return 随机日期
* @since 4.5.8
*/