RandomUtil (hutool 5.8.33 API)

java.lang.Object
- cn.hutool.core.util.RandomUtil

```
public class RandomUtil
extends Object
```
随机工具类

Author:

xiaoleilu

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`BASE_CHAR` 用于随机选的字符
`static String`	`BASE_CHAR_NUMBER` 用于随机选的字符和数字（包括大写和小写字母）
`static String`	`BASE_CHAR_NUMBER_LOWER` 用于随机选的字符和数字（小写）
`static String`	`BASE_NUMBER` 用于随机选的数字

Constructor Summary

Constructors
Constructor and Description

RandomUtil()

Constructors
Constructor and Description
`RandomUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static SecureRandom`	`createSecureRandom(byte[] seed)` 创建`SecureRandom`，类提供加密的强随机数生成器 (RNG)
`static ThreadLocalRandom`	`getRandom()` 获取随机数生成器对象 ThreadLocalRandom是JDK 7之后提供并发产生随机数，能够解决多个线程发生的竞争争夺。
`static Random`	`getRandom(boolean isSecure)` 获取随机数产生器
`static SecureRandom`	`getSecureRandom()` 获取SHA1PRNG的`SecureRandom`，类提供加密的强随机数生成器 (RNG) 注意：此方法获取的是伪随机序列发生器PRNG（pseudo-random number generator）相关说明见：https://stackoverflow.com/questions/137212/how-to-solve-slow-java-securerandom
`static SecureRandom`	`getSecureRandom(byte[] seed)` 获取SHA1PRNG的`SecureRandom`，类提供加密的强随机数生成器 (RNG) 注意：此方法获取的是伪随机序列发生器PRNG（pseudo-random number generator）相关说明见：https://stackoverflow.com/questions/137212/how-to-solve-slow-java-securerandom
`static SecureRandom`	`getSecureRandomStrong()` 获取algorithms/providers中提供的强安全随机生成器注意：此方法可能造成阻塞或性能问题
`static SecureRandom`	`getSHA1PRNGRandom(byte[] seed)` 获取SHA1PRNG的`SecureRandom`，类提供加密的强随机数生成器 (RNG) 注意：此方法获取的是伪随机序列发生器PRNG（pseudo-random number generator）,在Linux下噪声生成时可能造成较长时间停顿。
`static BigDecimal`	`randomBigDecimal()` 获得指定范围内的随机数[0, 1)
`static BigDecimal`	`randomBigDecimal(BigDecimal limit)` 获得指定范围内的随机数 [0,limit)
`static BigDecimal`	`randomBigDecimal(BigDecimal minInclude, BigDecimal maxExclude)` 获得指定范围内的随机数
`static boolean`	`randomBoolean()` 获得随机Boolean值
`static byte[]`	`randomBytes(int length)` 随机bytes
`static char`	`randomChar()` 随机字母或数字，小写
`static char`	`randomChar(String baseString)` 随机字符
`static char`	`randomChinese()` 随机汉字（'一'-'鿿'）
`static DateTime`	`randomDate(Date baseDate, DateField dateField, int min, int max)` 以给定日期为基准，随机产生一个日期
`static DateTime`	`randomDay(int min, int max)` 以当天为基准，随机产生一个日期
`static double`	`randomDouble()` 获得随机数[0, 1)
`static double`	`randomDouble(double limit)` 获得指定范围内的随机数 [0,limit)
`static double`	`randomDouble(double minInclude, double maxExclude)` 获得指定范围内的随机数
`static double`	`randomDouble(double minInclude, double maxExclude, int scale, RoundingMode roundingMode)` 获得指定范围内的随机数
`static double`	`randomDouble(double limit, int scale, RoundingMode roundingMode)` 获得指定范围内的随机数
`static double`	`randomDouble(int scale, RoundingMode roundingMode)` 获得指定范围内的随机数
`static <T> T`	`randomEle(List<T> list)` 随机获得列表中的元素
`static <T> T`	`randomEle(List<T> list, int limit)` 随机获得列表中的元素
`static <T> T`	`randomEle(T[] array)` 随机获得数组中的元素
`static <T> T`	`randomEle(T[] array, int limit)` 随机获得数组中的元素
`static <T> List<T>`	`randomEleList(List<T> source, int count)` 随机获得列表中的一定量的元素，返回List 此方法与`randomEles(List, int)` 不同点在于，不会获取重复位置的元素
`static <T> List<T>`	`randomEles(List<T> list, int count)` 随机获得列表中的一定量元素
`static <T> Set<T>`	`randomEleSet(Collection<T> collection, int count)` 随机获得列表中的一定量的不重复元素，返回Set
`static float`	`randomFloat()` 获得随机数[0, 1)
`static float`	`randomFloat(float limitExclude)` 获得指定范围内的随机数 [0,limit)
`static float`	`randomFloat(float minInclude, float maxExclude)` 获得指定范围内的随机数[min, max)
`static int`	`randomInt()` 获得随机数int值
`static int`	`randomInt(int limitExclude)` 获得指定范围内的随机数 [0,limit)
`static int`	`randomInt(int minInclude, int maxExclude)` 获得指定范围内的随机数
`static int`	`randomInt(int min, int max, boolean includeMin, boolean includeMax)` 获得指定范围内的随机数
`static int[]`	`randomInts(int length)` 创建指定长度的随机索引
`static long`	`randomLong()` 获得随机数
`static long`	`randomLong(long limitExclude)` 获得指定范围内的随机数 [0,limit)
`static long`	`randomLong(long minInclude, long maxExclude)` 获得指定范围内的随机数[min, max)
`static long`	`randomLong(long min, long max, boolean includeMin, boolean includeMax)` 获得指定范围内的随机数
`static char`	`randomNumber()` 随机数字，数字为0~9单个数字
`static String`	`randomNumbers(int length)` 获得一个只包含数字的字符串
`static String`	`randomString(int length)` 获得一个随机的字符串（只包含数字和字符）
`static String`	`randomString(String baseString, int length)` 获得一个随机的字符串
`static String`	`randomStringLowerWithoutStr(int length, String elemData)` 获得一个随机的字符串（只包含数字和小写字母）并排除指定字符串
`static String`	`randomStringUpper(int length)` 获得一个随机的字符串（只包含数字和大写字符）
`static String`	`randomStringWithoutStr(int length, String elemData)` 获得一个随机的字符串（只包含数字和字母）并排除指定字符串
`static <T> WeightRandom<T>`	`weightRandom(Iterable<WeightRandom.WeightObj<T>> weightObjs)` 带有权重的随机生成器
`static <T> WeightRandom<T>`	`weightRandom(WeightRandom.WeightObj<T>[] weightObjs)` 带有权重的随机生成器

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - BASE_NUMBER
```
public static final String BASE_NUMBER
```
    用于随机选的数字
    
    See Also:
    
    Constant Field Values
  - BASE_CHAR
