PolicyQualifierInfo

public class PolicyQualifierInfo
extends Object

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

An immutable policy qualifier represented by the ASN.1 PolicyQualifierInfo structure.

The ASN.1 definition is as follows:

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

A certificate policies extension, if present in an X.509 version 3 certificate, contains a sequence of one or more policy information terms, each of which consists of an object identifier (OID) and optional qualifiers. In an end-entity certificate, these policy information terms indicate the policy under which the certificate has been issued and the purposes for which the certificate may be used. In a CA certificate, these policy information terms limit the set of policies for certification paths which include this certificate.

A Set of PolicyQualifierInfo objects are returned by the PolicyNode.getPolicyQualifiers method. This allows applications with specific policy requirements to process and validate each policy qualifier. Applications that need to process policy qualifiers should explicitly set the policyQualifiersRejected flag to false (by calling the PKIXParameters.setPolicyQualifiersRejected method) before validating a certification path.

Note that the PKIX certification path validation algorithm specifies that any policy qualifier in a certificate policies extension that is marked critical must be processed and validated. Otherwise the certification path must be rejected. If the policyQualifiersRejected flag is set to false, it is up to the application to validate all policy qualifiers in this manner in order to be PKIX compliant.

Concurrent Access

All PolicyQualifierInfo objects must be immutable and thread-safe. That is, multiple threads may concurrently invoke the methods defined in this class on a single PolicyQualifierInfo object (or more than one) with no ill effects. Requiring PolicyQualifierInfo objects to be immutable and thread-safe allows them to be passed around to various pieces of code without worrying about coordinating access.

Summary

Public constructors
`PolicyQualifierInfo(byte[] encoded)` Creates an instance of `PolicyQualifierInfo` from the encoded bytes.

Public methods
`final byte[]`	`getEncoded()` Returns the ASN.1 DER encoded form of this `PolicyQualifierInfo`.
`final byte[]`	`getPolicyQualifier()` Returns the ASN.1 DER encoded form of the `qualifier` field of this `PolicyQualifierInfo`.
`final String`	`getPolicyQualifierId()` Returns the `policyQualifierId` field of this `PolicyQualifierInfo`.
`String`	`toString()` Return a printable representation of this `PolicyQualifierInfo`.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public constructors

PolicyQualifierInfo

Added in API level 1

public PolicyQualifierInfo (byte[] encoded)

Creates an instance of PolicyQualifierInfo from the encoded bytes. The encoded byte array is copied on construction.

Parameters
`encoded`	`byte`: a byte array containing the qualifier in DER encoding

Throws
`IOException`	thrown if the byte array does not represent a valid and parsable policy qualifier

Public methods

getEncoded

Added in API level 1

public final byte[] getEncoded ()

Returns the ASN.1 DER encoded form of this PolicyQualifierInfo.

Returns
`byte[]`	the ASN.1 DER encoded bytes (never `null`). Note that a copy is returned, so the data is cloned each time this method is called.

getPolicyQualifier

Added in API level 1

public final byte[] getPolicyQualifier ()

Returns the ASN.1 DER encoded form of the qualifier field of this PolicyQualifierInfo.

Returns
`byte[]`	the ASN.1 DER encoded bytes of the `qualifier` field. Note that a copy is returned, so the data is cloned each time this method is called.

getPolicyQualifierId

Added in API level 1

public final String getPolicyQualifierId ()

Returns the policyQualifierId field of this PolicyQualifierInfo. The policyQualifierId is an Object Identifier (OID) represented by a set of nonnegative integers separated by periods.

Returns
`String`	the OID (never `null`)

toString

Added in API level 1

public String toString ()

Return a printable representation of this PolicyQualifierInfo.

Returns
`String`	a `String` describing the contents of this `PolicyQualifierInfo`