sun.security.pkcs

Class PKCS10Attribute

java.lang.Object

sun.security.pkcs.PKCS10Attribute

All Implemented Interfaces:

DerEncoder

public class PKCS10Attribute
extends java.lang.Object
implements DerEncoder

Represent a PKCS#10 Attribute.

Attributes are additonal information which can be inserted in a PKCS#10 certificate request. For example a "Driving License Certificate" could have the driving license number as an attribute.

Attributes are represented as a sequence of the attribute identifier (Object Identifier) and a set of DER encoded attribute values. ASN.1 definition of Attribute:

 Attribute :: SEQUENCE {
    type    AttributeType,
    values  SET OF AttributeValue
 }
 AttributeType  ::= OBJECT IDENTIFIER
 AttributeValue ::= ANY defined by type
 

Author:

Amit Kapoor, Hemma Prafullchandra

Field Summary

Fields

Modifier and Type	Field and Description
protected ObjectIdentifier	attributeId
protected java.lang.Object	attributeValue

Constructor Summary

Constructors

Constructor and Description
PKCS10Attribute(DerValue derVal) Constructs an attribute from a DER encoding.
PKCS10Attribute(ObjectIdentifier attributeId, java.lang.Object attributeValue) Constructs an attribute from individual components of ObjectIdentifier and the value (any java object).
PKCS10Attribute(PKCS9Attribute attr) Constructs an attribute from PKCS9 attribute.

Method Summary

Methods

Modifier and Type	Method and Description
void	derEncode(java.io.OutputStream out) DER encode this object onto an output stream.
ObjectIdentifier	getAttributeId() Returns the ObjectIdentifier of the attribute.
java.lang.Object	getAttributeValue() Returns the attribute value.
java.lang.String	toString() Returns the attribute in user readable form.

Methods inherited from class java.lang.Object

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

Field Detail

attributeId

protected ObjectIdentifier attributeId

attributeValue

protected java.lang.Object attributeValue

Constructor Detail

PKCS10Attribute

public PKCS10Attribute(DerValue derVal)
                throws java.io.IOException

Constructs an attribute from a DER encoding. This constructor expects the value to be encoded as defined above, i.e. a SEQUENCE of OID and SET OF value(s), not a literal X.509 v3 extension. Only PKCS9 defined attributes are supported currently.

Parameters:

derVal - the der encoded attribute.

Throws:

java.io.IOException - on parsing errors.

PKCS10Attribute

public PKCS10Attribute(ObjectIdentifier attributeId,
               java.lang.Object attributeValue)

Constructs an attribute from individual components of ObjectIdentifier and the value (any java object).

Parameters:

attributeId - the ObjectIdentifier of the attribute.

attributeValue - an instance of a class that implements the attribute identified by the ObjectIdentifier.

PKCS10Attribute

public PKCS10Attribute(PKCS9Attribute attr)

Constructs an attribute from PKCS9 attribute.

Parameters:

attr - the PKCS9Attribute to create from.

Method Detail

derEncode

public void derEncode(java.io.OutputStream out)
               throws java.io.IOException

DER encode this object onto an output stream. Implements the DerEncoder interface.

Specified by:

derEncode in interface DerEncoder

Parameters:

out - the OutputStream on which to write the DER encoding.

Throws:

java.io.IOException - on encoding errors.

getAttributeId

public ObjectIdentifier getAttributeId()

Returns the ObjectIdentifier of the attribute.

getAttributeValue

public java.lang.Object getAttributeValue()

Returns the attribute value.

toString

public java.lang.String toString()

Returns the attribute in user readable form.

Overrides:

toString in class java.lang.Object