```
public static final String BASE_CHAR
```
    用于随机选的字符
    
    See Also:
    
    Constant Field Values
  - BASE_CHAR_NUMBER_LOWER
```
public static final String BASE_CHAR_NUMBER_LOWER
```
    用于随机选的字符和数字（小写）
    
    See Also:
    
    Constant Field Values
  - BASE_CHAR_NUMBER
```
public static final String BASE_CHAR_NUMBER
```
    用于随机选的字符和数字（包括大写和小写字母）
- Constructor Detail
  - RandomUtil
```
public RandomUtil()
```
- Method Detail
  - getRandom
```
public static ThreadLocalRandom getRandom()
```
    获取随机数生成器对象
    ThreadLocalRandom是JDK 7之后提供并发产生随机数，能够解决多个线程发生的竞争争夺。
    注意：此方法返回的ThreadLocalRandom不可以在多线程环境下共享对象，否则有重复随机数问题。见：https://www.jianshu.com/p/89dfe990295c
    
    Returns:
    
    ThreadLocalRandom
    
    Since:
    
    3.1.2
  - createSecureRandom
```
public static SecureRandom createSecureRandom(byte[] seed)
```
    创建SecureRandom，类提供加密的强随机数生成器 (RNG)
    
    Parameters:
    
    seed - 自定义随机种子
    
    Returns:
    
    SecureRandom
    
    Since:
    
    4.6.5
  - getSecureRandom
