RandomUtils (noark-core 3.2.3.Final API)

java.lang.Object
- xyz.noark.core.util.RandomUtils

```
public class RandomUtils
extends java.lang.Object
```
随机数相关操作工具类.
本工具类中统一以ThreadLocalRandom为基础的封装

从以下版本开始:

3.0

作者:

小流氓(176543888@qq.com)

构造器概要

构造器
构造器和说明

RandomUtils()

构造器
构造器和说明
`RandomUtils()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static boolean`	`isSuccess(double rate)` 判定一次随机事件是否成功.
`static boolean`	`isSuccess(float rate)` 判定一次随机事件是否成功.
`static boolean`	`isSuccessByPercentage(int rate)` 判定一次百分比的随机事件是否成功.
`static boolean`	`isSuccessByPermillage(int rate)` 判定一次千分比的随机事件是否成功.
`static boolean`	`nextBoolean()` 返回一个随机Boolean值.
`static int`	`nextInt(int bound)` 返回一个0到指定区间的随机数字.
`static int`	`nextInt(int origin, int bound)` 返回一个指定区间的随机数字.
`static long`	`nextLong(int origin, int bound)` 返回一个指定区间的随机数字.
`static long`	`nextLong(long bound)` 返回一个0到指定区间的随机数字.
`static <T> T`	`randomByWeight(java.util.List<T> data, java.util.function.ToIntFunction<? super T> weightFunction)` 在指定集合中按权重随机出一个元素.
`static <T> java.util.List<T>`	`randomByWeight(java.util.List<T> data, java.util.function.ToIntFunction<? super T> weightFunction, int num)` 在指定集合中按权重随机出指定数量个元素.
`static <K> K`	`randomByWeight(java.util.Map<K,java.lang.Integer> data)` 在指定集合中按权重随机出一个元素.
`static <T> T`	`randomList(java.util.List<T> list)` 在指定集合中随机出一个元素.
`static <T> java.util.List<T>`	`randomList(java.util.List<T> source, int num)` 从一个List集合中随机出指定数量的元素.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - RandomUtils
```
public RandomUtils()
```
- 方法详细资料
  - nextBoolean
```
public static boolean nextBoolean()
```
    返回一个随机Boolean值.
    
    返回:
    
    随机Boolean值
  - nextInt
```
public static int nextInt(int bound)
```
    返回一个0到指定区间的随机数字.
    0 <= random < bound
    
    参数:
    
    bound - 最大值（不包含）
    
    返回:
    
    返回一个0到指定区间的随机数字
  - nextInt
```
public static int nextInt(int origin,
                          int bound)
```
    返回一个指定区间的随机数字.
    origin <= random < bound
    
    参数:
    
    origin - 最小值（包含）
    
    bound - 最大值（不包含）
    
    返回:
    
    返回一个指定区间的随机数字
  - nextLong
```
public static long nextLong(long bound)
```
    返回一个0到指定区间的随机数字.
    0 <= random < bound
    
    参数:
    
    bound - 最大值（不包含）
    
    返回:
    
    返回一个0到指定区间的随机数字
  - nextLong
```
public static long nextLong(int origin,
                            int bound)
```
    返回一个指定区间的随机数字.
    origin <= random < bound
    
    参数:
    
    origin - 最小值（包含）
    
    bound - 最大值（不包含）
    
    返回:
    
    返回一个指定区间的随机数字
  - isSuccess
```
public static boolean isSuccess(float rate)
```
    判定一次随机事件是否成功.
```
 如果rate>=1,则百分百返回true.

 如果rate<=0,则百分百返回false.
 
```
    参数:
    
    rate - 成功率
    
    返回:
    
    如果成功返回true,否则返回false.
  - isSuccess
```
public static boolean isSuccess(double rate)
```
    判定一次随机事件是否成功.
```
 如果rate>=1,则百分百返回true.

 如果rate<=0,则百分百返回false.
 
```
    参数:
    
    rate - 成功率
    
    返回:
    
    如果成功返回true,否则返回false.
  - isSuccessByPercentage
```
public static boolean isSuccessByPercentage(int rate)
```
    判定一次百分比的随机事件是否成功.
    参数自动转化为百分比单位，就是除100
```
 RandomUtils.isSuccessByPercentage(rate) = RandomUtils.isSuccess(rate / 100D)
 
```
    参数:
    
    rate - 成功率/100D
    
    返回:
    
    如果成功返回true,否则返回false.
  - isSuccessByPermillage
```
public static boolean isSuccessByPermillage(int rate)
```
    判定一次千分比的随机事件是否成功.
    参数自动转化为千分比单位，就是除1000
```
 RandomUtils.isSuccessByPermillage(rate) = RandomUtils.isSuccess(rate / 1000D)
 
```
    参数:
    
    rate - 成功率/1000D
    
    返回:
    
    如果成功返回true,否则返回false.
  - randomList
```
public static <T> T randomList(java.util.List<T> list)
```
    在指定集合中随机出一个元素.
    所以元素无权重的随机.
    
    类型参数:
    
    T - 要随机集合里的元素类型
    
    参数:
    
    list - 指定集合
    
    返回:
    
    随机返回集合中的一个元素.
  - randomList
```
public static <T> java.util.List<T> randomList(java.util.List<T> source,
                                               int num)
```
    从一个List集合中随机出指定数量的元素.
    source = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9] random(source, 5) = [5, 3, 6, 7, 2]
    
    类型参数:
    
    T - 要随机集合里的元素类型
    
    参数:
    
    source - List集合
    
    num - 指定数量
    
    返回:
    
    如果源为空或指定数量小于1，则返回空集合，否则随机抽取元素组装新集合并返回
  - randomByWeight
```
public static <K> K randomByWeight(java.util.Map<K,java.lang.Integer> data)
```
    在指定集合中按权重随机出一个元素.
    K为元素，如果是自定义对象记得重写HashCode和equals.
    V为权重，机率为V/(sum(All))
    
    类型参数:
    
    K - 要随机的元素类型，也是Map的Key
    
    参数:
    
    data - 随机集合
    
    返回:
    
    按权重随机返回集合中的一个元素.
  - randomByWeight
```
public static <T> T randomByWeight(java.util.List<T> data,
                                   java.util.function.ToIntFunction<? super T> weightFunction)
```
    在指定集合中按权重随机出一个元素.
    权重，机率为V/(sum(All))
    
    类型参数:
    
    T - 要随机的元素类型
    
    参数:
    
    data - 随机集合
    
    weightFunction - 元素中权重方法
    
    返回:
    
    按权重随机返回集合中的一个元素
  - randomByWeight
```
public static <T> java.util.List<T> randomByWeight(java.util.List<T> data,
                                                   java.util.function.ToIntFunction<? super T> weightFunction,
                                                   int num)
```
    在指定集合中按权重随机出指定数量个元素.
    权重，机率为V/(sum(All))
    
    类型参数:
    
    T - 要随机的元素类型
    
    参数:
    
    data - 随机集合
    
    weightFunction - 元素中权重方法
    
    num - 指定数量
    
    返回:
    
    按权重随机返回集合中的指定数量个元素

类 RandomUtils

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

RandomUtils

方法详细资料

nextBoolean

nextInt

nextInt

nextLong

nextLong

isSuccess

isSuccess

isSuccessByPercentage

isSuccessByPermillage

randomList

randomList

randomByWeight

randomByWeight

randomByWeight