lsm/hutool
1
0
Fork 0
mirror of https://gitee.com/dromara/hutool.git synced 2025-04-24 18:04:54 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

RandomUtil增加可选是否包含边界的重载

Browse Source
This commit is contained in:
Looly 2023-06-30 10:13:15 +08:00
parent c4373832b8
commit 566c43d464
2 changed files with 179 additions and 68 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
hutool-core/src/main/java/org/dromara/hutool/core/date/DateUtil.java
View File

@ -57,6 +57,7 @@ public class DateUtil extends CalendarUtil {
"gmt", "ut", "utc", "est", "edt", "cst", "cdt", "mst", "mdt", "pst", "pdt"// 时间标准
};
// region ----- date
/**
* 当前时间，转换为{@link DateTime}对象
*
@ -184,6 +185,7 @@ public class DateUtil extends CalendarUtil {
}
return new DateTime(temporalAccessor);
}
// endregion
/**
* 当前时间的时间戳
@ -1688,6 +1690,7 @@ public class DateUtil extends CalendarUtil {
return sb.toString();
}
// region ----- range
/**
* 创建日期范围生成器
*
@ -1793,6 +1796,7 @@ public class DateUtil extends CalendarUtil {
public static List<DateTime> rangeToList(final Date start, final Date end, final DateField unit, final int step) {
return ListUtil.of((Iterable<DateTime>) new DateRange(start, end, unit, step));
}
// endregion
/**
* 通过生日计算星座

243
hutool-core/src/main/java/org/dromara/hutool/core/util/RandomUtil.java
View File

@ -56,6 +56,8 @@ public class RandomUtil {
*/
public static final String BASE_CHAR_NUMBER = BASE_CHAR.toUpperCase() + BASE_CHAR_NUMBER_LOWER;
// region ----- get or create Random
/**
* 获取随机数生成器对象<br>
* ThreadLocalRandom是JDK 7之后提供并发产生随机数，能够解决多个线程发生的竞争争夺。
@ -165,6 +167,7 @@ public class RandomUtil {
public static Random getRandom(final boolean isSecure) {
return isSecure ? getSecureRandom() : getRandom();
}
// endregion
/**
* 获得随机Boolean值
@ -176,6 +179,18 @@ public class RandomUtil {
return 0 == randomInt(2);
}
/**
* 随机bytes
*
* @param length 长度
* @return bytes
*/
public static byte[] randomBytes(final int length) {
final byte[] bytes = new byte[length];
getRandom().nextBytes(bytes);
return bytes;
}
/**
* 随机汉字（'\u4E00'-'\u9FFF'）
*
@ -186,16 +201,7 @@ public class RandomUtil {
return (char) randomInt('\u4E00', '\u9FFF');
}
/**
* 获得指定范围内的随机数
*
* @param min 最小数（包含）
* @param max 最大数（不包含）
* @return 随机数
*/
public static int randomInt(final int min, final int max) {
return getRandom().nextInt(min, max);
}
// region ----- randomInt
/**
* 获得随机数int值
@ -210,27 +216,63 @@ public class RandomUtil {
/**
* 获得指定范围内的随机数 [0,limit)
*
* @param limit 限制随机数的范围，不包括这个数
* @param limitExclude 限制随机数的范围，不包括这个数
* @return 随机数
* @see Random#nextInt(int)
*/
public static int randomInt(final int limit) {
return getRandom().nextInt(limit);
public static int randomInt(final int limitExclude) {
return getRandom().nextInt(limitExclude);
}
/**
* 获得指定范围内的随机数[min, max)
* 获得指定范围内的随机数
*
* @param min 最小数（包含）
* @param max 最大数（不包含）
* @param minInclude 最小数（包含）
* @param maxExclude 最大数（不包含）
* @return 随机数
* @see ThreadLocalRandom#nextLong(long, long)
* @since 3.3.0
*/
public static long randomLong(final long min, final long max) {
return getRandom().nextLong(min, max);
public static int randomInt(final int minInclude, final int maxExclude) {
return randomInt(minInclude, maxExclude, true, false);
}
/**
* 获得指定范围内的随机数
*
* @param min 最小数
* @param max 最大数
* @param includeMin 是否包含最小值
* @param includeMax 是否包含最大值
* @return 随机数
*/
public static int randomInt(int min, int max, final boolean includeMin, final boolean includeMax) {
if (!includeMin) {
min++;
}
if (includeMax) {
max--;
}
return getRandom().nextInt(min, max);
}
/**
* 创建指定长度的随机索引
*
* @param length 长度
* @return 随机索引
* @since 5.2.1
*/
public static int[] randomInts(final int length) {
final int[] range = NumberUtil.range(length);
for (int i = 0; i < length; i++) {
final int random = randomInt(i, length);
ArrayUtil.swap(range, i, random);
}
return range;
}
// endregion
// region ----- randomLong
/**
* 获得随机数
*
@ -245,39 +287,114 @@ public class RandomUtil {
/**
* 获得指定范围内的随机数 [0,limit)
*
* @param limit 限制随机数的范围，不包括这个数
* @param limitExclude 限制随机数的范围，不包括这个数
* @return 随机数
* @see ThreadLocalRandom#nextLong(long)
*/
public static long randomLong(final long limit) {
return getRandom().nextLong(limit);
public static long randomLong(final long limitExclude) {
return getRandom().nextLong(limitExclude);
}
/**
* 获得指定范围内的随机数[min, max)
*
* @param minInclude 最小数（包含）
* @param maxExclude 最大数（不包含）
* @return 随机数
* @see ThreadLocalRandom#nextLong(long, long)
* @since 3.3.0
*/
public static long randomLong(final long minInclude, final long maxExclude) {
return randomLong(minInclude, maxExclude, true, false);
}
/**
* 获得指定范围内的随机数
*
* @param min 最小数（包含）
* @param max 最大数（不包含）
* @param min 最小数
* @param max 最大数
* @param includeMin 是否包含最小值
* @param includeMax 是否包含最大值
* @return 随机数
*/
public static long randomLong(long min, long max, final boolean includeMin, final boolean includeMax) {
if (!includeMin) {
min++;
}
if (includeMax) {
max--;
}
return getRandom().nextLong(min, max);
}
// endregion
// region ----- randomFloat
/**
* 获得随机数[0, 1)
*
* @return 随机数
* @see ThreadLocalRandom#nextFloat()
*/
public static float randomFloat() {
return getRandom().nextFloat();
}
/**
* 获得指定范围内的随机数 [0,limit)
*
* @param limitExclude 限制随机数的范围，不包括这个数
* @return 随机数
*/
public static float randomFloat(final float limitExclude) {
return randomFloat(0, limitExclude);
}
/**
* 获得指定范围内的随机数[min, max)
*
* @param minInclude 最小数（包含）
* @param maxExclude 最大数（不包含）
* @return 随机数
* @see ThreadLocalRandom#nextFloat()
*/
public static float randomFloat(final float minInclude, final float maxExclude) {
if (minInclude == maxExclude) {
return minInclude;
}
return minInclude + ((maxExclude - minInclude) * getRandom().nextFloat());
}
// endregion
// region ----- randomDouble
/**
* 获得指定范围内的随机数
*
* @param minInclude 最小数（包含）
* @param maxExclude 最大数（不包含）
* @return 随机数
* @see ThreadLocalRandom#nextDouble(double, double)
* @since 3.3.0
*/
public static double randomDouble(final double min, final double max) {
return getRandom().nextDouble(min, max);
public static double randomDouble(final double minInclude, final double maxExclude) {
return getRandom().nextDouble(minInclude, maxExclude);
}
/**
* 获得指定范围内的随机数
*
* @param min 最小数（包含）
* @param max 最大数（不包含）
* @param minInclude 最小数（包含）
* @param maxExclude 最大数（不包含）
* @param scale 保留小数位数
* @param roundingMode 保留小数的模式 {@link RoundingMode}
* @return 随机数
* @since 4.0.8
*/
public static double randomDouble(final double min, final double max, final int scale, final RoundingMode roundingMode) {
return NumberUtil.round(randomDouble(min, max), scale, roundingMode).doubleValue();
public static double randomDouble(final double minInclude, final double maxExclude, final int scale,
final RoundingMode roundingMode) {
return NumberUtil.round(randomDouble(minInclude, maxExclude), scale, roundingMode).doubleValue();
}
/**
@ -327,6 +444,9 @@ public class RandomUtil {
public static double randomDouble(final double limit, final int scale, final RoundingMode roundingMode) {
return NumberUtil.round(randomDouble(limit), scale, roundingMode).doubleValue();
}
// endregion
// region ----- randomBigDecimal
/**
* 获得指定范围内的随机数[0, 1)
@ -341,37 +461,28 @@ public class RandomUtil {
/**
* 获得指定范围内的随机数 [0,limit)
*
* @param limit 最大数（不包含）
* @param limitExclude 最大数（不包含）
* @return 随机数
* @since 4.0.9
*/
public static BigDecimal randomBigDecimal(final BigDecimal limit) {
return NumberUtil.toBigDecimal(getRandom().nextDouble(limit.doubleValue()));
public static BigDecimal randomBigDecimal(final BigDecimal limitExclude) {
return NumberUtil.toBigDecimal(getRandom().nextDouble(limitExclude.doubleValue()));
}
/**
* 获得指定范围内的随机数
*
* @param min 最小数（包含）
* @param max 最大数（不包含）
* @param minInclude 最小数（包含）
* @param maxExclude 最大数（不包含）
* @return 随机数
* @since 4.0.9
*/
public static BigDecimal randomBigDecimal(final BigDecimal min, final BigDecimal max) {
return NumberUtil.toBigDecimal(getRandom().nextDouble(min.doubleValue(), max.doubleValue()));
public static BigDecimal randomBigDecimal(final BigDecimal minInclude, final BigDecimal maxExclude) {
return NumberUtil.toBigDecimal(getRandom().nextDouble(minInclude.doubleValue(), maxExclude.doubleValue()));
}
// endregion
/**
* 随机bytes
*
* @param length 长度
* @return bytes
*/
public static byte[] randomBytes(final int length) {
final byte[] bytes = new byte[length];
getRandom().nextBytes(bytes);
return bytes;
}
// region ----- randomEle
/**
* 随机获得列表中的元素
@ -470,8 +581,8 @@ public class RandomUtil {
/**
* 生成从种子中获取随机数字
*
* @param size 指定产生随机数的个数
* @param seed 种子，用于取随机数的int池
* @param size 指定产生随机数的个数
* @param seed 种子，用于取随机数的int池
* @return 随机int数组
* @since 5.4.5
*/
@ -514,22 +625,9 @@ public class RandomUtil {
return result;
}
// endregion
/**
* 创建指定长度的随机索引
*
* @param length 长度
* @return 随机索引
* @since 5.2.1
*/
public static int[] randomInts(final int length) {
final int[] range = NumberUtil.range(length);
for (int i = 0; i < length; i++) {
final int random = randomInt(i, length);
ArrayUtil.swap(range, i, random);
}
return range;
}
// region ----- randomString
/**
* 获得一个随机的字符串（只包含数字和大小写字母）
@ -596,7 +694,7 @@ public class RandomUtil {
if (StrUtil.isEmpty(baseString)) {
return StrUtil.EMPTY;
}
if(length < 1){
if (length < 1) {
length = 1;
}
@ -608,6 +706,9 @@ public class RandomUtil {
}
return sb.toString();
}
// endregion
// region ---- randomChar
/**
* 随机数字，数字为0~9单个数字
@ -639,6 +740,9 @@ public class RandomUtil {
public static char randomChar(final String baseString) {
return baseString.charAt(randomInt(baseString.length()));
}
// endregion
// region ----- weightRandom
/**
* 带有权重的随机生成器
@ -663,6 +767,9 @@ public class RandomUtil {
public static <T> WeightRandomSelector<T> weightRandom(final Iterable<WeightObj<T>> weightObjs) {
return new WeightRandomSelector<>(weightObjs);
}
// endregion
// region ----- randomDate
/**
* 以当天为基准，随机产生一个日期
@ -693,5 +800,5 @@ public class RandomUtil {
return DateUtil.offset(baseDate, dateField, randomInt(min, max));
}
// endregion
}