iaik.x509.extensions.netscape

Class NetscapeCaPolicyUrl

java.lang.Object

iaik.x509.V3Extension

iaik.x509.extensions.netscape.NetscapeCaPolicyUrl

public class NetscapeCaPolicyUrl
extends V3Extension

This class implements the NetscapeCaPolicyUrl Extension.

Each Netscape certificate extension is associated with a specific certificateExtension object identifier, derived from:

 netscape OBJECT IDENTIFIER ::= { 2 16 840 1 113730 }
 netscape-cert-extension OBJECT IDENTIFIER :: = { netscape 1 }
 

The object identifier for the NetscapeCaPolicyUrl extension is defined as:

netscape-ca-policy-url OBJECT IDENTIFIER ::= { netscape-cert-extension 8 }

which corresponds to the OID string "2.16.840.1.113730.1.8".

The Netscape Certificate Specification specifies the NetscapeCaPolicyUrl extension as IA5String that represents a relative or absolute URL that points to a web page that describes the policies under which the certificate has been issued.

You may specify a particular (relative or absolute) URL directly when creating a NetscapeCaPolicyUrl extension, or you may use the default constructor and supply the URL by using the setCaPolicyUrl method, e.g.:

 NetscapeCaPolicyUrl netscapeCaPolicyUrl = new NetscapeCaPolicyUrl();
 netscapeCaPolicyUrl.setCaPolicyUrl("http://ca.test.com/policy/home.html");
 

Version:

File Revision 14

See Also:

V3Extension, X509Extensions, NetscapeBaseUrl

Field Summary

Fields

Modifier and Type	Field and Description
static ObjectID	oid The object ID of the X.509 extension NetscapeCaPolicyUrl.

Fields inherited from class iaik.x509.V3Extension

critical

Constructor Summary

Constructors

Constructor and Description
NetscapeCaPolicyUrl() Default constructor.
NetscapeCaPolicyUrl(java.lang.String url) Constructs a NetscapeCaPolicyUrl extension with a specified URL.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	getCaPolicyUrl() Returns the caPolicy url.
ObjectID	getObjectID() Returns the object ID of this NetscapeCaPolicyUrl extension
int	hashCode() Returns a hashcode for this identity.
void	init(ASN1Object obj) Inits this NetscapeCaPolicyUrl implementation with an ASN1object representing the value of this extension.
void	setCaPolicyUrl(java.lang.String url) Sets the caPolicy url.
ASN1Object	toASN1Object() Returns an ASN1Object representing the value of this NetscapeCaPolicyUrl extension object.
java.lang.String	toString() Returns a string that represents the contents of this NetscapeCaPolicyUrl extension.

Methods inherited from class iaik.x509.V3Extension

getName, isCritical, setCritical

Methods inherited from class java.lang.Object

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

Field Detail

oid

public static final ObjectID oid

The object ID of the X.509 extension NetscapeCaPolicyUrl.

Constructor Detail

NetscapeCaPolicyUrl

public NetscapeCaPolicyUrl()

Default constructor. Creates an empty NetscapeCaPolicyUrl object.

Use the setCaPolicyUrl method for specifying a particular (absolute or relative) URL value, e.g.:

 NetscapeCaPolicyUrl netscapeCaPolicyUrl = new NetscapeCaPolicyUrl();
 netscapeCaPolicyUrl.setCaPolicyUrl("http://ca.test.com/policy/home.html");
 

NetscapeCaPolicyUrl

public NetscapeCaPolicyUrl(java.lang.String url)

Constructs a NetscapeCaPolicyUrl extension with a specified URL.

The (absolute or relative) URL is given as a String value, for instance:

NetscapeCaPolicyUrl netscapeCaPolicyUrl = new NetscapeCaPolicyUrl("http://ca.test.com/policy/home.html");

Parameters:

url - the caPolicy URL, as String

Method Detail

getObjectID

public ObjectID getObjectID()

Returns the object ID of this NetscapeCaPolicyUrl extension

Specified by:

getObjectID in class V3Extension

Returns:

the object ID

init

public void init(ASN1Object obj)

Inits this NetscapeCaPolicyUrl implementation with an ASN1object representing the value of this extension.

The given ASN1Object represents the IA5STRING (absolute or relative) URL value.

The given ASN1Object is the one created by toASN1Object().

This method is used by the X509Extensions class when parsing the ASN.1 representation of a certificate for properly initializing an included NetscapeCaPolicyUrl extension. This method initializes the extension only with its value, but not with its critical specification. For that reason, this method shall not be explicitly called by an application.

Specified by:

init in class V3Extension

Parameters:

obj - the NetscapeCaPolicyUrl as ASN1Object

toASN1Object

public ASN1Object toASN1Object()

Returns an ASN1Object representing the value of this NetscapeCaPolicyUrl extension object.

The returned ASN1Object represents the IA5STRING (absolute or relative) URL value.

Specified by:

toASN1Object in class V3Extension

Returns:

the value of this NetscapeCaPolicyUrl as ASN1Object

setCaPolicyUrl

public void setCaPolicyUrl(java.lang.String url)

Sets the caPolicy url.

The (absolute or relative) URL value is given as String, e.g.:

 NetscapeCaPolicyUrl netscapeCaPolicyUrl = new NetscapeCaPolicyUrl();
 netscapeCaPolicyUrl.setCaPolicyUrl("http://ca.test.com/policy/home.html");
 

Parameters:

url - the caPolicy url

getCaPolicyUrl

public java.lang.String getCaPolicyUrl()

Returns the caPolicy url.

Returns:

the caPolicy url value as String

See Also:

setCaPolicyUrl(String)

hashCode

public int hashCode()

Returns a hashcode for this identity.

Specified by:

hashCode in class V3Extension

Returns:

a hash code for this identity

toString

public java.lang.String toString()

Returns a string that represents the contents of this NetscapeCaPolicyUrl extension.

Overrides:

toString in class java.lang.Object

Returns:

the string representation