站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

PolicyQualifierInfo (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

JavaTM 2 Platform
Standard Ed. 5.0

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 对象的 SetPolicyNode.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()
          返回此 PolicyQualifierInfoqualifier 字段的 ASN.1 DER 编码形式。
 String getPolicyQualifierId()
          返回此 PolicyQualifierInfopolicyQualifierId 字段。
 String toString()
          返回此 PolicyQualifierInfo 的可打印表示形式。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

PolicyQualifierInfo

public PolicyQualifierInfo(byte[] encoded)
                    throws IOException
根据已编码的字节创建一个 PolicyQualifierInfo 实例。在构造时复制该已编码的字节数组。

参数:
encoded - 包含 DER 编码中限定符的字节数组
抛出:
IOException - 如果该字节数组不表示一个有效并且可解析的策略限定符
方法详细信息

getPolicyQualifierId

public final String getPolicyQualifierId()
返回此 PolicyQualifierInfopolicyQualifierId 字段。policyQualifierId 是一个对象标识符 (OID),由一组句点分隔的非负整数来表示。

返回:
OID(从不为 null

getEncoded

public final byte[] getEncoded()
返回此 PolicyQualifierInfo 的 ASN.1 DER 编码形式。

返回:
以 ASN.1 DER 编码的字节(从不为 null)。注意,返回的是一个副本,所以每次调用此方法时都复制数据。

getPolicyQualifier

public final byte[] getPolicyQualifier()
返回此 PolicyQualifierInfoqualifier 字段的 ASN.1 DER 编码形式。

返回:
qualifier 字段以 ASN.1 DER 编码的字节。注意,返回的是一个副本,所以每次调用此方法时都复制数据。

toString

public String toString()
返回此 PolicyQualifierInfo 的可打印表示形式。

覆盖:
Object 中的 toString
返回:
描述此 PolicyQualifierInfo 内容的 String

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策