Интерфейс RandomGenerator

public interface RandomGenerator

Интерфейс RandomGenerator предназначен для обеспечения общего протокола для объектов, генерирующих случайные или (в большинстве случаев) псевдослучайные последовательности чисел (или значений Boolean). Такую последовательность можно получить, либо повторно вызывая метод, возвращающий одно псевдослучайное значение, либо вызывая метод, возвращающий поток псевдослучайных значений.

В идеале, задав явно или неявно диапазон значений, каждое значение выбиралось бы независимо и равномерно из этого диапазона. На практике, может потребоваться удовлетвориться некоторым приближением к независимости и равномерности.

В случае значений типа int, long, и boolean, если диапазон не задан явно, то диапазон включает все возможные значения типа. В случае значений типа float и double сначала всегда выбирается значение равномерно из множества 2^w значений между 0.0 (включительно) и 1.0 (исключительно), где w равно 23 для значений типа float и 52 для значений типа double, таким образом, соседние значения отличаются на 2^−w (обратите внимание, что это множество является подмножеством множества всех представляемых значений с плавающей запятой между 0.0 (включительно) и 1.0 (исключительно)); затем, если явно задан диапазон, выбранное число вычисляется путем масштабирования и сдвига таким образом, чтобы оно выглядело примерно равномерно выбранным из этого явного диапазона.

Каждый метод, возвращающий поток, генерирует поток значений, каждый из которых выбирается таким же образом, как и для метода, возвращающего одно псевдослучайное значение. Например, если r реализует RandomGenerator, то вызов метода r.ints(100) возвращает поток из 100 значений int. Эти значения не обязательно будут точно такими же, как если бы r.nextInt() был вызван 100 раз; гарантируется только, что каждое значение в потоке выбирается аналогичным псевдослучайным способом из того же диапазона.

Предполагается, что каждый объект, реализующий интерфейс RandomGenerator с помощью псевдослучайного алгоритма, содержит конечное количество состояния. Использование такого объекта для генерации псевдослучайного значения изменяет его состояние, вычисляя новое состояние как функцию текущего состояния, без ссылки на какую-либо информацию, кроме текущего состояния. Число различных возможных состояний такого объекта называется его периодом. (Некоторые реализации интерфейса RandomGenerator могут быть истинно случайными, а не псевдослучайными, например, полагаясь на статистическое поведение физического объекта для получения выбранных значений. Такие реализации не имеют фиксированного периода.)

Как правило, объекты, реализующие интерфейс RandomGenerator, не требуют потокобезопасности. Рекомендуется, чтобы многопоточные приложения использовали либо ThreadLocalRandom, или (предпочтительно) генераторы псевдослучайных чисел, реализующие интерфейс RandomGenerator.SplittableGenerator или RandomGenerator.JumpableGenerator.

Объекты, реализующие RandomGenerator, обычно не являются криптографически безопасными. Вместо этого рассмотрите использование SecureRandom для получения криптографически безопасного генератора псевдослучайных чисел для использования в приложениях, чувствительных к безопасности. Обратите внимание, однако, что SecureRandom реализует интерфейс RandomGenerator, поэтому экземпляры SecureRandom можно использовать взаимозаменяемо с другими типами генераторов псевдослучайных чисел в приложениях, не требующих безопасного генератора.

Если не указано иное, использование null в качестве аргумента любого метода вызовет NullPointerException.