```
public static SecureRandom getSecureRandom()
```
    获取SHA1PRNG的SecureRandom，类提供加密的强随机数生成器 (RNG)
    注意：此方法获取的是伪随机序列发生器PRNG（pseudo-random number generator）
    相关说明见：https://stackoverflow.com/questions/137212/how-to-solve-slow-java-securerandom
    
    Returns:
    
    SecureRandom
    
    Since:
    
    3.1.2
  - getSecureRandom
```
public static SecureRandom getSecureRandom(byte[] seed)
```
    获取SHA1PRNG的SecureRandom，类提供加密的强随机数生成器 (RNG)
    注意：此方法获取的是伪随机序列发生器PRNG（pseudo-random number generator）
    相关说明见：https://stackoverflow.com/questions/137212/how-to-solve-slow-java-securerandom
    
    Parameters:
    
    seed - 随机数种子
    
    Returns:
    
    SecureRandom
    
    Since:
    
    5.5.2
    
    See Also:
    
    createSecureRandom(byte[])
  - getSHA1PRNGRandom
```
public static SecureRandom getSHA1PRNGRandom(byte[] seed)
```
    获取SHA1PRNG的SecureRandom，类提供加密的强随机数生成器 (RNG)
    注意：此方法获取的是伪随机序列发生器PRNG（pseudo-random number generator）,在Linux下噪声生成时可能造成较长时间停顿。
    see: http://ifeve.com/jvm-random-and-entropy-source/
    相关说明见：https://stackoverflow.com/questions/137212/how-to-solve-slow-java-securerandom
    
    Parameters:
    
    seed - 随机数种子
    
    Returns:
    
    SecureRandom
    
    Since:
    
    5.5.8
  - getSecureRandomStrong
```
public static SecureRandom getSecureRandomStrong()
```
    获取algorithms/providers中提供的强安全随机生成器
    注意：此方法可能造成阻塞或性能问题
    
    Returns:
    
    SecureRandom
    
    Since:
    
    5.7.12
  - getRandom
```
public static Random getRandom(boolean isSecure)
```
    获取随机数产生器
    
    Parameters:
    
    isSecure - 是否为强随机数生成器 (RNG)
    
    Returns:
    
    Random
    
    Since:
    
    4.1.15
    
    See Also:
    
    getSecureRandom(), getRandom()
  - randomBoolean
```
public static boolean randomBoolean()
```
    获得随机Boolean值
    
    Returns:
    
    true or false
    
    Since:
    
    4.5.9
  - randomBytes
```
public static byte[] randomBytes(int length)
```
    随机bytes
    
    Parameters:
    
    length - 长度
    
    Returns:
    
    bytes
  - randomInt
```
public static int randomInt()
```
    获得随机数int值
    
    Returns:
    
    随机数
    
    See Also:
    
    Random.nextInt()
  - randomInt
```
public static int randomInt(int limitExclude)
```
    获得指定范围内的随机数 [0,limit)
    
    Parameters:
    
    limitExclude - 限制随机数的范围，不包括这个数
    
    Returns:
    
    随机数
    
    See Also:
    
    Random.nextInt(int)
  - randomInt
```
public static int randomInt(int minInclude,
                            int maxExclude)
```
    获得指定范围内的随机数
    
    Parameters:
    
    minInclude - 最小数（包含）
    
    maxExclude - 最大数（不包含）
    
    Returns:
    
    随机数
  - randomInt
```
public static int randomInt(int min,
                            int max,
                            boolean includeMin,
                            boolean includeMax)
```
    获得指定范围内的随机数
    
    Parameters:
    
    min - 最小数
    
    max - 最大数
    
    includeMin - 是否包含最小值
    
    includeMax - 是否包含最大值
    
    Returns:
    
    随机数
  - randomInts
```
public static int[] randomInts(int length)
```
    创建指定长度的随机索引
    
    Parameters:
    
    length - 长度
    
    Returns:
    
    随机索引
    
    Since:
    
    5.2.1
  - randomLong
```
public static long randomLong()
```
    获得随机数
    
    Returns:
    
    随机数
    
    Since:
    
    3.3.0
    
    See Also:
    
    ThreadLocalRandom.nextLong()
  - randomLong
