iaik.asn1.structures

Class AccessDescription

java.lang.Object

iaik.asn1.structures.AccessDescription

All Implemented Interfaces:

ASN1Type

public class AccessDescription
extends java.lang.Object
implements ASN1Type

This class represents a AccessDescription to be used as parameter for creating a private internet extension of type "Authority Information Access".

ASN.1 definition:

 AuthorityInfoAccessSyntax  ::=
          SEQUENCE SIZE (1..MAX) OF AccessDescription
 AccessDescription  ::=  SEQUENCE {
          accessMethod          OBJECT IDENTIFIER,
          accessLocation        GeneralName  }
 

The PKIX profile already has defined one accessMethod OID, id-ad-caIssuers to be used when the additional information lists CAs that have issued certificates superior to the CA that issued the certificate containing this extension. The referenced CA Issuers description is intended to aid certificate users in the selection of a certification path that terminates at a point trusted by the certificate user.

More information can be found in the X.509 Certificate and CRL profile presented in RFC 3280, section 4.2.2.1 "AuthorityInfoAccess".

When creating a AccessDescription, the accessMethod OID and the accessLocation GeneralName has to be specified, e.g.:

 AccessDescription ad = new AccessDescription(ObjectID.caIssuers, new GeneralName(...));
 

See Also:

AuthorityInfoAccess

Constructor Summary

Constructors

Constructor and Description
AccessDescription() Default constructor.
AccessDescription(ASN1Object obj) Creates a new AccessDescription from an ASN1Object.
AccessDescription(ObjectID accessMethod, GeneralName accessLocation) Creates a new AccessDescription from the given Oid and GeneralName.

Method Summary

Modifier and Type	Method and Description
void	decode(ASN1Object obj) Decodes the given ASN.1 AccessDescription object for parsing the internal structure.
GeneralName	getAccessLocation() Returns the access location.
ObjectID	getAccessMethod() Returns the access method OID.
void	setAccessLocation(GeneralName accessLocation) Sets the access location.
void	setAccessMethod(ObjectID accessMethod) Sets the access method OID.
ASN1Object	toASN1Object() Returns this AccessDescription as ASN1Object.
java.lang.String	toString() Returns a string giving some information about this AccessDescription object.

Methods inherited from class java.lang.Object

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

Constructor Detail

AccessDescription

public AccessDescription()

Default constructor. Creates an empty AccessDescription.

AccessDescription

public AccessDescription(ObjectID accessMethod,
                         GeneralName accessLocation)
                  throws java.lang.IllegalArgumentException

Creates a new AccessDescription from the given Oid and GeneralName.

For instance:

 AccessDescription ad = new AccessDescription(ObjectID.caIssuers, new GeneralName(...));
 

Parameters:

accessMethod - the accessMethod OID

accessLocation - the accessLocation GeneralName

Throws:

InvalidArgumentException - if one of the arguments is null

java.lang.IllegalArgumentException

AccessDescription

public AccessDescription(ASN1Object obj)
                  throws CodingException

Creates a new AccessDescription from an ASN1Object.

The ASN1Object supplied to this constructor represents an already exisiting AccessDescription object that may have been created by calling toASN1Object

Parameters:

obj - the AccessDescription as ASN1Object

Throws:

CodingException - if the object can not be parsed

Method Detail

decode

public void decode(ASN1Object obj)
            throws CodingException

Decodes the given ASN.1 AccessDescription object for parsing the internal structure.

Specified by:

decode in interface ASN1Type

Parameters:

obj - the AccessDescription as ASN1Object

Throws:

CodingException - if the object can not be parsed

toASN1Object

public ASN1Object toASN1Object()
                        throws CodingException

Returns this AccessDescription as ASN1Object.

The ASN1Object returned by this method may be used as parameter value when creating a AccessDescription object using the AccessDescription(ASN1Object obj) constructor.

Specified by:

toASN1Object in interface ASN1Type

Returns:

this AccessDescription as ASN1Object.

Throws:

CodingException - if an de/encoding error occurs

getAccessMethod

public ObjectID getAccessMethod()

Returns the access method OID.

Returns:

the access method OID or null if not set

getAccessLocation

public GeneralName getAccessLocation()

Returns the access location.

Returns:

the access location as GeneralName or null if not set

setAccessMethod

public void setAccessMethod(ObjectID accessMethod)
                     throws java.lang.IllegalArgumentException

Sets the access method OID.

Parameters:

accessMethod - the access method OID

Throws:

InvalidArgumentException - if the argument is null

java.lang.IllegalArgumentException

setAccessLocation

public void setAccessLocation(GeneralName accessLocation)
                       throws java.lang.IllegalArgumentException

Sets the access location.

Parameters:

accessLocation - the access location as GeneralName

Throws:

InvalidArgumentException - if the argument is null

java.lang.IllegalArgumentException

toString

public java.lang.String toString()

Returns a string giving some information about this AccessDescription object.

Overrides:

toString in class java.lang.Object

Returns:

the string representation