java.security.cert
類別 PolicyQualifierInfo

java.lang.Object
  java.security.cert.PolicyQualifierInfo

public class PolicyQualifierInfo
extends Object

由 ASN.1 PolicyQualifierInfo 結構所表示的、不可變的策略限定符。

ASN.1 的定義如下：

   PolicyQualifierInfo ::= SEQUENCE {
        policyQualifierId       PolicyQualifierId,
        qualifier               ANY DEFINED BY policyQualifierId }
 

如果在 X.509 第 3 版的證書中有證書策略擴展，則該擴展包含一個或多個策略資訊項的序列，每一項都由一個物件標識符 (OID) 和可選的限定符組成。在最終實體證書中，這些策略資訊項指示了策略（根據此策略發佈證書）和目的（該證書的可能用途）。在 CA 證書中，這些策略資訊項則限制了包括此證書的證書路徑的策略集。

PolicyQualifierInfo 物件的 Set 由 PolicyNode.getPolicyQualifiers 方法返回。這就允許帶有具體策略要求的應用程序處理並驗證每個策略限定符。處理策略限定符的應用程序在驗證一個證書路徑前，應該顯式地將 policyQualifiersRejected 標誌設置為 false（通過調用 PKIXParameters.setPolicyQualifiersRejected 方法）。

注意，PKIX 證書路徑驗證演算法規定，對標記為關鍵的證書策略擴展中的策略限定符必須加以處理和驗證。否則必須放棄該證書路徑。如果 policyQualifiersRejected 標誌設置為 false，那麼為了遵守 PKIX ，由應用程序以此方式來驗證所有的策略限定符。

共時存取

所有 PolicyQualifierInfo 物件必須是不可變的和執行緒安全的。也就是說，多個執行緒在單個 PolicyQualifierInfo 物件（或多個物件）上共時調用此類別中所定義的各種方法不會產生壞的影響。要求 PolicyQualifierInfo 物件是不可變的並且是執行緒安全的，就允許將其傳遞到各種程式碼片斷中，而無需擔心協調存取。

從以下版本開始：

1.4

建構子摘要

PolicyQualifierInfo(byte[] encoded)
根據已編碼的位元組創建一個 PolicyQualifierInfo 實例。

方法摘要

byte[]	getEncoded() 返回此 PolicyQualifierInfo 的 ASN.1 DER 編碼形式。
byte[]	getPolicyQualifier() 返回此 PolicyQualifierInfo 的 qualifier 欄位的 ASN.1 DER 編碼形式。
String	getPolicyQualifierId() 返回此 PolicyQualifierInfo 的 policyQualifierId 欄位。
String	toString() 返回此 PolicyQualifierInfo 的可列印表示形式。

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

PolicyQualifierInfo

public PolicyQualifierInfo(byte[] encoded)
                    throws IOException

根據已編碼的位元組創建一個 PolicyQualifierInfo 實例。在建構時複製該已編碼的 byte 陣列。

參數：

encoded - 套件含 DER 編碼中限定符的 byte 陣列

拋出：

IOException - 如果該 byte 陣列不表示一個有效並且可解析的策略限定符

方法詳細資訊

getPolicyQualifierId

public final String getPolicyQualifierId()

返回此 PolicyQualifierInfo 的 policyQualifierId 欄位。policyQualifierId 是一個物件標識符 (OID)，由一組句點分隔的非負整數來表示。

返回：

OID（從不為 null）

getEncoded

public final byte[] getEncoded()

返回此 PolicyQualifierInfo 的 ASN.1 DER 編碼形式。

返回：

以 ASN.1 DER 編碼的位元組（從不為 null）。注意，返回的是一個副本，所以每次調用此方法時都複製資料。

getPolicyQualifier

public final byte[] getPolicyQualifier()

返回此 PolicyQualifierInfo 的 qualifier 欄位的 ASN.1 DER 編碼形式。

返回：

qualifier 欄位以 ASN.1 DER 編碼的位元組。注意，返回的是一個副本，所以每次調用此方法時都複製資料。

toString

public String toString()

返回此 PolicyQualifierInfo 的可列印表示形式。

覆寫：

類別 Object 中的 toString

返回：

描述此 PolicyQualifierInfo 內容的 String