Класс ThreadLocalRandom

Генератор псевдослучайных чисел, изолированный в текущей потоке. Как и глобальный Random генератор, используемый классом Math, экземпляр ThreadLocalRandom инициализируется внутренне сгенерированным значением, которое нельзя изменить. В многопоточных программах, где это возможно, использование ThreadLocalRandom вместо общих Random объектов обычно приводит к значительно меньшему накладным расходам и конкуренции. Использование ThreadLocalRandom особенно уместно, когда несколько задач (например, каждая — ForkJoinTask) используют случайные числа в параллельных потоках пулов.

Обычно использование этого класса должно иметь вид: ThreadLocalRandom.current().nextX(...) (где X — это Int, Long, и т.д.). Когда все обращения имеют такой вид, то случайным образом сгенерированные числа ThreadLocalRandom никогда не могут быть случайно разделены между несколькими потоками.

Этот класс также предоставляет дополнительные часто используемые методы для ограниченной генерации случайных чисел.

Экземпляры ThreadLocalRandom не являются криптографически безопасными. В приложениях, чувствительных к безопасности, следует использовать SecureRandom. Кроме того, экземпляры, сконструированные по умолчанию, не используют криптографически случайное значение, если системная переменная java.util.secureRandomSeed не установлена в значение true.

Методы

current

public static ThreadLocalRandom current()

Возвращает текущую нить ThreadLocalRandom.

Возвращает:

текущую нить ThreadLocalRandom

setSeed

public void setSeed(long seed)

Бросает UnsupportedOperationException. Установка семян в этом генераторе не поддерживается.

Переопределяет:

setSeed в классе Random

Параметры:

seed - начальное семя

Бросает:

UnsupportedOperationException - всегда

next

protected int next(int bits)

Описание скопировано из класса: Random

(seed * 0x5DEECE66DL + 0xBL) & ((1L << 48) - 1)

(int)(seed >>> (48 - bits)).

Переопределяет:

next в классе Random

Параметры:

bits - случайные биты

Возвращает:

следующее псевдослучайное значение из последовательности этого генератора псевдослучайных чисел

nextInt

public int nextInt()

Возвращает псевдослучайное значение int.

Переопределяет:

nextInt в классе Random

Возвращает:

псевдослучайное значение int

nextInt

public int nextInt(int bound)

Возвращает псевдослучайное целое значение между нулем (включительно) и заданной границей (исключительно).

Переопределяет:

nextInt в классе Random

Параметры:

bound - верхняя граница (исключая). Должно быть положительным.

Возвращает:

псевдослучайное целое значение между нулем (включительно) и границей (исключая)

Бросает:

IllegalArgumentException - если bound не положительно

nextInt

public int nextInt(int origin,
                   int bound)

Возвращает псевдослучайное целое значение между указанным началом (включительно) и заданной границей (исключая).

Параметры:

origin - наименьшее возвращаемое значение

bound - верхняя граница (исключая)

Возвращает:

псевдослучайное целое значение между началом (включительно) и границей (исключая)

Бросает:

IllegalArgumentException - если origin больше или равно bound

nextLong

public long nextLong()

Возвращает псевдослучайное значение long.

Переопределяет:

nextLong в классе Random

Возвращает:

псевдослучайное значение long

nextLong

public long nextLong(long bound)

Возвращает псевдослучайное значение long между нулем (включительно) и заданной границей (исключая).

Параметры:

bound - верхняя граница (исключая). Должно быть положительным.

Возвращает:

псевдослучайное значение long между нулем (включительно) и границей (исключая)

Бросает:

IllegalArgumentException - если bound не положительно

nextLong

public long nextLong(long origin,
                     long bound)

Возвращает псевдослучайное значение long между указанным началом (включительно) и заданной границей (исключая).

Параметры:

origin - наименьшее возвращаемое значение

bound - верхняя граница (исключая)

Возвращает:

псевдослучайное значение long между началом (включительно) и границей (исключая)

Бросает:

IllegalArgumentException - если origin больше или равно bound

nextDouble

public double nextDouble()

Возвращает псевдослучайное значение с плавающей точкой между нулем (включительно) и единицей (исключительно).

Переопределяет:

nextDouble в классе Random

Возвращает:

псевдослучайное значение с плавающей точкой между нулем (включительно) и единицей (исключительно)

См. также:

Math.random()

nextDouble

public double nextDouble(double bound)

Возвращает псевдослучайное значение с плавающей точкой между 0,0 (включительно) и указанной границей (исключительно).

