java.security
介面 Key

所有父級介面：

Serializable

所有已知子介面：

DHPrivateKey, DHPublicKey, DSAPrivateKey, DSAPublicKey, ECPrivateKey, ECPublicKey, PBEKey, PrivateKey, PublicKey, RSAMultiPrimePrivateCrtKey, RSAPrivateCrtKey, RSAPrivateKey, RSAPublicKey, SecretKey

所有已知實作類別：

KerberosKey, SecretKeySpec

public interface Key
extends Serializable

Key 是所有密鑰的頂層介面。它定義了供所有密鑰物件共享的功能。所有的密鑰都具有三個特徵：

• 演算法

  這是該密鑰的密鑰演算法。密鑰演算法通常是加密或不對稱操作演算法（如 DSA 或 RSA），它們將和那些演算法及相關的演算法（例如 MD5 和 RSA，SHA-1 和 RSA、Raw DSA 等等）一起使用。用 getAlgorithm 方法獲取密鑰演算法的名稱。

• 編碼形式

  這是密鑰的外部編碼形式，在 Java 虛擬機器之外需要密鑰的標準表示形式時以及將密鑰傳輸到其他某些部分時使用。密鑰根據標準格式（如 X.509 SubjectPublicKeyInfo 或 PKCS#8）編碼，使用 getEncoded 方法返回。註：ASN.1 型別 SubjectPublicKeyInfo 的語法定義如下：

   SubjectPublicKeyInfo ::= SEQUENCE {
     algorithm AlgorithmIdentifier,
     subjectPublicKey BIT STRING }
  
   AlgorithmIdentifier ::= SEQUENCE {
     algorithm OBJECT IDENTIFIER,
     parameters ANY DEFINED BY algorithm OPTIONAL }
   

  有關更多資訊，請參見 RFC 2459: Internet X.509 Public Key Infrastructure Certificate and CRL Profile.

• 格式

  這是已編碼密鑰的格式的名稱。它由 getFormat 方法返回。

密鑰通常通過密鑰產生器、證書或用來管理密鑰的各種 Identity 類別來獲取。密鑰也可以通過使用密鑰處理器（請參見 KeyFactory）從密鑰規範（基礎密鑰材料的透明表示形式）獲取。

密鑰應該使用 KeyRep 作為其序列化的表示形式。注意，序列化的 Key 可能包含不應該在不可信任的環境中顯示的敏感資訊。有關更多資訊，請參見序列化規範的安全附錄。

另請參見：

PublicKey, PrivateKey, KeyPair, KeyPairGenerator, KeyFactory, KeyRep, KeySpec, Identity, Signer

欄位摘要

static long

serialVersionUID 設置為指示與以前的類別版本序列化相容的類別指紋。

方法摘要

String	getAlgorithm() 返回此密鑰的標準演算法名稱。
byte[]	getEncoded() 返回基本編碼格式的密鑰，如果此密鑰不支持編碼，則返回 null。
String	getFormat() 返回此密鑰的基本編碼格式，如果此密鑰不支持編碼，則返回 null。

欄位詳細資訊

serialVersionUID

static final long serialVersionUID

設置為指示與以前的類別版本序列化相容的類別指紋。

另請參見：

常數欄位值

方法詳細資訊

getAlgorithm

String getAlgorithm()

返回此密鑰的標準演算法名稱。例如，"DSA" 指示此密鑰是一個 DSA 密鑰。有關標準演算法名稱的資訊，請參見 Java Cryptography Architecture API Specification & Reference 中的附錄 A。

返回：

與此密鑰關聯的演算法名稱。

getFormat

String getFormat()

返回此密鑰的基本編碼格式，如果此密鑰不支持編碼，則返回 null。如果存在此密鑰的 ASN.1 規範，則根據合適的 ASN.1 資料格式命名基本編碼格式。例如，公鑰的 ASN.1 資料格式名稱是 SubjectPublicKeyInfo（由 X.509 標準定義）；在這種情況下，返回的格式為 "X.509"。類似地，私鑰的 ASN.1 資料格式名稱是 PrivateKeyInfo（由 PKCS #8 標準定義）；在這種情況下，返回的格式為 "PKCS#8"。

返回：

密鑰的基本編碼格式。

getEncoded

byte[] getEncoded()

返回基本編碼格式的密鑰，如果此密鑰不支持編碼，則返回 null。

返回：

編碼的密鑰，如果此密鑰不支持編碼，則返回 null。