RandomUtils.java

package com.osroyale.util;
 
import java.util.Arrays;
import java.util.List;
import java.util.Random;
import java.util.concurrent.ThreadLocalRandom;
 
import static com.google.common.base.Preconditions.checkArgument;

 
* A static-util class that provides additional functionality for generating pseudo-random numbers. All functions in this
 * class are backed by {@link ThreadLocalRandom} rather than the more commonly used {@link Random}. It is generally preferred
 * to use this over {@code Random} because although {@code Random} is thread safe; the same seed is shared concurrently,
 * which leads to contention between multiple threads and overhead as a result. Surprisingly because of the way that {@code
 * ThreadLocalRandom} works, even in completely single-threaded situations it runs up to three times faster than {@code
 * Random}.
 *
 * @author lare96 <http://github.com/lare96>
 * @see <a href= "http://java-performance.info/java-util-random-java-util-concurrent-threadlocalrandom-multithreaded-environments/"
 * >java.util.Random and java.util.concurrent.ThreadLocalRandom in multithreaded environments</a>
 */
public final class RandomUtils {

    private RandomUtils() {
    }

    public static boolean nextBoolean() {
        return ThreadLocalRandom.current().nextBoolean();
    }

    public static double nextDouble() {
        return ThreadLocalRandom.current().nextDouble();
    }

    public static float floatRandom(float range) {
        if (range < 0F)
            throw new IllegalArgumentException("range <= 0");
        return ThreadLocalRandom.current().nextFloat() * range;
    }

    public static int inclusive(int min, int max) {
        if (min == max)
            return min;
        checkArgument(max >= min, "max < min");
        return ThreadLocalRandom.current().nextInt((max - min) + 1) + min;
    }

    public static double inclusive(double min, double max) {
        if (min == max)
            return min;
        checkArgument(max >= min, "max < min");
        return ThreadLocalRandom.current().nextDouble(max - min) + min;
    }

    public static int inclusive(int range) {
        return inclusive(0, range);
    }

    public static <T> T random(T[] array) {
        return array[(int) (ThreadLocalRandom.current().nextDouble() * array.length)];
    }

    public static int random(int... array) {
        return array[(int) (ThreadLocalRandom.current().nextDouble() * array.length)];
    }

    public static long random(long... array) {
        return array[(int) (ThreadLocalRandom.current().nextDouble() * array.length)];
    }

    public static double random(double... array) {
        return array[(int) (ThreadLocalRandom.current().nextDouble() * array.length)];
    }

    public static short random(short... array) {
        return array[(int) (ThreadLocalRandom.current().nextDouble() * array.length)];
    }

    public static byte random(byte... array) {
        return array[(int) (ThreadLocalRandom.current().nextDouble() * array.length)];
    }

    public static float random(float... array) {
        return array[(int) (ThreadLocalRandom.current().nextDouble() * array.length)];
    }

    public static boolean random(boolean... array) {
        return array[(int) (ThreadLocalRandom.current().nextDouble() * array.length)];
    }

    public static char random(char... array) {
        return array[(int) (ThreadLocalRandom.current().nextDouble() * array.length)];
    }

    public static <T> T random(List<T> list) {
        if (list.isEmpty()) return null;
        return list.get((int) (ThreadLocalRandom.current().nextDouble() * list.size()));
    }

    public static <T> T[] shuffle(T[] array) {
        for (int i = array.length - 1; i > 0; i--) {
            int index = ThreadLocalRandom.current().nextInt(i + 1);
            T a = array[index];
            array[index] = array[i];
            array[i] = a;
        }
        return array;
    }

    public static int[] shuffle(int[] array) {
        for (int i = array.length - 1; i > 0; i--) {
            int index = ThreadLocalRandom.current().nextInt(i + 1);
            int a = array[index];
            array[index] = array[i];
            array[i] = a;
        }
        return array;
    }

    public static long[] shuffle(long[] array) {
        for (int i = array.length - 1; i > 0; i--) {
            int index = ThreadLocalRandom.current().nextInt(i + 1);
            long a = array[index];
            array[index] = array[i];
            array[i] = a;
        }
        return array;
    }

    public static double[] shuffle(double[] array) {
        for (int i = array.length - 1; i > 0; i--) {
            int index = ThreadLocalRandom.current().nextInt(i + 1);
            double a = array[index];
            array[index] = array[i];
            array[i] = a;
        }
        return array;
    }

    public static short[] shuffle(short[] array) {
        for (int i = array.length - 1; i > 0; i--) {
            int index = ThreadLocalRandom.current().nextInt(i + 1);
            short a = array[index];
            array[index] = array[i];
            array[i] = a;
        }
        return array;
    }

    public static byte[] shuffle(byte[] array) {
        for (int i = array.length - 1; i > 0; i--) {
            int index = ThreadLocalRandom.current().nextInt(i + 1);
            byte a = array[index];
            array[index] = array[i];
            array[i] = a;
        }
        return array;
    }

    public static float[] shuffle(float[] array) {
        for (int i = array.length - 1; i > 0; i--) {
            int index = ThreadLocalRandom.current().nextInt(i + 1);
            float a = array[index];
            array[index] = array[i];
            array[i] = a;
        }
        return array;
    }

    public static boolean[] shuffle(boolean[] array) {
        for (int i = array.length - 1; i > 0; i--) {
            int index = ThreadLocalRandom.current().nextInt(i + 1);
            boolean a = array[index];
            array[index] = array[i];
            array[i] = a;
        }
        return array;
    }

    public static char[] shuffle(char[] array) {
        for (int i = array.length - 1; i > 0; i--) {
            int index = ThreadLocalRandom.current().nextInt(i + 1);
            char a = array[index];
            array[index] = array[i];
            array[i] = a;
        }
        return array;
    }

    public static int inclusiveExcludes(int min, int max, int... exclude) {
        Arrays.sort(exclude);
 
        int result = inclusive(min, max);
        while (Arrays.binarySearch(exclude, result) >= 0) {
            result = inclusive(min, max);
        }
 
        return result;
    }

    public static <T> T randomExclude(T[] array, T exclude) {
        T result = random(array);
        while (exclude.equals(result))
            result = random(array);
        return result;
    }

    public static boolean success(double value) {
        return value >= 1.00 || ThreadLocalRandom.current().nextDouble() <= value;
    }
 
}