Параметры:

bound - верхняя граница (исключая). Должно быть положительным.

Возвращает:

псевдослучайное значение с плавающей точкой между нулем (включительно) и границей (исключая)

Бросает:

IllegalArgumentException - если bound не положительно

nextDouble

public double nextDouble(double origin,
                         double bound)

Возвращает псевдослучайное значение с плавающей точкой между указанным началом (включительно) и границей (исключая).

Параметры:

origin - наименьшее возвращаемое значение

bound - верхняя граница (исключая)

Возвращает:

псевдослучайное значение с плавающей точкой между началом (включительно) и границей (исключая)

Бросает:

IllegalArgumentException - если origin больше или равно bound

nextBoolean

public boolean nextBoolean()

Возвращает псевдослучайное булево значение.

Переопределяет:

nextBoolean в классе Random

Возвращает:

псевдослучайное булево значение

nextFloat

public float nextFloat()

Возвращает псевдослучайное значение с плавающей точкой между нулем (включительно) и единицей (исключительно).

Переопределяет:

nextFloat в классе Random

Возвращает:

псевдослучайное значение с плавающей точкой между нулем (включительно) и единицей (исключительно)

nextGaussian

public double nextGaussian()

Описание скопировано из класса: Random

private double nextNextGaussian;
 private boolean haveNextNextGaussian = false;

 public double nextGaussian() {
   if (haveNextNextGaussian) {
     haveNextNextGaussian = false;
     return nextNextGaussian;
   } else {
     double v1, v2, s;
     do {
       v1 = 2 * nextDouble() - 1;   // between -1.0 and 1.0
       v2 = 2 * nextDouble() - 1;   // between -1.0 and 1.0
       s = v1 * v1 + v2 * v2;
     } while (s >= 1 || s == 0);
     double multiplier = StrictMath.sqrt(-2 * StrictMath.log(s)/s);
     nextNextGaussian = v2 * multiplier;
     haveNextNextGaussian = true;
     return v1 * multiplier;
   }
 }

Переопределяет:

nextGaussian в классе Random

Возвращает:

следующее псевдослучайное гауссово («нормальное») распределение double со средним значением 0.0 и стандартным отклонением 1.0 из последовательности этого генератора псевдослучайных чисел

ints

public IntStream ints(long streamSize)

Возвращает поток, генерирующий заданное количество streamSize псевдослучайных int значений.

Переопределяет:

ints в классе Random

Параметры:

streamSize - количество генерируемых значений

Возвращает:

поток псевдослучайных int значений

Бросает:

IllegalArgumentException - если streamSize меньше нуля

С:

1.8

ints

public IntStream ints()

Возвращает эффективно неограниченный поток псевдослучайных int значений.

Переопределяет:

ints в классе Random

Примечание к реализации:

Этот метод реализован для эквивалентности ints(Long.MAX_VALUE).

Возвращает:

поток псевдослучайных int значений

С:

1.8

ints

public IntStream ints(long streamSize,
                      int randomNumberOrigin,
                      int randomNumberBound)

Возвращает поток, генерирующий заданное количество streamSize псевдослучайных int значений, каждое из которых соответствует заданному началу (включительно) и границе (исключая).

Переопределяет:

ints в классе Random

Параметры:

streamSize - количество генерируемых значений

randomNumberOrigin - начало (включительно) каждого случайного значения

randomNumberBound - граница (исключая) каждого случайного значения

Возвращает:

поток псевдослучайных int значений, каждое с заданным началом (включительно) и границей (исключая)

Бросает:

IllegalArgumentException - если streamSize меньше нуля или randomNumberOrigin больше или равно randomNumberBound

С:

1.8

ints

public IntStream ints(int randomNumberOrigin,
                      int randomNumberBound)

Возвращает эффективно неограниченный поток псевдослучайных int значений, каждое из которых соответствует заданному началу (включительно) и границе (исключая).

Overrides:

ints в классе Random

Implementation Note:

Этот метод реализован так, чтобы быть эквивалентным ints(Long.MAX_VALUE, randomNumberOrigin, randomNumberBound).

Parameters:

randomNumberOrigin — начало (включительно) каждого случайного значения

randomNumberBound — граница (исключительно) каждого случайного значения

Returns:

поток псевдослучайных int значений, каждое с заданным началом (включительно) и границей (исключительно)

Throws:

IllegalArgumentException — если randomNumberOrigin больше или равно randomNumberBound

Since:

1.8

longs

public LongStream longs(long streamSize)

