NetscapeCertRenewalUrl ("Entrust Authority Security Toolkit for the Java Platform")

java.lang.Object
- iaik.x509.V3Extension
- - iaik.x509.extensions.netscape.NetscapeCertRenewalUrl

```
public class NetscapeCertRenewalUrl
extends V3Extension
```
This class implements the NetscapeCertRenewalUrl Extension, supported by Netscape Communicator 4.0 and may be supported by Preliminary Navigator 3.0.
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 NetscapeCertRenewalUrl extension is defined as:
netscape-cert-renewal-url OBJECT IDENTIFIER ::= { netscape-cert-extension 7 }
which corresponds to the OID string "2.16.840.1.113730.1.7".
The Netscape Certificate Specification specifies the NetscapeCertRenewalUrl extension as IA5String that represents a relative or absolute URL that points to a certificate renewal form. The renewal form will be accessed with an HTTP GET method using a url that is the concatenation of renewal-url and certificate-serial-number, where the certificate-serial-number is encoded as a string consisting of an even number of ascii hexadecimal digits. If the number of significant digits is odd, the string will have a single leading zero to ensure an even number of digits is generated. For example, if the netscape-base-url is https://www.certs-r-us.com/, the netscape-cert-renwal-url is cgi-bin/check-renew.cgi?, and the certificate serial number is 173420, the resulting URL would be:
https://www.certs-r-us.com/cgi-bin/check-renew.cgi?02a56c
The document returned should be an HTML form that will allow the user to request a renewal of their certificate.
You may specify a particular (relative or absolute) URL directly when creating a NetscapeCertRenewalUrl extension, or you may use the default constructor and supply the URL by using the a setCertRenewalUrl method, e.g.:
```
 NetscapeCertRenewalUrl netscapeCertRenewalUrl = new NetscapeCertRenewalUrl();
 netscapeCertRenewalUrl.setCertRenewalUrl("cgi-bin/check-renew.cgi?");
 
```
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 NetscapeCertRenewalUrl.
- Fields inherited from class iaik.x509.V3Extension
  critical

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

Constructor Summary

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

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`java.lang.String`	`getCertRenewalUrl()` Returns the certRenewal url.
`ObjectID`	`getObjectID()` Returns the object ID of this `NetscapeCertRenewalUrl` extension
`int`	`hashCode()` Returns a hashcode for this identity.
`void`	`init(ASN1Object obj)` Inits this `NetscapeCertRenewalUrl` implementation with an ASN1object representing the value of this extension.
`void`	`setCertRenewalUrl(java.lang.String url)` Sets the certRenewal url.
`ASN1Object`	`toASN1Object()` Returns an ASN1Object representing the value of this `NetscapeCertRenewalUrl` extension object.
`java.lang.String`	`toString()` Returns a string that represents the contents of this `NetscapeCertRenewalUrl` 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 NetscapeCertRenewalUrl.
- Constructor Detail
  - NetscapeCertRenewalUrl
```
public NetscapeCertRenewalUrl()
```
    Default constructor. Creates an empty NetscapeCertRenewalUrl object.
    Use the setCertRenewalUrl method for specifying a particular (absolute or relative) URL value, e.g.:
```
 NetscapeCertRenewalUrl netscapeCertRenewalUrl = new NetscapeCertRenewalUrl();
 netscapeCertRenewalUrl.setCertRenewalUrl("cgi-bin/check-renew.cgi?");
 
```
  - NetscapeCertRenewalUrl
```
public NetscapeCertRenewalUrl(java.lang.String url)
```
    Constructs a NetscapeCertRenewalUrl extension with a specified URL.
    The (absolute or relative) URL is given as a String value, for instance:
    NetscapeCertRenewalUrl netscapeCertRenewalUrl = new NetscapeCertRenewalUrl("cgi-bin/check-renew.cgi?");
    
    Parameters:
    
    url - the certRenewal URL, as String
- Method Detail
  - getObjectID
```
public ObjectID getObjectID()
```
    Returns the object ID of this NetscapeCertRenewalUrl extension
    
    Specified by:
    
    getObjectID in class V3Extension
    
    Returns:
    
    the object ID
  - init
```
public void init(ASN1Object obj)
```
    Inits this NetscapeCertRenewalUrl 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 NetscapeCertRenewalUrl 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 NetscapeCertRenewalUrl as ASN1Object
  - toASN1Object
```
public ASN1Object toASN1Object()
```
    Returns an ASN1Object representing the value of this NetscapeCertRenewalUrl extension object.
    The returned ASN1Object represents the IA5STRING (absolute or relative) URL value.
    
    Specified by:
    
    toASN1Object in class V3Extension
    
    Returns:
    
    the value of this NetscapeCertRenewalUrl as ASN1Object
  - setCertRenewalUrl
```
public void setCertRenewalUrl(java.lang.String url)
```
    Sets the certRenewal url.
    The (absolute or relative) URL value is given as String, e.g.:
```
 NetscapeCertRenewalUrl netscapeCertRenewalUrl = new NetscapeCertRenewalUrl();
 netscapeCertRenewalUrl.setCertRenewalUrl("cgi-bin/check-renew.cgi?");
 
```
    Parameters:
    
    url - the certRenewal url value, as String
  - getCertRenewalUrl
```
public java.lang.String getCertRenewalUrl()
```
    Returns the certRenewal url.
    
    Returns:
    
    the certRenewal url value as String
    
    See Also:
    
    setCertRenewalUrl(java.lang.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 NetscapeCertRenewalUrl extension.
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
    
    the string representation

Class NetscapeCertRenewalUrl

Field Summary

Fields inherited from class iaik.x509.V3Extension

Constructor Summary

Method Summary

Methods inherited from class iaik.x509.V3Extension

Methods inherited from class java.lang.Object

Field Detail

oid

Constructor Detail

NetscapeCertRenewalUrl

NetscapeCertRenewalUrl

Method Detail

getObjectID

init

toASN1Object

setCertRenewalUrl

getCertRenewalUrl

hashCode

toString