to top

Summary: Ctors | Methods | Inherited Methods | [Expand All]

Added in API level 1

public abstract class

X509Certificate

extends Certificate

java.lang.Object
↳	javax.security.cert.Certificate
	↳	javax.security.cert.X509Certificate

Class Overview

Abstract base class for X.509 certificates.

This represents a standard way for accessing the attributes of X.509 v1 certificates.

Note: This package is provided only for compatibility reasons. It contains a simplified version of the java.security.cert package that was previously used by JSSE (Java SSL package). All applications that do not have to be compatible with older versions of JSSE (that is before Java SDK 1.5) should only use java.security.cert.

Summary

Public Constructors
	X509Certificate() Creates a new `X509Certificate`.

Public Methods
abstract void	checkValidity() Checks whether the certificate is currently valid.
abstract void	checkValidity( Date date) Checks whether the certificate is valid at the specified date.
final static X509Certificate	getInstance( InputStream inStream) Creates a new `X509Certificate` and initializes it from the specified input stream.
final static X509Certificate	getInstance(byte[] certData) Creates a new `X509Certificate` and initializes it from the specified byte array.
abstract Principal	getIssuerDN() Returns the `issuer` (issuer distinguished name) as an implementation specific `Principal` object.
abstract Date	getNotAfter() Returns the `notAfter` date of the validity period of the certificate.
abstract Date	getNotBefore() Returns the `notBefore` date from the validity period of the certificate.
abstract BigInteger	getSerialNumber() Returns the `serialNumber` of the certificate.
abstract String	getSigAlgName() Returns the name of the algorithm for the certificate signature.
abstract String	getSigAlgOID() Returns the OID of the signature algorithm from the certificate.
abstract byte[]	getSigAlgParams() Returns the parameters of the signature algorithm in DER-encoded format.
abstract Principal	getSubjectDN() Returns the `subject` (subject distinguished name) as an implementation specific `Principal` object.
abstract int	getVersion() Returns the certificates `version` (version number).

[Expand]

Inherited Methods

From class javax.security.cert.Certificate

boolean	equals( Object obj) Compares the argument to this Certificate.
abstract byte[]	getEncoded() Returns the encoded representation for this certificate.
abstract PublicKey	getPublicKey() Returns the public key corresponding to this certificate.
int	hashCode() Returns an integer hash code for the receiver.
abstract String	toString() Returns a string containing a concise, human-readable description of the receiver.
abstract void	verify( PublicKey key, String sigProvider) Verifies that this certificate was signed with the given public key.
abstract void	verify( PublicKey key) Verifies that this certificate was signed with the given public key.

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals( Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

Public Constructors

public X509Certificate ()

Added in API level 1

Creates a new X509Certificate.

Public Methods

public abstract void checkValidity ()

Added in API level 1

Checks whether the certificate is currently valid.

The validity defined in ASN.1:

 validity             Validity

 Validity ::= SEQUENCE {
      notBefore       CertificateValidityDate,
      notAfter        CertificateValidityDate }

 CertificateValidityDate ::= CHOICE {
      utcTime         UTCTime,
      generalTime     GeneralizedTime }

Throws

CertificateExpiredException	if the certificate has expired.
CertificateNotYetValidException	if the certificate is not yet valid.

public abstract void checkValidity (Date date)

Added in API level 1

Checks whether the certificate is valid at the specified date.

Parameters

date	the date to check the validity against.

Throws

CertificateExpiredException	if the certificate has expired.
CertificateNotYetValidException	if the certificate is not yet valid.

public static final X509Certificate getInstance (InputStream inStream)

Added in API level 1

Creates a new X509Certificate and initializes it from the specified input stream.

Parameters

inStream	input stream containing data to initialize the certificate.

Returns

the certificate initialized from the specified input stream

Throws

CertificateException	if the certificate cannot be created or initialized.

public static final X509Certificate getInstance (byte[] certData)

Added in API level 1

Creates a new X509Certificate and initializes it from the specified byte array.

Parameters

certData	byte array containing data to initialize the certificate.

Returns

the certificate initialized from the specified byte array

Throws

CertificateException	if the certificate cannot be created or initialized.

public abstract Principal getIssuerDN ()

Added in API level 1

Returns the issuer (issuer distinguished name) as an implementation specific Principal object.

The ASN.1 definition of issuer:

  issuer      Name

  Name ::= CHOICE {
      RDNSequence }

    RDNSequence ::= SEQUENCE OF RelativeDistinguishedName

    RelativeDistinguishedName ::= SET OF AttributeTypeAndValue

    AttributeTypeAndValue ::= SEQUENCE {
      type     AttributeType,
      value    AttributeValue }

    AttributeType ::= OBJECT IDENTIFIER

    AttributeValue ::= ANY DEFINED BY AttributeType

Returns

the issuer as an implementation specific Principal.

public abstract Date getNotAfter ()

Added in API level 1

Returns the notAfter date of the validity period of the certificate.

Returns

the end of the validity period.

public abstract Date getNotBefore ()

Added in API level 1

Returns the notBefore date from the validity period of the certificate.

Returns

the start of the validity period.

public abstract BigInteger getSerialNumber ()

Added in API level 1

Returns the serialNumber of the certificate.

The ASN.1 definition of serialNumber:

 CertificateSerialNumber  ::=  INTEGER

Returns

the serial number.

public abstract String getSigAlgName ()

Added in API level 1

Returns the name of the algorithm for the certificate signature.

Returns

the signature algorithm name.

public abstract String getSigAlgOID ()

Added in API level 1

Returns the OID of the signature algorithm from the certificate.

Returns

the OID of the signature algorithm.

public abstract byte[] getSigAlgParams ()

Added in API level 1

Returns the parameters of the signature algorithm in DER-encoded format.

Returns

the parameters of the signature algorithm, or null if none are used.

public abstract Principal getSubjectDN ()

Added in API level 1

Returns the subject (subject distinguished name) as an implementation specific Principal object.

The ASN.1 definition of subject:

 subject      Name

  Name ::= CHOICE {
      RDNSequence }

    RDNSequence ::= SEQUENCE OF RelativeDistinguishedName

    RelativeDistinguishedName ::= SET OF AttributeTypeAndValue

    AttributeTypeAndValue ::= SEQUENCE {
      type     AttributeType,
      value    AttributeValue }

    AttributeType ::= OBJECT IDENTIFIER

    AttributeValue ::= ANY DEFINED BY AttributeType

Returns

the subject (subject distinguished name).

public abstract int getVersion ()

Added in API level 1

Returns the certificates version (version number).

The version defined is ASN.1:

 Version ::=  INTEGER  {  v1(0), v2(1), v3(2)  }

Returns

the version number.

Results

Classes

Exceptions

X509Certificate

Class Overview

Summary

Public Constructors

public X509Certificate ()

Public Methods

public abstract void checkValidity ()

Throws

public abstract void checkValidity (Date date)

Parameters

Throws

See Also

public static final X509Certificate getInstance (InputStream inStream)

Parameters

Returns

Throws

public static final X509Certificate getInstance (byte[] certData)

Parameters

Returns

Throws

public abstract Principal getIssuerDN ()

Returns

public abstract Date getNotAfter ()

Returns

public abstract Date getNotBefore ()

Returns

public abstract BigInteger getSerialNumber ()

Returns

public abstract String getSigAlgName ()

Returns

public abstract String getSigAlgOID ()

Returns

public abstract byte[] getSigAlgParams ()

Returns

public abstract Principal getSubjectDN ()

Returns

public abstract int getVersion ()

Returns