RandomObject (autest - Gitee.com))

java.lang.Object
- com.auxiliary.tool.data.RandomObject<T>

Type Parameters:

T - 随机对象的数据类型
```
public class RandomObject<T>
extends Object
```
文件名：RandomObject.java

用途： 提供根据对象池（随机对象获取的范围），随机返回池中对象的方法

编码时间：2021年1月13日下午12:49:02

修改时间：2021年1月13日下午12:49:02

Since:

JDK 1.8

Version:

Ver1.0

Author:

彭宇琦

Field Summary

Fields
Modifier and Type Field and Description

static String DEFAULT_NAME
定义默认对象池的名称

Fields
Modifier and Type	Field and Description
`static String`	`DEFAULT_NAME` 定义默认对象池的名称

Constructor Summary

Constructors
Constructor and Description

RandomObject()
构造对象

Constructors
Constructor and Description
`RandomObject()` 构造对象

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addObject(List<T> objList)` 用于向默认对象池中添加对象数据
`void`	`addObject(T... objs)` 用于向默认对象池中添加对象数据
`void`	`clear(String name)` 用于清除指定对象池的对象
`List<T>`	`getObjectSeed(String name)` 用于返回指定的对象池数据
`void`	`setRepeat(boolean isRepeat)` 是否允许在随机返回的对象中出现重复的对象
`int`	`size(String name)` 用于返回指定名称对象池中元素的个数
`Optional<T>`	`toObject()` 用于返回默认对象池中的一个对象的封装类对象。若默认对象池中无数据，则返回`Optional.empty()`
`List<Optional<T>>`	`toObject(int length)` 用于随机返回默认对象池中的指定个数的对象的封装类对象。若默认对象池中无数据，则返回`Optional.empty()`
`List<Optional<T>>`	`toObject(int minLength, int maxLength)` 用于在限定的个数范围内，随机返回默认对象池中的随机个对象的封装类对象。若默认对象池中无数据，则返回`Optional.empty()`，具体规则可参考`toObject(int)`方法

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

- Field Detail
  - DEFAULT_NAME
```
public static final String DEFAULT_NAME
```
    定义默认对象池的名称
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - RandomObject
```
public RandomObject()
```
    构造对象
- Method Detail
  - setRepeat
```
public void setRepeat(boolean isRepeat)
```
    是否允许在随机返回的对象中出现重复的对象
    注意：是否允许重复是相对于返回的对象而言，若添加到对象池时已存在重复，则在返回对象，即使设置不允许重复返回，在返回对象时也存在相同对象的可能
    
    Parameters:
    
    isRepeat - 是否允许出现重复对象
  - size
```
public int size(String name)
```
    用于返回指定名称对象池中元素的个数
    
    Parameters:
    
    name - 对象池名称
    
    Returns:
    
    对象池中对象个数
  - addObject
```
public void addObject(T... objs)
```
    用于向默认对象池中添加对象数据
    
    Parameters:
    
    objs - 对象组
  - addObject
```
public void addObject(List<T> objList)
```
    用于向默认对象池中添加对象数据
    
    Parameters:
    
    objList - 对象集合
  - clear
```
public void clear(String name)
```
    用于清除指定对象池的对象
    
    Parameters:
    
    name - 对象池名称
  - getObjectSeed
```
public List<T> getObjectSeed(String name)
```
    用于返回指定的对象池数据
    
    Parameters:
    
    name - 对象池名称
    
    Returns:
    
    对应的对象池数据
  - toObject
```
public Optional<T> toObject()
```
    用于返回默认对象池中的一个对象的封装类对象。若默认对象池中无数据，则返回Optional.empty()
    
    Returns:
    
    默认池中对象的封装类对象
  - toObject
```
public List<Optional<T>> toObject(int length)
```
    用于随机返回默认对象池中的指定个数的对象的封装类对象。若默认对象池中无数据，则返回Optional.empty()
    该方法会根据设置的对象是否允许重复，对对象进行返回。若设置允许重复，则返回的随机对象中同一个对象可能返回多次；反之，不会存在一个对象被返回多次的情况。
    
    注意：
    1. 若设置不允许重复，且需要返回的对象个数超出当前存储的对象个数时，则超出的部分用Optional.empty()代替
    2. 当传入的元素个数小于1时，则返回空集合
    Parameters:
    
    length - 对象返回个数
    
    Returns:
    
    指定个数的对象的封装类对象
  - toObject
```
public List<Optional<T>> toObject(int minLength,
                                  int maxLength)
```
    用于在限定的个数范围内，随机返回默认对象池中的随机个对象的封装类对象。若默认对象池中无数据，则返回Optional.empty()，具体规则可参考toObject(int)方法
    注意：
    1. 若传入的最多、最少个数相等，则等同于调用toObject(int)方法
    2. 若最少个数大于最多个数，则只按最少个数进行随机返回
    3. 若最少个数小于1，且最多个数不小于1，则最少个数按照1进行设置；反之，则返回空集合
    Parameters:
    
    minLength - 最少返回个数
    
    maxLength - 最多返回个数
    
    Returns:
    
    随机个数的对象的封装类对象

Class RandomObject<T>

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_NAME

Constructor Detail

RandomObject

Method Detail

setRepeat

size

addObject

addObject

clear

getObjectSeed

toObject

toObject

toObject