cn.featherfly.common.lang.RandomUtils Maven / Gradle / Ivy

Go to download

/*
 * Thgk-Component-Commons
 * 
 * created on May 20, 2010 2:58:26 PM
 */
package cn.featherfly.common.lang;

import java.util.ArrayList;
import java.util.List;
import java.util.Random;

/**
 * 
 * 随机生成工具类
 * 
 * @author 钟冀
 * @since 1.0
 * @version 1.0
 */
public final class RandomUtils {

    private RandomUtils() {
    }

    private static final int LETTER_NUMBER = 25;

    private static final int LOWERCASE_START = 97;

    private static final int UPPERCASE_START = 65;

    private static final int NUMBER = 10;

    private static final int NUMBER_START = 48;

    /**
     * 
     * 字符类型.
     * 
     */
    public static enum CharType {
        /**
         * lowerCase    小写字母
         */
        LOWER_CASE, 
        /**
         * upperCase    大写字母
         */
        UPPER_CASE,
        /**
         * numberCase    数字
         */
        NUMBER_CASE
    }
    private static Random random = new Random();
    /**
     * 使用单个 long 种子设置此随机数生成器的种子
     * @param seed 设置此随机数生成器的种子
     */
    public static void setSeed(long seed) {
        random.setSeed(seed);
    }
    /**
     * 随机返回一个字母(随机大小写）
     * @return 一个随机字母(随机大小写）
     */
    public static char getRandomLetter() {
        if (getRandomBoolean()) {
            return getRandomLetterLowerCase();
        } else {
            return getRandomLetterUpperCase();
        }
    }
    /**
     * 随机返回一个大写字母
     * @return 一个随机大写字母
     */
    public static char getRandomLetterUpperCase() {
        return (char) (random.nextInt(LETTER_NUMBER) + UPPERCASE_START);
    }
    /**
     * 随机返回一个小写字母
     * @return 一个随机小写字母
     */
    public static char getRandomLetterLowerCase() {
        return (char) (random.nextInt(LETTER_NUMBER) + LOWERCASE_START);
    }
    /**
     * 随机返回一个数字，（0-9）
     * @return 一个随机数字，（0-9）
     */
    public static char getRandomNumber() {
        return (char) (random.nextInt(NUMBER) + NUMBER_START);
    }
    /**
     * 随机返回一个字符（大小写字母，数字0-9)
     * @return  一个随机字符（大小写字母，数字0-9)
     */
    public static char getRandomWord() {
        final int type = 3;
        int sign = random.nextInt(type);
        if (sign == 0) {
            return getRandomNumber();
        } else if (sign == 1) {
            return getRandomLetterLowerCase();
        } else {
            return getRandomLetterUpperCase();
        }
    }
    /**
     * 随机返回一个布尔值
     * @return 一个随机布尔值
     */
    public static boolean getRandomBoolean() {
        return random.nextBoolean();
    }
    /**
     * 随机返回一个整数
     * @return 一个随机整数
     */
    public static int getRandomInt() {
        return random.nextInt();
    }
    /**
     * 返回一个不大于max的随机整数
     * @param max 返回随机整数的最大边界值（大于返回的数）
     * @return 整数，0<=返回值 signList = new ArrayList();
        for (int i = 0; i < signTemp.length; i++) {
            if (signTemp[i]) {
                signList.add(i);
            }
        }
        // 传入了字符类型，随机按传入的类型返回
        if (signList.size() > 0) {
            for (int i = 0; i < length; i++) {
                int signIndex = random.nextInt(signList.size());
                int index = signList.get(signIndex);
                if (index == 0) {
                    result.append(getRandomLetterLowerCase());
                } else if (index == 1) {
                    result.append(getRandomLetterUpperCase());
                } else {
                    result.append(getRandomNumber());
                }
            }
        } else {
            // 没有传入任何类型，返回大小写以及数字
            for (int i = 0; i < length; i++) {
                result.append(getRandomWord());
            }
        }
        return result.toString();
    }

    /**
     * 
     * 以给定的列表为源，随机抽取其中一个元素返回
     * 
     * @param  集合内的对象类型
     * @param source 随机对象选取的源对象
     * @return 随机选择的对象
     */
    public static  T getRandom(List source) {
        checkSource(source);
        int index = getRandomInt(source.size());
        return source.get(index);
    }
    /**
     * 
     * 以给定的列表为源，随机抽取其中一个元素返回
     * 
     * @param  集合内的对象类型
     * @param source 随机对象选取的源对象
     * @param length 返回字符串的长度
     * @return 随机选择的对象
     */
    public static  String getRandomString(List source, int length) {
        checkSource(source);
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < length; i++) {
            int index = getRandomInt(source.size());
            sb.append(source.get(index));
        }
        return sb.toString();
    }

    // ********************************************************************
    //    private method
    // ********************************************************************

    //检查源
    private static  void checkSource(List source) {
        AssertIllegalArgument.isNotEmpty(source, "给定的源列表不能为null且长度必须大于0");
    }
}