iaik.x509.extensions.netscape
Class NetscapeCaRevocationUrl

java.lang.Object
  |
  +--iaik.x509.V3Extension
        |
        +--iaik.x509.extensions.netscape.NetscapeCaRevocationUrl

public class NetscapeCaRevocationUrl
extends V3Extension

This class implements the NetscapeCaRevocationUrl 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 NetscapeCaRevocationUrl extension is defined as:

netscape-ca-revocation-url OBJECT IDENTIFIER ::= { netscape-cert-extension 4 }

which corresponds to the OID string "2.16.840.1.113730.1.4".

The Netscape Certificate Specification specifies the NetscapeCaRevocationUrl extension as IA5String that represents a relative or absolute URL that can be used to check the revocation status of any certificates that are signed by the CA that this certificate belongs to. This extension is only valid in CA certificates. The use of this extension is the same as the netscape-revocation-url extension.

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

 NetscapeCaRevocationUrl netscapeCaRevocationUrl = new NetscapeCaRevocationUrl();
 netscapeCaRevocationUrl.setCaRevocationUrl("cgi-bin/check-rev.cgi?");
 

Version:
File Revision 14
See Also:
V3Extension, X509Extensions, NetscapeRevocationUrl, NetscapeBaseUrl

Field Summary
static ObjectID oid
          The object ID of the X.509 extension NetscapeCaRevocationUrl.
 
Fields inherited from class iaik.x509.V3Extension
critical
 
Constructor Summary
NetscapeCaRevocationUrl()
          Default constructor.
NetscapeCaRevocationUrl(String url)
          Constructs a NetscapeCaRevocationUrl extension with a specified URL.
 
Method Summary
 String getCaRevocationUrl()
          Returns the caRevocation url.
 ObjectID getObjectID()
          Returns the object ID of this NetscapeCaRevocationUrl extension
 int hashCode()
          Returns a hashcode for this identity.
 void init(ASN1Object obj)
          Inits this NetscapeCaRevocationUrl implementation with an ASN1object representing the value of this extension.
 void setCaRevocationUrl(String url)
          Sets the caRevocation url.
 ASN1Object toASN1Object()
          Returns an ASN1Object representing the value of this NetscapeCaRevocationUrl extension object.
 String toString()
          Returns a string that represents the contents of this NetscapeCaRevocationUrl 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 ObjectID oid
The object ID of the X.509 extension NetscapeCaRevocationUrl.
Constructor Detail

NetscapeCaRevocationUrl

public NetscapeCaRevocationUrl()
Default constructor. Creates an empty NetscapeCaRevocationUrl object.

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

 NetscapeCaRevocationUrl netscapeCaRevocationUrl = new NetscapeCaRevocationUrl();
 netscapeCaRevocationUrl.setCaRevocationUrl("cgi-bin/check-rev.cgi?");
 


NetscapeCaRevocationUrl

public NetscapeCaRevocationUrl(String url)
Constructs a NetscapeCaRevocationUrl extension with a specified URL.

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

NetscapeCaRevocationUrl netscapeCaRevocationUrl = new NetscapeCaRevocationUrl("cgi-bin/check-rev.cgi?");

Parameters:
url - the caRevocation URL, as String
Method Detail

getObjectID

public ObjectID getObjectID()
Returns the object ID of this NetscapeCaRevocationUrl extension
Overrides:
getObjectID in class V3Extension
Returns:
the object ID

init

public void init(ASN1Object obj)
Inits this NetscapeCaRevocationUrl 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 NetscapeCaRevocationUrl 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.

Overrides:
init in class V3Extension
Parameters:
obj - the NetscapeCaRevocationUrl as ASN1Object

toASN1Object

public ASN1Object toASN1Object()
Returns an ASN1Object representing the value of this NetscapeCaRevocationUrl extension object.

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

Overrides:
toASN1Object in class V3Extension
Returns:
the value of this NetscapeCaRevocationUrl as ASN1Object

setCaRevocationUrl

public void setCaRevocationUrl(String url)
Sets the caRevocation url.

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

 NetscapeCaRevocationUrl netscapeCaRevocationUrl = new NetscapeCaRevocationUrl();
 netscapeCaRevocationUrl.setCaRevocationUrl("cgi-bin/check-rev.cgi?");
 

Parameters:
url - the caRevocation url, as String

getCaRevocationUrl

public String getCaRevocationUrl()
Returns the caRevocation url.
Returns:
the caRevocation url value as String
See Also:
setCaRevocationUrl(java.lang.String)

hashCode

public int hashCode()
Returns a hashcode for this identity.
Overrides:
hashCode in class V3Extension
Returns:
a hash code for this identity

toString

public String toString()
Returns a string that represents the contents of this NetscapeCaRevocationUrl extension.
Overrides:
toString in class Object
Returns:
the string representation

This Javadoc may contain text parts from Internet Standard specifications (RFC 2459, 3280, 3039, 2560, 1521, 821, 822, 2253, 1319, 1321, ,2630, 2631, 2268, 3058, 2984, 2104, 2144, 2040, 2311, 2279, see copyright note) and RSA Data Security Public-Key Cryptography Standards (PKCS#1,3,5,7,8,9,10,12, see copyright note).

IAIK-JCE 3.1 with IAIK-JCE CC Core 3.1, (c) 1997-2004 IAIK