Functions (autest - Gitee.com))

java.lang.Object
- com.auxiliary.datadriven.Functions

```
public class Functions
extends Object
```
文件名：Functions.java

用途： 提供部分默认的函数，在编写数据驱动时，可直接调用相应的方法

编码时间：2020年6月16日下午7:25:36

修改时间：2020年6月16日下午7:25:36

Version:

Ver1.0

Author:

彭宇琦

Constructor Summary

Constructors
Constructor and Description

Functions()

Constructors
Constructor and Description
`Functions()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static DataDriverFunction`	`addEmpty()` 定义标记当前元素为空元素
`static DataDriverFunction`	`getNowTime()` 定义对当前时间处理的函数
`static DataDriverFunction`	`getTime()` 定义对指定时间处理的函数
`static DataDriverFunction`	`randomCarId()` 定义生成随机随机车牌号码函数
`static DataDriverFunction`	`randomIdCard()` 定义生成随机18位长度的身份证信息函数
`static DataDriverFunction`	`randomMoble()` 定义生成随机手机号码函数
`static DataDriverFunction`	`randomName()` 定义生成随机姓名函数
`static DataDriverFunction`	`randomString()` 定义生成随机字符串函数
`static DataDriverFunction`	`randomWord()` 定义根据预设词语随机返回函数，该函数需要预先设定切分词语的标识符

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

- Constructor Detail
  - Functions
```
public Functions()
```
- Method Detail
  - randomString
```
public static DataDriverFunction randomString()
```
    定义生成随机字符串函数
    用法： ${rs(字符串种子,生成字符串最短长度,生成字符串最大长度)}
    
    参数解释：
    - 字符串种子：生成随机字符串的范围，该范围可自定义，也可以使用系统定义的特殊种子，包括 NUM（数字）、CAP（大写字母）、LOW（小写字母）、CH（中文）、AREA（区域缩写）、SURNAME（姓氏）；使用自定义种子时需要使用双引号标识，即传入"ASD"（表示只在ASD中生成随机字符串）
    - 生成字符串最短长度：最终生成的随机字符串的最短长度
    - 生成字符串最大长度：该字段可不传入，用于指定最终生成的随机字符串的最大长度
    示例：
    ${rs("qwertyuiop", 10, 20)}——表示生成“qwertyuiop”范围内，10~20位（随机）长度的随机字符串
    ${rs("qwertyuiop", 10)}——表示生成“qwertyuiop”范围内，10位长度的随机字符串
    ${rs(CH,10)}——表示生成中文（1000个不重复的中文）范围内，10位长度的随机字符串
    ${rs(num, 10,20)}——表示生成数字（0-9）范围内，10~20位（随机）长度的随机字符串
    
    注意：每个参数之间的分隔符号中允许存在一个空格，该空格可写可不写
    Returns:
    
    DataDriverFunction类对象
  - getTime
```
public static DataDriverFunction getTime()
```
    定义对指定时间处理的函数
    用法：${time(时间, 增减时间方式)}
    
    参数解释：
    - 时间：指定的时间，可传入年、月、日、时、分、秒，允许只传入“年、月、日”，也允许只传入“时、分、秒”。当只传入“年、月、日”时，表示当前日期的0时0分0秒；当只传入“时、分、秒”时，表示当天日期的时间；当传入完整的时间时，其“年、月、日”与“时、分、秒”之间用空格隔开。
      “年、月、日”之间，允许使用的分隔符有：年（或月或日）、“/”、“\”、“.”和“-”
      “时、分、秒”之间，允许使用的分隔符有：时（或分或秒）、“:”
    - 增减时间方式：指定对时间进行增减的方式，使用英文单位表示需要操作的内容，包括： y（年）、m（月）、w（周）、d（日）、h（小时）、s（秒）、min（分钟）。不带符号表示增加时间，带“-”符号表示减少时间，允许传入小数，允许使用连续式，每个单位之间没有顺序，允许一个单位传入多个（如“9d-2d-5m8y-3.66min”）
    示例：
    - ${time(2020-06-08 11:20:12, 1d)}——表示生成“2020-06-08 11:20:12”增加1天的时间
    - ${time(2020年06月08日 11时20分12秒, -1d2.3y)}——表示生成“2020年06月08日 11时20分12秒”减少一天并增加2.3年的时间
    - ${time(2020-06-08,1d)}——表示生成“2020-06-08 00:00:00”增加1天的时间
    - ${time(11:20:12, 1h)}——表示生成“当天11:20:12”增加1天的时间
    注意：计算小数点的日期时，可能存在精度丢失，计算跨度越大，精度丢失越多
    Returns:
    
    DataDriverFunction类对象
  - getNowTime
