Класс 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 будет синхронизировать доступ к каждому применимому методу движка (см. SecureRandom для списка методов). Однако, если реализация SecureRandomSpi потокобезопасна, атрибут поставщика услуг "ThreadSafe" должен быть установлен в "true" во время его регистрации, следующим образом:

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

или

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

SecureRandom будет вызывать соответствующие методы движка без какой-либо синхронизации.

С:

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 дополняет, а не заменяет, существующее значение seed. Таким образом, повторные вызовы гарантированно никогда не уменьшат случайность.

Параметры:: 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)

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

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

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, 2021, 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/17/docs/api/java.base/java/security/SecureRandomSpi.html