Module java.base
Package java.security.spec

Class EncodedKeySpec

java.lang.Object
java.security.spec.EncodedKeySpec
All Implemented Interfaces:
KeySpec
Direct Known Subclasses:
PKCS8EncodedKeySpec, X509EncodedKeySpec
public abstract class EncodedKeySpec extends Object implements KeySpec
This class represents a public or private key in encoded format.
Since:
1.2
See Also:

  • Constructor Details

    • EncodedKeySpec

      public EncodedKeySpec(byte[] encodedKey)
      Creates a new EncodedKeySpec with the given encoded key.
      Parameters:
      encodedKey - the encoded key. The contents of the array are copied to protect against subsequent modification.
      Throws:
      NullPointerException - if encodedKey is null.

    • EncodedKeySpec

      protected EncodedKeySpec(byte[] encodedKey, String algorithm)
      Creates a new EncodedKeySpec with the given encoded key. This constructor is useful when subsequent callers of the EncodedKeySpec object might not know the algorithm of the key.
      Parameters:
      encodedKey - the encoded key. The contents of the array are copied to protect against subsequent modification.
      algorithm - the algorithm name of the encoded key See the KeyFactory section in the Java Security Standard Algorithm Names Specification for information about standard algorithm names.
      Throws:
      NullPointerException - if encodedKey or algorithm is null.
      IllegalArgumentException - if algorithm is the empty string ""
      Since:
      9

  • Method Details

    • getAlgorithm

      public String getAlgorithm()
      Returns the name of the algorithm of the encoded key.
      Returns:
      the name of the algorithm, or null if not specified
      Since:
      9

    • getEncoded

      public byte[] getEncoded()
      Returns the encoded key.
      Returns:
      the encoded key. Returns a new array each time this method is called.

    • getFormat

      public abstract String getFormat()
      Returns the name of the encoding format associated with this key specification.

      If the opaque representation of a key (see Key) can be transformed (see KeyFactory) into this key specification (or a subclass of it), getFormat called on the opaque key returns the same value as the getFormat method of this key specification.

      Returns:
      a string representation of the encoding format.