iaik.asn1.structures

Class Attributes

java.lang.Object

iaik.asn1.structures.Attributes

public class Attributes
extends java.lang.Object

An container class for X.509 Attributes. This class may be used as a container for adding, inserting, removing, encoding X.509 Attributes. When encoding the attributes included in the container, they may be BER encoded either as ASN.1 SET OF or as ASN.1 SEQUENCE OF Attributes.

Version:

File Revision 9

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Vector	attributes_ The Attribute repository (order may be of interest).

Constructor Summary

Constructors

Constructor and Description
Attributes() Empty constructor.
Attributes(ASN1Object attributes) Creates an Attribute container from a SET OF or SEQUENCE OF attributes.
Attributes(Attribute[] attributes) Creates an Attribute container from the given list of attributes.
Attributes(byte[] encodedAttributes) Creates an Attribute container from a BER encoded SET OF or SEQUENCE OF attributes.
Attributes(java.io.InputStream is) Creates an Attribute container from a BER encoded SET OF or SEQUENCE OF attributes.

Method Summary

Modifier and Type	Method and Description
void	addAttribute(Attribute attribute) Adds the given attribute.
void	addAttribute(Attribute attribute, boolean replace) Adds the given attribute.
void	addAttributes(Attribute[] attributes) Adds the given attributes.
void	clearAll() Clears all attributes included in the container.
byte[]	encodeAsAsn1SEQUENCE(java.io.OutputStream os) Builds and encodes an ASN.1 SEQUENCE of the attributes included in this container.
byte[]	encodeAsAsn1SET() Builds and encodes an ASN.1 SET of the attributes included in this container.
byte[]	encodeAsAsn1SET(boolean sorted) Builds and encodes an ASN.1 SET of the attributes included in this container.
Attribute	getAttribute(ObjectID type) Returns the first attribute with the given type.
java.util.Enumeration	getAttributes() Returns all attributes included in the container.
Attribute[]	getAttributes(ObjectID type) Returns all attributes with the given type.
void	insertAttributeAt(Attribute attribute, int index) Inserts the given attribute.
boolean	removeAttribute(Attribute attribute) Removes the first representative of the given attribute.
Attribute	removeAttribute(ObjectID type) Removes the first attribute with the given type from the container
boolean	removeAttributes(Attribute attribute) Removes all representatives of the given attribute from the container.
Attribute[]	removeAttributes(ObjectID type) Removes all attributes with the given type from the container
int	size() Returns the number of attributes held by this Attributes object.
Attribute[]	toArray() Returns an array containing all the attributes included in this container.
SEQUENCE	toAsn1SEQUENCE() Returns the attributes included in this container as ASN.1 SEQUENCE.
SET	toAsn1SET() Returns the attributes included in this container as ASN.1 SET.
SET	toAsn1SET(boolean sorted) Returns the attributes included in this container as ASN.1 SET.
java.lang.String	toString() Returns a string that lists all the Attributes hold in this container.
void	writeToAsn1SEQUENCE(java.io.OutputStream os) Builds an ASN.1 SEQUENCE of the attributes included in this container and writes it encoded to the given output stream.
void	writeToAsn1SET(java.io.OutputStream os) Builds an ASN.1 SET of the attributes included in this container and writes it encoded to the given output stream.
void	writeToAsn1SET(java.io.OutputStream os, boolean sorted) Builds an ASN.1 SET of the attributes included in this container and writes it encoded to the given output stream.

Methods inherited from class java.lang.Object

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

Field Detail

attributes_

protected java.util.Vector attributes_

The Attribute repository (order may be of interest).

Constructor Detail

Attributes

public Attributes()

Empty constructor. Creates an empty Attributes container.

Attributes

public Attributes(Attribute[] attributes)

Creates an Attribute container from the given list of attributes.

Parameters:

attributes - the attributes to be added to the container

Attributes

public Attributes(ASN1Object attributes)
           throws CodingException

Creates an Attribute container from a SET OF or SEQUENCE OF attributes.

Parameters:

attributes - the ASN.1 SET OF or SEQUENCE OF attributes to be parsed

Throws:

CodingException - if an error occurs while parsing the attributes

Attributes

public Attributes(java.io.InputStream is)
           throws CodingException,
                  java.io.IOException

Creates an Attribute container from a BER encoded SET OF or SEQUENCE OF attributes. The encoded bytes are kept.

Parameters:

is - the inputstream supplying the encoded ASN.1 SET OF or SEQUENCE OF attributes to be parsed

Throws:

CodingException - if an error occurs while parsing the attributes

java.io.IOException

Attributes

public Attributes(byte[] encodedAttributes)
           throws CodingException

Creates an Attribute container from a BER encoded SET OF or SEQUENCE OF attributes. The encoded bytes are kept.

Parameters:

encodedAttributes - the byte array supplying the encoded ASN.1 SET OF or SEQUENCE OF attributes to be parsed

Throws:

CodingException - if an error occurs while parsing the attributes

Method Detail

addAttribute

public void addAttribute(Attribute attribute)

Adds the given attribute.

Parameters:

attribute - the attribute to be added.

addAttribute

public void addAttribute(Attribute attribute,
                         boolean replace)

Adds the given attribute.

Parameters:

attribute - the attribute to be added.

replace - whether to replace any already existing attribute with the given type

addAttributes

public void addAttributes(Attribute[] attributes)

Adds the given attributes.

Parameters:

attributes - the attributes to be added.

insertAttributeAt

public void insertAttributeAt(Attribute attribute,
                              int index)

Inserts the given attribute.

Parameters:

attribute - the attribute to be inserted.

index - the position at which to insert the attribute

getAttributes

public java.util.Enumeration getAttributes()