```
public static long randomLong(long limitExclude)
```
    获得指定范围内的随机数 [0,limit)
    
    Parameters:
    
    limitExclude - 限制随机数的范围，不包括这个数
    
    Returns:
    
    随机数
    
    See Also:
    
    ThreadLocalRandom.nextLong(long)
  - randomLong
```
public static long randomLong(long minInclude,
                              long maxExclude)
```
    获得指定范围内的随机数[min, max)
    
    Parameters:
    
    minInclude - 最小数（包含）
    
    maxExclude - 最大数（不包含）
    
    Returns:
    
    随机数
    
    Since:
    
    3.3.0
    
    See Also:
    
    ThreadLocalRandom.nextLong(long, long)
  - randomLong
```
public static long randomLong(long min,
                              long max,
                              boolean includeMin,
                              boolean includeMax)
```
    获得指定范围内的随机数
    
    Parameters:
    
    min - 最小数
    
    max - 最大数
    
    includeMin - 是否包含最小值
    
    includeMax - 是否包含最大值
    
    Returns:
    
    随机数
  - randomFloat
```
public static float randomFloat()
```
    获得随机数[0, 1)
    
    Returns:
    
    随机数
    
    See Also:
    
    ThreadLocalRandom.nextFloat()
  - randomFloat
```
public static float randomFloat(float limitExclude)
```
    获得指定范围内的随机数 [0,limit)
    
    Parameters:
    
    limitExclude - 限制随机数的范围，不包括这个数
    
    Returns:
    
    随机数
  - randomFloat
```
public static float randomFloat(float minInclude,
                                float maxExclude)
```
    获得指定范围内的随机数[min, max)
    
    Parameters:
    
    minInclude - 最小数（包含）
    
    maxExclude - 最大数（不包含）
    
    Returns:
    
    随机数
    
    See Also:
    
    ThreadLocalRandom.nextFloat()
  - randomDouble
```
public static double randomDouble(double minInclude,
                                  double maxExclude)
```
    获得指定范围内的随机数
    
    Parameters:
    
    minInclude - 最小数（包含）
    
    maxExclude - 最大数（不包含）
    
    Returns:
    
    随机数
    
    Since:
    
    3.3.0
    
    See Also:
    
    ThreadLocalRandom.nextDouble(double, double)
  - randomDouble
```
public static double randomDouble(double minInclude,
                                  double maxExclude,
                                  int scale,
                                  RoundingMode roundingMode)
```
    获得指定范围内的随机数
    
    Parameters:
    
    minInclude - 最小数（包含）
    
    maxExclude - 最大数（不包含）
    
    scale - 保留小数位数
    
    roundingMode - 保留小数的模式 RoundingMode
    
    Returns:
    
    随机数
    
    Since:
    
    4.0.8
  - randomDouble
```
public static double randomDouble()
```
    获得随机数[0, 1)
    
    Returns:
    
    随机数
    
    Since:
    
    3.3.0
    
    See Also:
    
    ThreadLocalRandom.nextDouble()
  - randomDouble
```
public static double randomDouble(int scale,
                                  RoundingMode roundingMode)
```
    获得指定范围内的随机数
    
    Parameters:
    
    scale - 保留小数位数
    
    roundingMode - 保留小数的模式 RoundingMode
    
    Returns:
    
    随机数
    
    Since:
    
    4.0.8
  - randomDouble
```
public static double randomDouble(double limit)
```
    获得指定范围内的随机数 [0,limit)
    
    Parameters:
    
    limit - 限制随机数的范围，不包括这个数
    
    Returns:
    
    随机数
    
    Since:
    
    3.3.0
    
    See Also:
    
    ThreadLocalRandom.nextDouble(double)
  - randomDouble
```
public static double randomDouble(double limit,
                                  int scale,
                                  RoundingMode roundingMode)
```
    获得指定范围内的随机数
    
    Parameters:
    
    limit - 限制随机数的范围，不包括这个数
    
    scale - 保留小数位数
    
    roundingMode - 保留小数的模式 RoundingMode
    
    Returns:
    
    随机数
    
    Since:
    
    4.0.8
  - randomBigDecimal
```
public static BigDecimal randomBigDecimal()
```
    获得指定范围内的随机数[0, 1)
    
    Returns:
    
    随机数
    
    Since:
    
    4.0.9
  - randomBigDecimal
