sun.security.x509

Class AVA

java.lang.Object

sun.security.x509.AVA

All Implemented Interfaces:

DerEncoder

public class AVA
extends java.lang.Object
implements DerEncoder

X.500 Attribute-Value-Assertion (AVA): an attribute, as identified by some attribute ID, has some particular value. Values are as a rule ASN.1 printable strings. A conventional set of type IDs is recognized when parsing (and generating) RFC 1779 or RFC 2253 syntax strings.

AVAs are components of X.500 relative names. Think of them as being individual fields of a database record. The attribute ID is how you identify the field, and the value is part of a particular record.

Note that instances of this class are immutable.

Author:

David Brownell, Amit Kapoor, Hemma Prafullchandra

See Also:

X500Name, RDN

Constructor Summary

Constructors

Constructor and Description
AVA(ObjectIdentifier type, DerValue val)

Method Summary

Methods

Modifier and Type	Method and Description
void	derEncode(java.io.OutputStream out) DER encode this object onto an output stream.
void	encode(DerOutputStream out)
boolean	equals(java.lang.Object obj)
DerValue	getDerValue() Get the value of this AVA as a DerValue.
ObjectIdentifier	getObjectIdentifier() Get the ObjectIdentifier of this AVA.
java.lang.String	getValueString() Get the value of this AVA as a String.
int	hashCode() Returns a hashcode for this AVA.
java.lang.String	toRFC1779String() Returns a printable form of this attribute, using RFC 1779 syntax for individual attribute/value assertions.
java.lang.String	toRFC1779String(java.util.Map<java.lang.String,java.lang.String> oidMap) Returns a printable form of this attribute, using RFC 1779 syntax for individual attribute/value assertions.
java.lang.String	toRFC2253CanonicalString()
java.lang.String	toRFC2253String() Returns a printable form of this attribute, using RFC 2253 syntax for individual attribute/value assertions.
java.lang.String	toRFC2253String(java.util.Map<java.lang.String,java.lang.String> oidMap) Returns a printable form of this attribute, using RFC 2253 syntax for individual attribute/value assertions.
java.lang.String	toString() Returns a printable form of this attribute, using RFC 1779 syntax for individual attribute/value assertions.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

AVA

public AVA(ObjectIdentifier type,
   DerValue val)

Method Detail

getObjectIdentifier

public ObjectIdentifier getObjectIdentifier()

Get the ObjectIdentifier of this AVA.

getDerValue

public DerValue getDerValue()

Get the value of this AVA as a DerValue.

getValueString

public java.lang.String getValueString()

Get the value of this AVA as a String.

Throws:

java.lang.RuntimeException - if we could not obtain the string form (should not occur)

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Returns a hashcode for this AVA.

Overrides:

hashCode in class java.lang.Object

Returns:

a hashcode for this AVA.

encode

public void encode(DerOutputStream out)
            throws java.io.IOException

Throws:

java.io.IOException

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 output stream on which to write the DER encoding.

Throws:

java.io.IOException - on encoding error.

toString

public java.lang.String toString()

Returns a printable form of this attribute, using RFC 1779 syntax for individual attribute/value assertions.

Overrides:

toString in class java.lang.Object

toRFC1779String

public java.lang.String toRFC1779String()

Returns a printable form of this attribute, using RFC 1779 syntax for individual attribute/value assertions. It only emits standardised keywords.

toRFC1779String

public java.lang.String toRFC1779String(java.util.Map<java.lang.String,java.lang.String> oidMap)

Returns a printable form of this attribute, using RFC 1779 syntax for individual attribute/value assertions. It emits standardised keywords, as well as keywords contained in the OID/keyword map.

toRFC2253String

public java.lang.String toRFC2253String()

Returns a printable form of this attribute, using RFC 2253 syntax for individual attribute/value assertions. It only emits standardised keywords.

toRFC2253String

public java.lang.String toRFC2253String(java.util.Map<java.lang.String,java.lang.String> oidMap)

Returns a printable form of this attribute, using RFC 2253 syntax for individual attribute/value assertions. It emits standardised keywords, as well as keywords contained in the OID/keyword map.

toRFC2253CanonicalString

public java.lang.String toRFC2253CanonicalString()