Returns all attributes included in the container.

Returns:

an Enumeration containing all attributes included in the container; the enumeration may be empty

getAttribute

public Attribute getAttribute(ObjectID type)

Returns the first attribute with the given type.

Returns:

the first attribute with the given type, if present; null otherwise

getAttributes

public Attribute[] getAttributes(ObjectID type)

Returns all attributes with the given type.

Returns:

an array containing all the attribute with the given type; the array may be empty if no such attribute is present in the container

toArray

public Attribute[] toArray()

Returns an array containing all the attributes included in this container.

Returns:

an array containing all the attributes included in this container; the array may be empty if no attributes are present in the container

clearAll

public void clearAll()

Clears all attributes included in the container.

removeAttribute

public boolean removeAttribute(Attribute attribute)

Removes the first representative of the given attribute.

Parameters:

attribute - the attribute to be removed

Returns:

true if the attribute has been removed, false if no such attribute was present

removeAttribute

public Attribute removeAttribute(ObjectID type)

Removes the first attribute with the given type from the container

Parameters:

type - the type of the attribute to be removed

Returns:

the attribute just removed, or null if no attribute with this type was present

removeAttributes

public boolean removeAttributes(Attribute attribute)

Removes all representatives of the given attribute from the container.

Parameters:

attribute - the attribute to be removed

Returns:

true if the attributes have been removed, false if no such attribute was present

removeAttributes

public Attribute[] removeAttributes(ObjectID type)

Removes all attributes with the given type from the container

Parameters:

type - the type of the attributes to be removed

Returns:

an array containing the attributes just removed; the array may be empty if no attribute with this type was present

size

public int size()

Returns the number of attributes held by this Attributes object.

Returns:

the number of attributes included

toAsn1SET

public SET toAsn1SET()
              throws CodingException

Returns the attributes included in this container as ASN.1 SET.

Returns:

the attributes included in this container as ASN.1 SET.

Throws:

CodingException - if an error occurs while building the SET

toAsn1SET

public SET toAsn1SET(boolean sorted)
              throws CodingException

Returns the attributes included in this container as ASN.1 SET.

Parameters:

sorted - whether to sort the elements of the SET when encoding it

Returns:

the attributes included in this container as ASN.1 SET.

Throws:

CodingException - if an error occurs while building the SET

toAsn1SEQUENCE

public SEQUENCE toAsn1SEQUENCE()
                        throws CodingException

Returns the attributes included in this container as ASN.1 SEQUENCE.

Returns:

the attributes included in this container as ASN.1 SEQUENCE.

Throws:

CodingException - if an error occurs while building the SEQUENCE

writeToAsn1SET

public void writeToAsn1SET(java.io.OutputStream os)
                    throws java.io.IOException

Builds an ASN.1 SET of the attributes included in this container and writes it encoded to the given output stream. If this Attributes container has been created by parsing an ASN.1 SET the original encoding is written to the stream. Otherwise a new SET is created.

Parameters:

os - the output stream to which to write the encoded SET of attributes

Throws:

java.io.IOException - if an error occurs while building/encoding the SET or writing it to the stream

writeToAsn1SET

public void writeToAsn1SET(java.io.OutputStream os,
                           boolean sorted)
                    throws java.io.IOException

Builds an ASN.1 SET of the attributes included in this container and writes it encoded to the given output stream. If this Attributes container has been created by parsing an ASN.1 SET the original encoding is written to the stream. Otherwise a new SET is created.

Parameters:

os - the output stream to which to write the encoded SET of attributes

sorted - whether to sort the elements of the SET when encoding it

Throws:

java.io.IOException - if an error occurs while building/encoding the SET or writing it to the stream

writeToAsn1SEQUENCE

public void writeToAsn1SEQUENCE(java.io.OutputStream os)
                         throws java.io.IOException

Builds an ASN.1 SEQUENCE of the attributes included in this container and writes it encoded to the given output stream. If this Attributes container has been created by parsing an ASN.1 SEQUENCE the original encoding is written to the stream. Otherwise a new SEQUENCE is created.

Parameters:

os - the output stream to which to write the encoded SEQUENCE of attributes

Throws:

java.io.IOException - if an error occurs while building/encoding the SEQUENCE or writing it to the stream

encodeAsAsn1SET

public byte[] encodeAsAsn1SET()
                       throws CodingException

Builds and encodes an ASN.1 SET of the attributes included in this container. If this Attributes container has been created by parsing an ASN.1 SET the original encoding is returned. Otherwise a new SET is created.

Returns:

the encoded SET of attributes

Throws:

CodingException - if an error occurs while building/encoding the SET

encodeAsAsn1SET

public byte[] encodeAsAsn1SET(boolean sorted)
                       throws CodingException

Builds and encodes an ASN.1 SET of the attributes included in this container. If this Attributes container has been created by parsing an ASN.1 SET the original encoding is returned. Otherwise a new SET is created.

Parameters:

sorted - whether to sort the elements of the SET when encoding it

Returns:

the encoded SET of attributes

Throws:

CodingException - if an error occurs while building/encoding the SET

encodeAsAsn1SEQUENCE

public byte[] encodeAsAsn1SEQUENCE(java.io.OutputStream os)
                            throws CodingException

Builds and encodes an ASN.1 SEQUENCE of the attributes included in this container. If this Attributes container has been created by parsing an ASN.1 SEQUENCE the original encoding is returned. Otherwise a new SEQUENCE is created.

Returns:

the encoded SEQUENCE of attributes

Throws:

CodingException - if an error occurs while building/encoding the SEQUENCE

toString

public java.lang.String toString()

Returns a string that lists all the Attributes hold in this container.

Overrides:

toString in class java.lang.Object

Returns:

the string representation