Class KeyStore.PrivateKeyEntry

java.lang.Object

java.security.KeyStore.PrivateKeyEntry

All Implemented Interfaces:

KeyStore.Entry

Enclosing class:

KeyStore

public static final class KeyStore.PrivateKeyEntry
extends Object
implements KeyStore.Entry

A KeyStore entry that holds a PrivateKey and corresponding certificate chain.

Since:

1.5

Nested Class Summary

Nested classes/interfaces declared in interface KeyStore.Entry

KeyStore.Entry.Attribute

Modifier and Type	Interface	Description
static interface	KeyStore.Entry.Attribute	An attribute associated with a keystore entry.

Constructor Summary

Constructors

Constructor	Description
PrivateKeyEntry(PrivateKey privateKey, Certificate[] chain)	Constructs a PrivateKeyEntry with a PrivateKey and corresponding certificate chain.
PrivateKeyEntry(PrivateKey privateKey, Certificate[] chain, Set<KeyStore.Entry.Attribute> attributes)	Constructs a PrivateKeyEntry with a PrivateKey and corresponding certificate chain and associated entry attributes.

Method Summary

Modifier and Type	Method	Description
Set<KeyStore.Entry.Attribute>	getAttributes()	Retrieves the attributes associated with an entry.
Certificate	getCertificate()	Gets the end entity Certificate from the certificate chain in this entry.
Certificate[]	getCertificateChain()	Gets the Certificate chain from this entry.
PrivateKey	getPrivateKey()	Gets the PrivateKey from this entry.
String	toString()	Returns a string representation of this PrivateKeyEntry.

Methods declared in class Object

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

Modifier and Type	Method	Description
protected Object	clone()	Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
boolean	equals(Object o)	Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
protected void	finalize()	Deprecated, for removal: This API element is subject to removal in a future version. May cause performance issues, deadlocks and hangs.
final Class<? extends Object>	getClass()	Answers the unique instance of java.lang.Class which represents the class of the receiver.
int	hashCode()	Answers an integer hash code for the receiver.
final void	notify()	Causes one thread which is waiting on the receiver to be made ready to run.
final void	notifyAll()	Causes all threads which are waiting on the receiver to be made ready to run.
final void	wait()	Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
final void	wait(long time)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
final void	wait(long time, int frac)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

Constructor Details

PrivateKeyEntry

public PrivateKeyEntry(PrivateKey privateKey,
 Certificate[] chain)

Constructs a PrivateKeyEntry with a PrivateKey and corresponding certificate chain.

The specified chain is cloned before it is stored in the new PrivateKeyEntry object.

Parameters:

privateKey - the PrivateKey

chain - an array of Certificates representing the certificate chain. The chain must be ordered and contain a Certificate at index 0 corresponding to the private key.

Throws:

NullPointerException - if privateKey or chain is null

IllegalArgumentException - if the specified chain has a length of 0, if the specified chain does not contain Certificates of the same type, or if the PrivateKey algorithm does not match the algorithm of the PublicKey in the end entity Certificate (at index 0)

PrivateKeyEntry

public PrivateKeyEntry(PrivateKey privateKey,
 Certificate[] chain,
 Set<KeyStore.Entry.Attribute> attributes)

Constructs a PrivateKeyEntry with a PrivateKey and corresponding certificate chain and associated entry attributes.

The specified chain and attributes are cloned before they are stored in the new PrivateKeyEntry object.

Parameters:

privateKey - the PrivateKey

chain - an array of Certificates representing the certificate chain. The chain must be ordered and contain a Certificate at index 0 corresponding to the private key.

attributes - the attributes

Throws:

NullPointerException - if privateKey, chain or attributes is null

IllegalArgumentException - if the specified chain has a length of 0, if the specified chain does not contain Certificates of the same type, or if the PrivateKey algorithm does not match the algorithm of the PublicKey in the end entity Certificate (at index 0)

Since:

1.8

Method Details

getPrivateKey

public PrivateKey getPrivateKey()

Gets the PrivateKey from this entry.

Returns:

the PrivateKey from this entry

getCertificateChain

public Certificate[] getCertificateChain()

Gets the Certificate chain from this entry.

The stored chain is cloned before being returned.

Returns:

an array of Certificates corresponding to the certificate chain for the public key. If the certificates are of type X.509, the runtime type of the returned array is X509Certificate[].

getCertificate

public Certificate getCertificate()

Gets the end entity Certificate from the certificate chain in this entry.

Returns:

the end entity Certificate (at index 0) from the certificate chain in this entry. If the certificate is of type X.509, the runtime type of the returned certificate is X509Certificate.

getAttributes

public Set<KeyStore.Entry.Attribute> getAttributes()

Retrieves the attributes associated with an entry.

Specified by:

getAttributes in interface KeyStore.Entry

Returns:

an unmodifiable Set of attributes, possibly empty

Since:

1.8

toString

public String toString()

Returns a string representation of this PrivateKeyEntry.

Overrides:

toString in class Object

Returns:

a string representation of this PrivateKeyEntry.