SecureRandomSpi  |  API reference  |  Android Developers (original) (raw)

abstract class SecureRandomSpi : Serializable

This class defines the Service Provider Interface (SPI) for the [SecureRandom](/reference/kotlin/java/security/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

SecureRandomSpi()

Constructor without a parameter.

Protected constructors

Public methods

toString

open fun toString(): String

Returns a Human-readable string representation of this SecureRandom.

Protected methods

engineGenerateSeed

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.

engineNextBytes

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.

engineNextBytes

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

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

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.

engineReseed

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()](/reference/kotlin/java/security/SecureRandom#reseed%28%29), params will be null.

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

engineSetSeed

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.