sun.security.x509

Class CertificateValidity

java.lang.Object

sun.security.x509.CertificateValidity

All Implemented Interfaces:

CertAttrSet<java.lang.String>

public class CertificateValidity
extends java.lang.Object
implements CertAttrSet<java.lang.String>

This class defines the interval for which the certificate is valid.

Author:

Amit Kapoor, Hemma Prafullchandra

See Also:

CertAttrSet

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	IDENT Identifier for this attribute, to be used with the get, set, delete methods of Certificate, x509 type.
static java.lang.String	NAME Sub attributes name for this CertAttrSet.
static java.lang.String	NOT_AFTER
static java.lang.String	NOT_BEFORE

Constructor Summary

Constructors

Constructor and Description
CertificateValidity() Default constructor for the class.
CertificateValidity(java.util.Date notBefore, java.util.Date notAfter) The default constructor for this class for the specified interval.
CertificateValidity(DerInputStream in) Create the object, decoding the values from the passed DER stream.

Method Summary

Methods

Modifier and Type	Method and Description
void	delete(java.lang.String name) Delete the attribute value.
void	encode(java.io.OutputStream out) Encode the CertificateValidity period in DER form to the stream.
java.lang.Object	get(java.lang.String name) Get the attribute value.
java.util.Enumeration<java.lang.String>	getElements() Return an enumeration of names of attributes existing within this attribute.
java.lang.String	getName() Return the name of this attribute.
void	set(java.lang.String name, java.lang.Object obj) Set the attribute value.
java.lang.String	toString() Return the validity period as user readable string.
void	valid() Verify that the current time is within the validity period.
void	valid(java.util.Date now) Verify that the passed time is within the validity period.

Methods inherited from class java.lang.Object

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

Field Detail

IDENT

public static final java.lang.String IDENT

Identifier for this attribute, to be used with the get, set, delete methods of Certificate, x509 type.

See Also:

Constant Field Values

NAME

public static final java.lang.String NAME

Sub attributes name for this CertAttrSet.

See Also:

Constant Field Values

NOT_BEFORE

public static final java.lang.String NOT_BEFORE

See Also:

Constant Field Values

NOT_AFTER

public static final java.lang.String NOT_AFTER

See Also:

Constant Field Values

Constructor Detail

CertificateValidity

public CertificateValidity()

Default constructor for the class.

CertificateValidity

public CertificateValidity(java.util.Date notBefore,
                   java.util.Date notAfter)

The default constructor for this class for the specified interval.

Parameters:

notBefore - the date and time before which the certificate is not valid.

notAfter - the date and time after which the certificate is not valid.

CertificateValidity

public CertificateValidity(DerInputStream in)
                    throws java.io.IOException

Create the object, decoding the values from the passed DER stream.

Parameters:

in - the DerInputStream to read the CertificateValidity from.

Throws:

java.io.IOException - on decoding errors.

Method Detail

toString

public java.lang.String toString()

Return the validity period as user readable string.

Specified by:

toString in interface CertAttrSet<java.lang.String>

Overrides:

toString in class java.lang.Object

Returns:

value of this certificate attribute in printable form.

encode

public void encode(java.io.OutputStream out)
            throws java.io.IOException

Encode the CertificateValidity period in DER form to the stream.

Specified by:

encode in interface CertAttrSet<java.lang.String>

Parameters:

out - the OutputStream to marshal the contents to.

Throws:

java.io.IOException - on errors.

set

public void set(java.lang.String name,
       java.lang.Object obj)
         throws java.io.IOException

Set the attribute value.

Specified by:

set in interface CertAttrSet<java.lang.String>

Parameters:

name - the name of the attribute (e.g. "x509.info.key")

obj - the attribute object.

Throws:

java.io.IOException - on other errors.

get

public java.lang.Object get(java.lang.String name)
                     throws java.io.IOException

Get the attribute value.

Specified by:

get in interface CertAttrSet<java.lang.String>

Parameters:

name - the name of the attribute to return.

Throws:

java.io.IOException - on other errors.

delete

public void delete(java.lang.String name)
            throws java.io.IOException

Delete the attribute value.

Specified by:

delete in interface CertAttrSet<java.lang.String>

Parameters:

name - the name of the attribute to delete.

Throws:

java.io.IOException - on other errors.

getElements

public java.util.Enumeration<java.lang.String> getElements()

Return an enumeration of names of attributes existing within this attribute.

Specified by:

getElements in interface CertAttrSet<java.lang.String>

Returns:

an enumeration of the attribute names.

getName

public java.lang.String getName()

Return the name of this attribute.

Specified by:

getName in interface CertAttrSet<java.lang.String>

Returns:

the name of this CertAttrSet.

valid

public void valid()
           throws java.security.cert.CertificateNotYetValidException,
                  java.security.cert.CertificateExpiredException

Verify that the current time is within the validity period.

Throws:

java.security.cert.CertificateExpiredException - if the certificate has expired.

java.security.cert.CertificateNotYetValidException - if the certificate is not yet valid.

valid

public void valid(java.util.Date now)
           throws java.security.cert.CertificateNotYetValidException,
                  java.security.cert.CertificateExpiredException

Verify that the passed time is within the validity period.

Parameters:

now - the Date against which to compare the validity period.

Throws:

java.security.cert.CertificateExpiredException - if the certificate has expired with respect to the Date supplied.

java.security.cert.CertificateNotYetValidException - if the certificate is not yet valid with respect to the Date supplied.