Класс SecureRandomSpi

java.lang.Object

java.security.SecureRandomSpi

Все реализуемые интерфейсы:: Serializable

public abstract class SecureRandomSpi extends Object implements Serializable

Этот класс определяет интерфейс поставщика сервисов (SPI) для класса SecureRandom.

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

Требования к реализации:

Если конструктор SecureRandomSpi(SecureRandomParameters) переопределяется в реализации, он всегда будет вызываться при создании экземпляра SecureRandom. Точнее, если объект создаётся с помощью одного из методов SecureRandom без параметра SecureRandomParameters, конструктор будет вызван с аргументом null, и реализация отвечает за создание собственного параметра SecureRandomParameters для использования при вызове engineGetParameters(). Если объект создаётся с помощью одного из методов SecureRandom с аргументом SecureRandomParameters, конструктор будет вызван с этим аргументом. Метод engineGetParameters() не должен возвращать null.

В противном случае, если конструктор SecureRandomSpi(SecureRandomParameters) не переопределяется в реализации, конструктор SecureRandomSpi() должен быть переопределён, и он будет вызван, если объект создаётся с помощью одного из методов SecureRandom без аргумента SecureRandomParameters. Вызов одного из методов SecureRandom с аргументом SecureRandomParameters никогда не вернёт экземпляр этой реализации. Метод engineGetParameters() должен возвращать null.

См. SecureRandom для получения дополнительной информации о потокобезопасности. По умолчанию реализация SecureRandomSpi не считается безопасной для использования в нескольких потоках одновременно, и SecureRandom будет синхронизировать доступ к каждому из соответствующих методов engine (см. SecureRandom для списка методов). Однако, если реализация SecureRandomSpi потокобезопасна, атрибут поставщика сервисов "ThreadSafe" должен быть установлен в "true" при его регистрации, как показано ниже:

 put("SecureRandom.AlgName ThreadSafe", "true");

или

 putService(new Service(this, "SecureRandom", "AlgName", className,
          null, Map.of("ThreadSafe", "true")));

SecureRandom будет вызывать соответствующие методы engine без синхронизации.

С тех пор:

1.2

См. также:

Краткое описание конструкторов

SecureRandomSpi()

SecureRandomSpi(SecureRandomParameters params)

Модификатор	Конструктор	Описание
	Конструктор без параметра.
`protected`	Конструктор с параметром.

Краткое описание методов

Модификатор и тип	Метод	Описание
`protected abstract byte[]`	`engineGenerateSeed(int numBytes)`	Возвращает заданное количество байтов.
`protected SecureRandomParameters`	`engineGetParameters()`	Возвращает эффективный `SecureRandomParameters` для данного экземпляра `SecureRandom`.
`protected abstract void`	`engineNextBytes(byte[] bytes)`	Генерирует заданное количество случайных байтов.
`protected void`	`engineNextBytes(byte[] bytes, SecureRandomParameters params)`	Генерирует заданное количество случайных байтов с дополнительными параметрами.
`protected void`	`engineReseed(SecureRandomParameters params)`	Переинициализирует этот объект случайных чисел с вводом энтропии, считанным из его источника энтропии с дополнительными параметрами.
`protected abstract void`	`engineSetSeed(byte[] seed)`	Переинициализирует этот объект случайных чисел с заданным значением.
`String`	`toString()`	Возвращает строковое представление этого объекта `SecureRandom`.

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание конструкторов

SecureRandomSpi

public SecureRandomSpi()

Конструктор без параметров.

SecureRandomSpi

protected SecureRandomSpi(SecureRandomParameters params)

Конструктор с параметром.

Параметры:: params - объект SecureRandomParameters. Этот аргумент может быть null.
Исключения:: IllegalArgumentException - если params не распознан или не поддерживается этим SecureRandom
С:: 9

Подробное описание методов

engineSetSeed

protected abstract void engineSetSeed(byte[] seed)

Переинициализирует этот объект генератора случайных чисел заданным значением. Значение-семя дополняет, а не заменяет существующее значение-семя. Таким образом, повторные вызовы гарантированно не уменьшают случайность.

Параметры:: seed - значение-семя.

engineNextBytes

protected abstract void engineNextBytes(byte[] bytes)

Генерирует указанное количество случайных байтов.

Некоторые генераторы случайных чисел могут генерировать только ограниченное количество случайных байтов за один вызов. Если размер bytes больше этого ограничения, реализация должна вызывать свой процесс генерации несколько раз, чтобы полностью заполнить буфер, прежде чем возвращаться из этого метода.

Параметры:: bytes - массив, который будет заполнен случайными байтами.

engineNextBytes

protected void engineNextBytes(byte[] bytes, SecureRandomParameters params)

Генерирует указанное количество случайных байтов с дополнительными параметрами.

Требования к реализации:: По умолчанию реализация выбрасывает UnsupportedOperationException.
Параметры:: bytes - массив для заполнения случайными байтами; params - дополнительные параметры
Исключения:: UnsupportedOperationException - если реализация не переопределила этот метод; IllegalArgumentException - если params null, некорректен или не поддерживается этим SecureRandom
С:: 9

engineGenerateSeed

protected abstract byte[] engineGenerateSeed(int numBytes)

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

Параметры:: numBytes - количество байтов-семян для генерации.
Возвращает:: байты-семя.

engineReseed

protected void engineReseed(SecureRandomParameters params)

Переинициализирует этот объект генератора случайных чисел с использованием входных данных энтропии, считанных из источника энтропии, с дополнительными параметрами.

Если этот метод вызывается методом SecureRandom.reseed(), params будет null.

Не переопределяйте этот метод, если реализация не поддерживает переинициализацию.

Требования к реализации:: По умолчанию реализация выбрасывает UnsupportedOperationException.
Параметры:: params - дополнительные параметры, могут быть null.
Исключения:: UnsupportedOperationException - если реализация не переопределила этот метод; IllegalArgumentException - если params некорректен или не поддерживается этим SecureRandom
С:: 9

engineGetParameters

protected SecureRandomParameters engineGetParameters()

Возвращает эффективные параметры SecureRandomParameters для этого экземпляра SecureRandom.

Требования к реализации:: По умолчанию реализация возвращает null.
Возвращает:: эффективные параметры SecureRandomParameters, или null если параметры не использовались.
С:: 9

toString

public String toString()

Возвращает удобочитаемое строковое представление этого объекта SecureRandom.

Переопределяет:: toString в классе Object
Возвращает:: строковое представление

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/security/SecureRandomSpi.html