1. /*

  2.  * @(#)SecureRandomSpi.java	1.7 00/02/02

  3.  *

  4.  * Copyright 1998-2000 Sun Microsystems, Inc. All Rights Reserved.

  5.  * 

  6.  * This software is the proprietary information of Sun Microsystems, Inc.  

  7.  * Use is subject to license terms.

  8.  * 

  9.  */

  10.  

  11. package java.security;

  12. 

  13. /**

  14.  * This class defines the <i>Service Provider Interface</i> (<b>SPI</b>)

  15.  * for the <code>SecureRandom</code> class.

  16.  * All the abstract methods in this class must be implemented by each

  17.  * service provider who wishes to supply the implementation

  18.  * of a cryptographically strong pseudo-random number generator.

  19.  *

  20.  * @version 1.7, 02/02/00

  21.  *

  22.  * @see SecureRandom

  23.  * @since 1.2

  24.  */

  25. 

  26. public abstract class SecureRandomSpi implements java.io.Serializable {

  27. 

  28.     /**

  29.      * Reseeds this random object. The given seed supplements, rather than

  30.      * replaces, the existing seed. Thus, repeated calls are guaranteed

  31.      * never to reduce randomness.

  32.      *

  33.      * @param seed the seed.

  34.      */

  35.     protected abstract void engineSetSeed(byte[] seed);

  36. 

  37.     /**

  38.      * Generates a user-specified number of random bytes.

  39.      * 

  40.      * @param bytes the array to be filled in with random bytes.

  41.      */

  42.     protected abstract void engineNextBytes(byte[] bytes);

  43. 

  44.     /**

  45.      * Returns the given number of seed bytes.  This call may be used to

  46.      * seed other random number generators.

  47.      *

  48.      * @param numBytes the number of seed bytes to generate.

  49.      * 

  50.      * @return the seed bytes.

  51.      */

  52.      protected abstract byte[] engineGenerateSeed(int numBytes);

  53. }