KeyStore.PrivateKeyEntry (Java Platform SE 6) - JDK 5 Documentation v6.0, Java 2 SDK 英文文档

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Java™ Platform
Standard Ed. 6

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

java.security
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
extends Object
implements KeyStore.Entry

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

Since:: 1.5

Constructor Summary

KeyStore.PrivateKeyEntry(PrivateKey privateKey, Certificate[] chain)
          Constructs a PrivateKeyEntry with a PrivateKey and corresponding certificate chain.

Method Summary

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 inherited from class java.lang.Object

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

Constructor Summary
`KeyStore.PrivateKeyEntry(PrivateKey privateKey, Certificate[] chain)` Constructs a `PrivateKeyEntry` with a `PrivateKey` and corresponding certificate chain.

Method Summary
`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 inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Constructor Detail

KeyStore.PrivateKeyEntry

public KeyStore.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)

Method Detail

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.

toString

public String toString()

Returns a string representation of this PrivateKeyEntry.

Overrides:: toString in class Object

Returns:: a string representation of this PrivateKeyEntry.