```
public static BigDecimal randomBigDecimal(BigDecimal limit)
```
    获得指定范围内的随机数 [0,limit)
    
    Parameters:
    
    limit - 最大数（不包含）
    
    Returns:
    
    随机数
    
    Since:
    
    4.0.9
  - randomBigDecimal
```
public static BigDecimal randomBigDecimal(BigDecimal minInclude,
                                          BigDecimal maxExclude)
```
    获得指定范围内的随机数
    
    Parameters:
    
    minInclude - 最小数（包含）
    
    maxExclude - 最大数（不包含）
    
    Returns:
    
    随机数
    
    Since:
    
    4.0.9
  - randomEle
```
public static <T> T randomEle(List<T> list)
```
    随机获得列表中的元素
    
    Type Parameters:
    
    T - 元素类型
    
    Parameters:
    
    list - 列表
    
    Returns:
    
    随机元素
  - randomEle
```
public static <T> T randomEle(List<T> list,
                              int limit)
```
    随机获得列表中的元素
    
    Type Parameters:
    
    T - 元素类型
    
    Parameters:
    
    list - 列表
    
    limit - 限制列表的前N项
    
    Returns:
    
    随机元素
  - randomEle
```
public static <T> T randomEle(T[] array)
```
    随机获得数组中的元素
    
    Type Parameters:
    
    T - 元素类型
    
    Parameters:
    
    array - 列表
    
    Returns:
    
    随机元素
    
    Since:
    
    3.3.0
  - randomEle
```
public static <T> T randomEle(T[] array,
                              int limit)
```
    随机获得数组中的元素
    
    Type Parameters:
    
    T - 元素类型
    
    Parameters:
    
    array - 列表
    
    limit - 限制列表的前N项
    
    Returns:
    
    随机元素
    
    Since:
    
    3.3.0
  - randomEles
```
public static <T> List<T> randomEles(List<T> list,
                                     int count)
```
    随机获得列表中的一定量元素
    
    Type Parameters:
    
    T - 元素类型
    
    Parameters:
    
    list - 列表
    
    count - 随机取出的个数
    
    Returns:
    
    随机元素
  - randomEleList
```
public static <T> List<T> randomEleList(List<T> source,
                                        int count)
```
    随机获得列表中的一定量的元素，返回List
    此方法与randomEles(List, int) 不同点在于，不会获取重复位置的元素
    
    Type Parameters:
    
    T - 元素类型
    
    Parameters:
    
    source - 列表
    
    count - 随机取出的个数
    
    Returns:
    
    随机列表
    
    Since:
    
    5.2.1
  - randomEleSet
```
public static <T> Set<T> randomEleSet(Collection<T> collection,
                                      int count)
```
    随机获得列表中的一定量的不重复元素，返回Set
    
    Type Parameters:
    
    T - 元素类型
    
    Parameters:
    
    collection - 列表
    
    count - 随机取出的个数
    
    Returns:
    
    随机元素
    
    Throws:
    
    IllegalArgumentException - 需要的长度大于给定集合非重复总数
  - randomString
```
public static String randomString(int length)
```
    获得一个随机的字符串（只包含数字和字符）
    
    Parameters:
    
    length - 字符串的长度
    
    Returns:
    
    随机字符串
  - randomStringUpper
```
public static String randomStringUpper(int length)
```
    获得一个随机的字符串（只包含数字和大写字符）
    
    Parameters:
    
    length - 字符串的长度
    
    Returns:
    
    随机字符串
    
    Since:
    
    4.0.13
  - randomStringWithoutStr
```
public static String randomStringWithoutStr(int length,
                                            String elemData)
```
    获得一个随机的字符串（只包含数字和字母）并排除指定字符串
    
    Parameters:
    
    length - 字符串的长度
    
    elemData - 要排除的字符串,如：去重容易混淆的字符串，oO0、lL1、q9Q、pP，区分大小写
    
    Returns:
    
    随机字符串
  - randomStringLowerWithoutStr
