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 Summary

EncodedKeySpec(byte[] encodedKey)

EncodedKeySpec(byte[] encodedKey,
 String algorithm)

Modifier	Constructor	Description
	Creates a new `EncodedKeySpec` with the given encoded key.
`protected`	Creates a new `EncodedKeySpec` with the given encoded key.

Method Summary

Modifier and Type	Method	Description
`String`	`getAlgorithm()`	Returns the name of the algorithm of the encoded key.
`byte[]`	`getEncoded()`	Returns the encoded key.
`abstract String`	`getFormat()`	Returns the name of the encoding format associated with this key specification.

Methods declared in class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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 AsymmetricKey Algorithms section in the Java Security Standard Algorithm Names Specification for information about standard asymmetric key algorithm names.

Throws:

NullPointerException - if encodedKey or algorithm is null.

IllegalArgumentException - if algorithm is the empty string ""

Since:

External Specifications

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.

© 1993, 2025, 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/25/docs/api/java.base/java/security/spec/EncodedKeySpec.html