java.security.cert
介面 PolicyNode

public interface PolicyNode

PKIX 證書路徑驗證演算法所定義的、不可變的有效策略階層樹節點。

PKIX 證書路徑驗證演算法的輸出是有效策略階層樹，其中包括確定為有效的策略、如何實作該確定，以及遇到的所有策略限定符。此階層樹的深度為 n，其中 n 是已驗證的證書路徑的長度。

大多數應用程序無需檢驗有效策略階層樹。它們可以通過設置 PKIXParameters 中與策略相關的參數來獲得其策略處理目標。但是，大多數複雜的應用程序都可使用有效策略階層樹，特別是那些處理策略限定符的應用程序。

PKIXCertPathValidatorResult.getPolicyTree 返回有效策略階層樹的根節點。可使用 getChildren 和 getParent 方法遍歷該階層樹。可使用 PolicyNode 的其他方法來獲取有關特定節點的資料。

共時存取

所有 PolicyNode 物件必須是不可變的和執行緒安全的。多個執行緒在單個 PolicyNode 物件（或多個物件）上共時調用此類別中所定義的各種方法不會產生壞的影響。此規定適用於此類別的所有公共欄位和方法，以及由子類別添加或覆寫的所有公共欄位和方法。

從以下版本開始：

1.4

方法摘要

Iterator<? extends PolicyNode>	getChildren() 返回在此節點的子節點上進行迭代的迭代器。
int	getDepth() 返回有效策略階層樹中此節點的深度。
Set<String>	getExpectedPolicies() 返回預期的策略集，其中的策略將滿足下一個要處理證書中此節點的有效策略。
PolicyNode	getParent() 返回此節點的父節點，如果此節點是根節點，則返回 null。
Set<? extends PolicyQualifierInfo>	getPolicyQualifiers() 返回與此節點所表示的有效策略相關聯的策略限定符集。
String	getValidPolicy() 返回此節點所表示的有效策略。
boolean	isCritical() 返回最近處理的證書中其證書策略擴展的關鍵性指示符。

方法詳細資訊

getParent

PolicyNode getParent()

返回此節點的父節點，如果此節點是根節點，則返回 null。

返回：

此節點的父節點，如果此節點是根節點，則返回 null

getChildren

Iterator<? extends PolicyNode> getChildren()

返回在此節點的子節點上進行迭代的迭代器。任何試圖通過該 Iterator 的 remove 方法來修改此節點的子節點的行為都必須拋出 UnsupportedOperationException。

返回：

在此節點的子節點上進行迭代的迭代器

getDepth

int getDepth()

返回有效策略階層樹中此節點的深度。

返回：

此節點的深度（0 代表根節點，1 代表其子節點，依此類別推）

getValidPolicy

String getValidPolicy()

返回此節點所表示的有效策略。

返回：

此節點所表示的有效策略的 String OID，或者是特殊值 "any-policy"。對於根節點，此方法始終返回特殊值 "any-policy"。

getPolicyQualifiers

Set<? extends PolicyQualifierInfo> getPolicyQualifiers()

返回與此節點所表示的有效策略相關聯的策略限定符集。

返回：

一個不可變的 PolicyQualifierInfo Set。對於根節點，此方法始終返回一個空 Set。

getExpectedPolicies

Set<String> getExpectedPolicies()

返回預期的策略集，其中的策略將滿足下一個要處理證書中此節點的有效策略。

返回：

一個不可變的預期策略 String OID 的 Set，或者具有單個特殊值 "any-policy" 的不可變 Set。對於根節點，此方法始終返回具有單個值 "any-policy" 的 Set。

isCritical

boolean isCritical()

返回最近處理的證書中其證書策略擴展的關鍵性指示符。

返回：

如果擴展標記為關鍵的，則返回 true；否則返回 false。對於根節點，此方法始終返回 false。