```
public static String randomStringLowerWithoutStr(int length,
                                                 String elemData)
```
    获得一个随机的字符串（只包含数字和小写字母）并排除指定字符串
    
    Parameters:
    
    length - 字符串的长度
    
    elemData - 要排除的字符串,如：去重容易混淆的字符串，oO0、lL1、q9Q、pP，不区分大小写
    
    Returns:
    
    随机字符串
    
    Since:
    
    5.8.28
  - randomNumbers
```
public static String randomNumbers(int length)
```
    获得一个只包含数字的字符串
    
    Parameters:
    
    length - 字符串的长度
    
    Returns:
    
    随机字符串
  - randomString
```
public static String randomString(String baseString,
                                  int length)
```
    获得一个随机的字符串
    
    Parameters:
    
    baseString - 随机字符选取的样本
    
    length - 字符串的长度
    
    Returns:
    
    随机字符串
  - randomChinese
```
public static char randomChinese()
```
    随机汉字（'一'-'鿿'）
    
    Returns:
    
    随机的汉字字符
    
    Since:
    
    5.7.15
  - randomNumber
```
public static char randomNumber()
```
    随机数字，数字为0~9单个数字
    
    Returns:
    
    随机数字字符
    
    Since:
    
    3.1.2
  - randomChar
```
public static char randomChar()
```
    随机字母或数字，小写
    
    Returns:
    
    随机字符
    
    Since:
    
    3.1.2
  - randomChar
```
public static char randomChar(String baseString)
```
    随机字符
    
    Parameters:
    
    baseString - 随机字符选取的样本
    
    Returns:
    
    随机字符
    
    Since:
    
    3.1.2
  - weightRandom
```
public static <T> WeightRandom<T> weightRandom(WeightRandom.WeightObj<T>[] weightObjs)
```
    带有权重的随机生成器
    
    Type Parameters:
    
    T - 随机对象类型
    
    Parameters:
    
    weightObjs - 带有权重的对象列表
    
    Returns:
    
    WeightRandom
    
    Since:
    
    4.0.3
  - weightRandom
```
public static <T> WeightRandom<T> weightRandom(Iterable<WeightRandom.WeightObj<T>> weightObjs)
```
    带有权重的随机生成器
    
    Type Parameters:
    
    T - 随机对象类型
    
    Parameters:
    
    weightObjs - 带有权重的对象列表
    
    Returns:
    
    WeightRandom
    
    Since:
    
    4.0.3
  - randomDay
```
public static DateTime randomDay(int min,
                                 int max)
```
    以当天为基准，随机产生一个日期
    
    Parameters:
    
    min - 偏移最小天，可以为负数表示过去的时间（包含）
    
    max - 偏移最大天，可以为负数表示过去的时间（不包含）
    
    Returns:
    
    随机日期（随机天，其它时间不变）
    
    Since:
    
    4.0.8
  - randomDate
```
public static DateTime randomDate(Date baseDate,
                                  DateField dateField,
                                  int min,
                                  int max)
```
    以给定日期为基准，随机产生一个日期
    
    Parameters:
    
    baseDate - 基准日期
    
    dateField - 偏移的时间字段，例如时、分、秒等
    
    min - 偏移最小量，可以为负数表示过去的时间（包含）
    
    max - 偏移最大量，可以为负数表示过去的时间（不包含）
    
    Returns:
    
    随机日期
    
    Since:
    
    4.5.8

Class RandomUtil

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

BASE_NUMBER

BASE_CHAR

BASE_CHAR_NUMBER_LOWER

BASE_CHAR_NUMBER

Constructor Detail

RandomUtil

Method Detail

getRandom

createSecureRandom

getSecureRandom

getSecureRandom

getSHA1PRNGRandom

getSecureRandomStrong

getRandom

randomBoolean

randomBytes

randomInt

randomInt

randomInt

randomInt

randomInts

randomLong

randomLong

randomLong

randomLong

randomFloat

randomFloat

randomFloat

randomDouble

randomDouble

randomDouble

randomDouble

randomDouble

randomDouble

randomBigDecimal

randomBigDecimal

randomBigDecimal

randomEle

randomEle

randomEle

randomEle

randomEles

randomEleList

randomEleSet

randomString

randomStringUpper

randomStringWithoutStr

randomStringLowerWithoutStr

randomNumbers

randomString

randomChinese

randomNumber

randomChar

randomChar

weightRandom

weightRandom

randomDay

randomDate