```
public static DataDriverFunction getNowTime()
```
    定义对当前时间处理的函数
    用法：${time(增减时间方式)}
    
    参数解释：
    - 增减时间方式：指定对时间进行增减的方式，使用英文单位表示需要操作的内容，包括： y（年）、m（月）、w（周）、d（日）、h（小时）、s（秒）、min（分钟）。不带符号表示增加时间，带“-”符号表示减少时间，允许传入小数，允许使用连续式，每个单位之间没有顺序，允许一个单位传入多个（如“9d-2d-5m8y-3.66min”）。该参数允许不传，当不传入该参数时返回为当前时间
    示例：
    - ${time(1d)}——表示生成当前时间增加1天的时间
    - ${time(-1d2.3y)}——表示生成当前时间减少一天并增加2.3年的时间
    - ${time()}——表示生成当前时间
    注意：计算小数点的日期时，可能存在精度丢失，计算跨度越大，精度丢失越多
    Returns:
    
    DataDriverFunction类对象
  - addEmpty
```
public static DataDriverFunction addEmpty()
```
    定义标记当前元素为空元素
    用法：${ }（花括号内存在一个空格）
    
    Returns:
    
    DataDriverFunction类对象
  - randomIdCard
```
public static DataDriverFunction randomIdCard()
```
    定义生成随机18位长度的身份证信息函数
    用法：${idcard}或${身份证}
    
    Returns:
    
    DataDriverFunction类对象
  - randomMoble
```
public static DataDriverFunction randomMoble()
```
    定义生成随机手机号码函数
    用法：${moble.运营商简写或名称}或${手机号码.运营商简写或名称}
    
    参数解释：
    - 运营商简写或名称：表示当前随机哪个运营商的手机号码段，支持中国移动（yd或移动）、中国联通（lt或联通）、中国电信（dx或电信）
    示例：
    - ${moble}或${mo}或${手机}或${手机号码}——表示生成中国移动号码段的随机手机号码
    - ${moble.联通}或${mo.联通}或${手机.联通}或${手机号码.联通}——表示生成中国联通号码段的随机手机号码
    - ${moble.dx}或${mo.dx}或${手机.dx}或${手机号码.dx}——表示生成中国电信号码段的随机手机号码
    注意：
    - “moble”可简写为“mo”，“手机号码”可简写为“手机”
    - 省略运营商简写或名称则默认为生成中国移动随机手机号码
    Returns:
    
    DataDriverFunction类对象
  - randomName
```
public static DataDriverFunction randomName()
```
    定义生成随机姓名函数
    用法：${name}或${姓名}
    
    Returns:
    
    DataDriverFunction类对象
  - randomCarId
```
public static DataDriverFunction randomCarId()
```
    定义生成随机随机车牌号码函数
    用法：${car.车牌简写或名称}或${车牌.车牌简写或名称}
    
    参数解释：
    - 车牌简写或名称：表示当前随机产生哪一类车牌，支持民用车牌（ci或民用）、警车车牌（po或警车）、大使馆车牌（el或使馆）、新能源车牌（en或新能源）
    示例：
    - ${car}或${车牌}——表示生成民用车牌
    - ${car.po}或${车牌.po}——表示生成警车车牌
    - ${car.新能源}或${车牌.新能源}——表示生成新能源车牌
    注意：省略车牌简写或名称则默认为生成民用车牌
    Returns:
    
    DataDriverFunction类对象
  - randomWord
```
public static DataDriverFunction randomWord()
```
    定义根据预设词语随机返回函数，该函数需要预先设定切分词语的标识符
    用法：${word(词语(,词语))}
    
    参数解释：
    - 词语：预设的词语范围，用于设定随机返回词语的范围
    示例：
    - ${word(in,out,stop)}——表示从词语in、out或者stop中随机返回一个词语
    注意：
    1. 括号中至少要存在一个词语，否则不会匹配
    2. 词语间分隔符为英文的逗号，在词语中请勿使用该符号
    Returns:
    
    DataDriverFunction类对象

Class Functions

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Functions

Method Detail

randomString

getTime

getNowTime

addEmpty

randomIdCard

randomMoble

randomName

randomCarId

randomWord