Возвращает поток, генерирующий заданное количество псевдослучайных streamSize значений.

Overrides:

longs в классе Random

Parameters:

streamSize — количество значений для генерации

Returns:

поток псевдослучайных long значений

Throws:

IllegalArgumentException — если streamSize меньше нуля

Since:

1.8

longs

public LongStream longs()

Возвращает эффективно неограниченный поток псевдослучайных long значений.

Overrides:

longs в классе Random

Implementation Note:

Этот метод реализован так, чтобы быть эквивалентным longs(Long.MAX_VALUE).

Returns:

поток псевдослучайных long значений

Since:

1.8

longs

public LongStream longs(long streamSize,
                        long randomNumberOrigin,
                        long randomNumberBound)

Возвращает поток, генерирующий заданное количество псевдослучайных streamSize значений, каждое из которых соответствует заданному началу (включительно) и границе (исключительно).

Overrides:

longs в классе Random

Parameters:

streamSize — количество значений для генерации

randomNumberOrigin — начало (включительно) каждого случайного значения

randomNumberBound — граница (исключительно) каждого случайного значения

Returns:

поток псевдослучайных long значений, каждое с заданным началом (включительно) и границей (исключительно)

Throws:

IllegalArgumentException — если streamSize меньше нуля или randomNumberOrigin больше или равно randomNumberBound

Since:

1.8

longs

public LongStream longs(long randomNumberOrigin,
                        long randomNumberBound)

Возвращает эффективно неограниченный поток псевдослучайных long значений, каждое из которых соответствует заданному началу (включительно) и границе (исключительно).

Overrides:

longs в классе Random

Implementation Note:

Этот метод реализован так, чтобы быть эквивалентным longs(Long.MAX_VALUE, randomNumberOrigin, randomNumberBound).

Parameters:

randomNumberOrigin — начало (включительно) каждого случайного значения

randomNumberBound — граница (исключительно) каждого случайного значения

Returns:

поток псевдослучайных long значений, каждое с заданным началом (включительно) и границей (исключительно)

Throws:

IllegalArgumentException — если randomNumberOrigin больше или равно randomNumberBound

Since:

1.8

doubles

public DoubleStream doubles(long streamSize)

Возвращает поток, генерирующий заданное количество псевдослучайных streamSize значений, каждое между нулём (включительно) и единицей (исключительно).

Overrides:

doubles в классе Random

Parameters:

streamSize — количество значений для генерации

Returns:

поток double значений

Throws:

IllegalArgumentException — если streamSize меньше нуля

Since:

1.8

doubles

public DoubleStream doubles()

Возвращает эффективно неограниченный поток псевдослучайных double значений, каждое между нулём (включительно) и единицей (исключительно).

Overrides:

doubles в классе Random

Implementation Note:

Этот метод реализован так, чтобы быть эквивалентным doubles(Long.MAX_VALUE).

Returns:

поток псевдослучайных double значений

Since:

1.8

doubles

public DoubleStream doubles(long streamSize,
                            double randomNumberOrigin,
                            double randomNumberBound)

Возвращает поток, генерирующий заданное количество псевдослучайных streamSize значений, каждое из которых соответствует заданному началу (включительно) и границе (исключительно).

Overrides:

doubles в классе Random

Parameters:

streamSize — количество значений для генерации

randomNumberOrigin — начало (включительно) каждого случайного значения

randomNumberBound — граница (исключительно) каждого случайного значения

Returns:

поток псевдослучайных double значений, каждое с заданным началом (включительно) и границей (исключительно)

Throws:

IllegalArgumentException — если streamSize меньше нуля

IllegalArgumentException — если randomNumberOrigin больше или равно randomNumberBound

Since:

1.8

doubles

public DoubleStream doubles(double randomNumberOrigin,
                            double randomNumberBound)

Возвращает эффективно неограниченный поток псевдослучайных double значений, каждое из которых соответствует заданному началу (включительно) и границе (исключительно).

Overrides:

doubles в классе Random

Implementation Note:

Этот метод реализован так, чтобы быть эквивалентным doubles(Long.MAX_VALUE, randomNumberOrigin, randomNumberBound).

Parameters:

randomNumberOrigin — начало (включительно) каждого случайного значения

randomNumberBound — граница (исключительно) каждого случайного значения

Returns:

поток псевдослучайных double значений, каждое с заданным началом (включительно) и границей (исключительно)

Throws:

IllegalArgumentException — если randomNumberOrigin больше или равно randomNumberBound

Since:

1.8