public interface PolicyNode
java.security.cert.PolicyNode |
由PKIX证书路径验证算法定义的不可变有效策略树节点。
PKIX证书路径验证算法的输出之一是一个有效的策略树,其中包含已确定为有效的策略,如何达到此确定以及遇到的任何策略限定符。 此树的深度为n ,其中n是已验证的认证路径的长度。
大多数应用程序不需要检查有效的策略树。 他们可以通过在PKIXParameters
设置策略相关参数来实现其策略处理目标。 但是,有效的策略树可用于更复杂的应用程序,尤其是那些处理策略限定符的应用程序。
PKIXCertPathValidatorResult.getPolicyTree
返回有效策略树的根节点。 树可以使用getChildren
和getParent
方法遍历。 有关特定节点的数据可以使用其他方法PolicyNode
进行检索。
并发访问
所有的PolicyNode
对象必须是不可变的,并且是线程安全的。 多个线程可能会同时在单个PolicyNode
对象(或多个对象)上调用此类中定义的方法,而不会产生不良影响。 本规定适用于该类的所有公共字段和方法以及任何由子类添加或覆盖的内容。
Public methods |
|
---|---|
abstract Iterator<? extends PolicyNode> |
getChildren() 返回此节点的子节点的迭代器。 |
abstract int |
getDepth() 返回有效策略树中此节点的深度。 |
abstract Set<String> |
getExpectedPolicies() 返回将在下一个要处理的证书中满足此节点的有效策略的预期策略集。 |
abstract PolicyNode |
getParent() 返回此节点的父节点,如果这是根节点,则返回 |
abstract Set<? extends PolicyQualifierInfo> |
getPolicyQualifiers() 返回与此节点表示的有效策略关联的一组策略限定符。 |
abstract String |
getValidPolicy() 返回此节点表示的有效策略。 |
abstract boolean |
isCritical() 返回最近处理的证书中证书策略扩展的关键指标。 |
Iterator<? extends PolicyNode> getChildren ()
返回此节点的子节点的迭代器。 任何通过Iterator
的remove方法修改此节点的子节点的Iterator
必须抛出UnsupportedOperationException
。
Returns | |
---|---|
Iterator<? extends PolicyNode> |
an iterator over the children of this node |
int getDepth ()
返回有效策略树中此节点的深度。
Returns | |
---|---|
int |
the depth of this node (0 for the root node, 1 for its children, and so on) |
Set<String> getExpectedPolicies ()
返回将在下一个要处理的证书中满足此节点的有效策略的预期策略集。
Returns | |
---|---|
Set<String> |
an immutable Set of expected policy String OIDs. For the root node, this method always returns a Set with one element, the special anyPolicy OID: "2.5.29.32.0". |
PolicyNode getParent ()
返回此节点的父节点,如果这是根节点,则返回 null
。
Returns | |
---|---|
PolicyNode |
the parent of this node, or null if this is the root node |
Set<? extends PolicyQualifierInfo> getPolicyQualifiers ()
返回与此节点表示的有效策略关联的一组策略限定符。
Returns | |
---|---|
Set<? extends PolicyQualifierInfo> |
an immutable Set of PolicyQualifierInfo s. For the root node, this is always an empty Set . |
String getValidPolicy ()
返回此节点表示的有效策略。
Returns | |
---|---|
String |
the String OID of the valid policy represented by this node. For the root node, this method always returns the special anyPolicy OID: "2.5.29.32.0". |
boolean isCritical ()
返回最近处理的证书中证书策略扩展的关键指标。
Returns | |
---|---|
boolean |
true if extension marked critical, false otherwise. For the root node, false is always returned. |