class:PKCS12Attribute [NONE]

All Implemented Interfaces:: KeyStore.Entry.Attribute

public final class PKCS12Attribute
extends Object
implements KeyStore.Entry.Attribute

An attribute associated with a PKCS12 keystore entry. The attribute name is an ASN.1 Object Identifier and the attribute value is a set of ASN.1 types.

Since:: 1.8

constructor:PKCS12Attribute(java.lang.String,java.lang.String) [NONE]

PKCS12Attribute

public PKCS12Attribute?(String name, String value)

Constructs a PKCS12 attribute from its name and value. The name is an ASN.1 Object Identifier represented as a list of dot-separated integers. A string value is represented as the string itself. A binary value is represented as a string of colon-separated pairs of hexadecimal digits. Multi-valued attributes are represented as a comma-separated list of values, enclosed in square brackets. See Arrays.toString(java.lang.Object[]).

A string value will be DER-encoded as an ASN.1 UTF8String and a binary value will be DER-encoded as an ASN.1 Octet String.

Parameters:: name - the attribute's identifier; value - the attribute's value
Throws:: NullPointerException - if name or value is null; IllegalArgumentException - if name or value is incorrectly formatted

constructor:PKCS12Attribute(byte[]) [CHANGED]

PKCS12Attribute

public PKCS12Attribute?(byte[] encoded)

Constructs a PKCS12 attribute from its ASN.1 DER encoding. The DER encoding is specified by the following ASN.1 definition:


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

Parameters:: encoded - the attribute's ASN.1 DER encoding. It is cloned to prevent subsequent modificaionmodification.
Throws:: NullPointerException - if encoded is null; IllegalArgumentException - if encoded is incorrectly formatted

PKCS12Attribute

public PKCS12Attribute?(byte[] encoded)

Constructs a PKCS12 attribute from its ASN.1 DER encoding. The DER encoding is specified by the following ASN.1 definition:


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

Parameters:: encoded - the attribute's ASN.1 DER encoding. It is cloned to prevent subsequent modificaion.
Throws:: NullPointerException - if encoded is null; IllegalArgumentException - if encoded is incorrectly formatted

PKCS12Attribute

public PKCS12Attribute?(byte[] encoded)

Constructs a PKCS12 attribute from its ASN.1 DER encoding. The DER encoding is specified by the following ASN.1 definition:


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

Parameters:: encoded - the attribute's ASN.1 DER encoding. It is cloned to prevent subsequent modification.
Throws:: NullPointerException - if encoded is null; IllegalArgumentException - if encoded is incorrectly formatted

method:getName() [NONE]

getName

public String getName()

Returns the attribute's ASN.1 Object Identifier represented as a list of dot-separated integers.

Specified by:: getName in interface KeyStore.Entry.Attribute
Returns:: the attribute's identifier

method:getValue() [NONE]

getValue

public String getValue()

Returns the attribute's ASN.1 DER-encoded value as a string. An ASN.1 DER-encoded value is returned in one of the following String formats:

the DER encoding of a basic ASN.1 type that has a natural string representation is returned as the string itself. Such types are currently limited to BOOLEAN, INTEGER, OBJECT IDENTIFIER, UTCTime, GeneralizedTime and the following six ASN.1 string types: UTF8String, PrintableString, T61String, IA5String, BMPString and GeneralString.
the DER encoding of any other ASN.1 type is not decoded but returned as a binary string of colon-separated pairs of hexadecimal digits.

Multi-valued attributes are represented as a comma-separated list of values, enclosed in square brackets. See Arrays.toString(java.lang.Object[]).

Specified by:: getValue in interface KeyStore.Entry.Attribute
Returns:: the attribute value's string encoding

method:getEncoded() [NONE]

getEncoded

public byte[] getEncoded()

Returns the attribute's ASN.1 DER encoding.

Returns:: a clone of the attribute's DER encoding

method:equals(java.lang.Object) [NONE]

equals

public boolean equals?(Object obj)

Compares this PKCS12Attribute and a specified object for equality.

Overrides:: equals in class Object
Parameters:: obj - the comparison object
Returns:: true if obj is a PKCS12Attribute and their DER encodings are equal.
See Also:: Object.hashCode(), HashMap

method:hashCode() [NONE]

hashCode

public int hashCode()

Returns the hashcode for this PKCS12Attribute. The hash code is computed from its DER encoding.

Overrides:: hashCode in class Object
Returns:: the hash code
See Also:: Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

method:toString() [NONE]

toString

public String toString()

Returns a string representation of this PKCS12Attribute.

Overrides:: toString in class Object
Returns:: a name/value pair separated by an 'equals' symbol