Skip navigation links
com.auxiliary.tool.data

Class PresetString

    • Constructor Summary

      Constructors 
      Constructor and Description
      PresetString() 
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method and Description
      static String carLicence()
      该方法用于生成随机的民用车牌号
      static String carLicence(CarLicecenType carLicecenType)
      该方法用于生成一个指定样式的随机车牌
      static String createOrderlyText(String startChar, String endChar, int step)
      该方法用于根据指定的起始字符与结束字符,通过在StringMode中找到其字符对应的模型,之后按照顺序,根据指定的步长,截取模型对应的文本内容进行返回 根据字符查找模型的机制为,将字符与StringMode枚举中的所有模型进行对比,直到找到字符所在的模型为止,则存在以下几种情况: 获取到的起始模型与结束模型相同,且均能找到模型时,此时存在以下3种情况: 当起始字符与结束字符相同时,则返回该字符 当起始字符所在位置小于结束字符所在位置时,则按照模型顺序截取相应段落的字符串,例如,传入createOrderlyText("b", "d", 1),则返回“bcd” 当起始字符所在位置大于结束字符所在位置时,则将模型反序,再按照顺序截取相应段落的字符串,例如,传入createOrderlyText("d", "b", 1),则返回“dcb” 获取到的起始模型与结束模型不相同,且均能找到模型时,则截取起始字符所在模型从起始字符开始到模型末尾,再截取结束字符所在模型的开头到结束字符,将其拼接,例如,传入createOrderlyText("w", "3", 1),则返回“wxyz123” 当起始字符未找对应模型时,则获取模型字符串的第一位到结束下标的字符串,例如,传入createOrderlyText(";", "c", 1),则返回“abc” 当结束字符未找对应模型时,则获取模型字符串的起始字符到末尾的字符串,例如,传入createOrderlyText("x", ";", 1),则返回“xyz”
      static String createRandomGroupString(int minLength, int maxLength, String templet, List<RandomString> randomStringList)
      该方法用于根据指定的模板,和随机字符串的最小、最大生成长度,以及参与随机的随机字符串类对象集合,生成相应的随机字符串
      static String identityCard(String provinceCode, String cityCode, String zoneCode, int startAge, int endAge, int moon, int day, SexType sexType)
      该方法用于根据指定的参数,生成与参数匹配的随机身份证号
      static String mobleNumber(MobleNumberType mobleNumberType)
      根据运营商,生成相应运营商号段的随机号码
      static String name()
      生成姓名
      static String randomDecimals(String minNumText, String maxNumText)
      用于生成指定范围内的随机的小数
      static String randomNumber(int minNum, int maxNum, boolean isZeroize)
      用于生成一个指定范围内的数字,并根据条件进行前位数补0
    • Constructor Detail

      • PresetString

        public PresetString()
    • Method Detail

      • carLicence

        public static String carLicence()
        该方法用于生成随机的民用车牌号
        Returns:
        生成的车牌号字符串
      • carLicence

        public static String carLicence(CarLicecenType carLicecenType)
        该方法用于生成一个指定样式的随机车牌
        Parameters:
        carLicecenType - 车牌的样式
        Returns:
        生成的车牌号字符串
      • identityCard

        public static String identityCard(String provinceCode,
                                          String cityCode,
                                          String zoneCode,
                                          int startAge,
                                          int endAge,
                                          int moon,
                                          int day,
                                          SexType sexType)
        该方法用于根据指定的参数,生成与参数匹配的随机身份证号

        在生成随机身份证时,除性别枚举传入为null则默认为女性身份证外,其余参数在传入错误的值时,均在合理范围内随机生成一个参数,具体规则如下:

        • 行政区划代码:三个行政区划代码若传入空、null或错误的区划代码时,则在现有的参数文件中,随机查询一个行政区划。但需要注意的时,若指定了下级区划代码, 但上级随机的区划正好存在下级的区划代码时,则将生成其对应的区划,例如,当省级传入“32”,市级不传,而区级传入“11”时,若市级代码随机到“01”时, 则将生成区划代码为“320111”的身份证
        • 年龄段:传入年龄段后,则将在年龄段中随机生成一个年龄作为生日的年份,若起始年龄为小于1的数,则默认为18岁,若结束年龄小于1,则默认为65岁; 若传入的起始年龄大于结束年龄,则自动将其调换
        • 生日日期:月份若传入小于1,或大于12,则随机生成月份;日数若传入数值不合理时,则也在当前月份下随机一个日数
        • 性别枚举:若性别枚举为空,则随机产生一个性别数(传入性别枚举时亦是随机产生一个和该性别相应的随机数)

        注意:若行政区划为直辖市(例如北京市)或市级下无行政机构(例如新疆高昌区),则传入省份区划代码后,在市级行政区划代码传入4位的代码即可,例如,北京市朝阳区, 则省级代码传入“11”,市级代码传入“0105”,区级代码不用传

        Parameters:
        provinceCode - 省级行政区划代码
        cityCode - 市级行政区划代码
        zoneCode - 区、县级行政区划代码
        startAge - 随机年龄段起始年龄
        endAge - 随机年龄段结束年龄
        moon - 生日月份
        day - 生日日数
        sexType - 性别
        Returns:
        参数对应的随机身份证号
        Since:
        autest 4.5.0
      • name

        public static String name()
        生成姓名
        Returns:
        姓名
      • mobleNumber

        public static String mobleNumber(MobleNumberType mobleNumberType)
        根据运营商,生成相应运营商号段的随机号码
        Parameters:
        mobleNumberType - 运营商号段枚举
        Returns:
        相应运营商的随机号码
      • randomNumber

        public static String randomNumber(int minNum,
                                          int maxNum,
                                          boolean isZeroize)
        用于生成一个指定范围内的数字,并根据条件进行前位数补0

        例如,生成的数字为1,传入的最大值为12,并设置需要补0,则最终返回的结果为:01

        Parameters:
        minNum - 范围最小值
        maxNum - 范围最大值
        isZeroize - 是否需要高位补0
        Returns:
        生成的随机数字
      • randomDecimals

        public static String randomDecimals(String minNumText,
                                            String maxNumText)
        用于生成指定范围内的随机的小数

        该方法可根据传入的小数的位数,自动判断并生成相应位数的随机小数。

        注意:由于java中的double在传入整数或者最后一位是0的小数时,默认会将其转换为一位或 去0的处理,导致最终生成的精度不正确,为解决这一问题,故将传参使用字符串的形式代替

        Parameters:
        minNumText - 最小值文本
        maxNumText - 最大值文本
        Returns:
        生成的随机小数文本
      • createOrderlyText

        public static String createOrderlyText(String startChar,
                                               String endChar,
                                               int step)
        该方法用于根据指定的起始字符与结束字符,通过在StringMode中找到其字符对应的模型,之后按照顺序,根据指定的步长,截取模型对应的文本内容进行返回
          根据字符查找模型的机制为,将字符与StringMode枚举中的所有模型进行对比,直到找到字符所在的模型为止,则存在以下几种情况:
        • 获取到的起始模型与结束模型相同,且均能找到模型时,此时存在以下3种情况:
          1. 当起始字符与结束字符相同时,则返回该字符
          2. 当起始字符所在位置小于结束字符所在位置时,则按照模型顺序截取相应段落的字符串,例如,传入createOrderlyText("b", "d", 1),则返回“bcd”
          3. 当起始字符所在位置大于结束字符所在位置时,则将模型反序,再按照顺序截取相应段落的字符串,例如,传入createOrderlyText("d", "b", 1),则返回“dcb”
        • 获取到的起始模型与结束模型不相同,且均能找到模型时,则截取起始字符所在模型从起始字符开始到模型末尾,再截取结束字符所在模型的开头到结束字符,将其拼接,例如,传入createOrderlyText("w", "3", 1),则返回“wxyz123”
        • 当起始字符未找对应模型时,则获取模型字符串的第一位到结束下标的字符串,例如,传入createOrderlyText(";", "c", 1),则返回“abc”
        • 当结束字符未找对应模型时,则获取模型字符串的起始字符到末尾的字符串,例如,传入createOrderlyText("x", ";", 1),则返回“xyz”

        步长表示在截取到的字符串中,再取相应间隔的字符再次组成字符串,例如,传入createOrderlyText("1", "9", 2),则返回“13579”

        Parameters:
        startChar - 起始字符
        endChar - 结束字符
        step - 步长
        Returns:
        通过查找模型根据步长拼接的字符串
        Since:
        autest 3.5.0
      • createRandomGroupString

        public static String createRandomGroupString(int minLength,
                                                     int maxLength,
                                                     String templet,
                                                     List<RandomString> randomStringList)
        该方法用于根据指定的模板,和随机字符串的最小、最大生成长度,以及参与随机的随机字符串类对象集合,生成相应的随机字符串

        注意:

        1. 在传入最小与最大生成长度后,其会根据随机字符串类对象的默认长度再次进行判断,若随机字符串类对象的总默认最小生成长度大于传入的最小生成长度 (或者传入最大生成长度大于随机字符串类对象的总默认最大长度),则最终会以默认的总长度取值区间随机生成一个长度,特别的, 若传入的长度最大值小于总默认最小值(或长度最小值大于总默认长度最大值),则抛出异常
        2. 模板中替换随随机字符串的占位符为“%s”,其占位符号必须与传入的名称组数量对应,否则将会抛出异常(模板为空时则不进行判断)
        3. 模板中已存在的字符(除占位符)不被计入生成的随机字符串的长度中,若直接判断最终生成的长度,则可能会超出传入的长度区间,需要在传入时自行扣除相应的内容长度
        4. 当传入的最小或最大值小于1时,则表示该参数按照所有随机字符串的总默认值取

        Parameters:
        minLength - 随机字符串最小生成长度
        maxLength - 随机字符串最大生成长度
        templet - 模板
        randomStringList - 随机字符串类对象集合
        Returns:
        替换模板后的随机字符串组合
        Throws:
        IllegalDataException - 当名称组为空、名称未对应随机字符串类对象、名称组数量与模板占位符数量不符、传入的区间在随机字符串默认总区间外时抛出的异常
        Since:
        autest 4.3.0

Copyright © 2024. All rights reserved.