Added in API level 1

SecureRandomSpi

abstract class SecureRandomSpi : Serializable

kotlin.Any
↳	java.security.SecureRandomSpi

This class defines the Service Provider Interface (SPI) for the SecureRandom class.

All the abstract methods in this class must be implemented by each service provider who wishes to supply the implementation of a cryptographically strong pseudo-random number generator.

Summary

Public constructors
`SecureRandomSpi()` Constructor without a parameter.

Protected constructors
`SecureRandomSpi(params: SecureRandomParameters!)` Constructor with a parameter.

Public methods
open String	`toString()` Returns a Human-readable string representation of this `SecureRandom`.

Protected methods
abstract ByteArray!	`engineGenerateSeed(numBytes: Int)` Returns the given number of seed bytes.
open SecureRandomParameters!	`engineGetParameters()` Returns the effective `SecureRandomParameters` for this `SecureRandom` instance.
abstract Unit	`engineNextBytes(bytes: ByteArray!)` Generates a user-specified number of random bytes.
open Unit	`engineNextBytes(bytes: ByteArray!, params: SecureRandomParameters!)` Generates a user-specified number of random bytes with additional parameters.
open Unit	`engineReseed(params: SecureRandomParameters!)` Reseeds this random object with entropy input read from its entropy source with additional parameters.
abstract Unit	`engineSetSeed(seed: ByteArray!)` Reseeds this random object with the given seed.

Public constructors

SecureRandomSpi

Added in API level 1

SecureRandomSpi()

Constructor without a parameter.

Protected constructors

SecureRandomSpi

Added in API level 35

protected SecureRandomSpi(params: SecureRandomParameters!)

Constructor with a parameter.

Parameters
`params`	SecureRandomParameters!: the `SecureRandomParameters` object. This argument can be `null`.

Exceptions
`java.lang.IllegalArgumentException`	if `params` is unrecognizable or unsupported by this `SecureRandom`

Public methods

toString

Added in API level 1

open fun toString(): String

Returns a Human-readable string representation of this SecureRandom.

Return
`String`	the string representation

Protected methods

engineGenerateSeed

Added in API level 1

protected abstract fun engineGenerateSeed(numBytes: Int): ByteArray!

Returns the given number of seed bytes. This call may be used to seed other random number generators.

Parameters
`numBytes`	Int: the number of seed bytes to generate.

Return
`ByteArray!`	the seed bytes.

engineGetParameters

Added in API level 35

protected open fun engineGetParameters(): SecureRandomParameters!

Returns the effective SecureRandomParameters for this SecureRandom instance.

Return
`SecureRandomParameters!`	the effective `SecureRandomParameters` parameters, or `null` if no parameters were used.

engineNextBytes

Added in API level 1

protected abstract fun engineNextBytes(bytes: ByteArray!): Unit

Generates a user-specified number of random bytes.

Some random number generators can only generate a limited amount of random bytes per invocation. If the size of bytes is greater than this limit, the implementation should invoke its generation process multiple times to completely fill the buffer before returning from this method.

Parameters
`bytes`	ByteArray!: the array to be filled in with random bytes.

engineNextBytes

Added in API level 35

protected open fun engineNextBytes(
    bytes: ByteArray!, 
    params: SecureRandomParameters!
): Unit

Generates a user-specified number of random bytes with additional parameters.

Parameters
`bytes`	ByteArray!: the array to be filled in with random bytes
`params`	SecureRandomParameters!: additional parameters

Exceptions
`java.lang.UnsupportedOperationException`	if the implementation has not overridden this method
`java.lang.IllegalArgumentException`	if `params` is `null`, illegal or unsupported by this `SecureRandom`

engineReseed

Added in API level 35

protected open fun engineReseed(params: SecureRandomParameters!): Unit

Reseeds this random object with entropy input read from its entropy source with additional parameters.

If this method is called by SecureRandom.reseed(), params will be null.

Do not override this method if the implementation does not support reseeding.

Parameters
`params`	SecureRandomParameters!: extra parameters, can be `null`.

Exceptions
`java.lang.UnsupportedOperationException`	if the implementation has not overridden this method
`java.lang.IllegalArgumentException`	if `params` is illegal or unsupported by this `SecureRandom`

engineSetSeed

Added in API level 1

protected abstract fun engineSetSeed(seed: ByteArray!): Unit

Reseeds this random object with the given seed. The seed supplements, rather than replaces, the existing seed. Thus, repeated calls are guaranteed never to reduce randomness.

Parameters
`seed`	ByteArray!: the seed.