Skip navigation links

Oracle Fusion Middleware Security Engine Java API Reference for Oracle Security Developer Tools
11g Release 1 (11.1.1)

E10674-01


oracle.security.crypto.cert
Class X509Extension

java.lang.Object
  extended by oracle.security.crypto.cert.X509Extension

All Implemented Interfaces:
java.io.Externalizable, java.io.Serializable, oracle.security.crypto.asn1.ASN1Object, oracle.security.crypto.util.Streamable
Direct Known Subclasses:
AuthorityInfoAccessExtension, AuthorityKeyIDExtension, BasicConstraintsExtension, CertificatePoliciesExtension, CRLCertificateIssuerExtension, CRLDistPointExtension, CRLHoldInstructionExtension, CRLInvalidityDateExtension, CRLNumberExtension, CRLReasonExtension, DeltaCRLIndicatorExtension, ExtKeyUsageExtension, IssuerAltNameExtension, IssuingDistPointExtension, KeyUsageExtension, NameConstraintsExtension, NetscapeCertTypeExtension, PolicyConstraintsExtension, SubjectAltNameExtension, SubjectKeyIDExtension

public class X509Extension
extends java.lang.Object
implements oracle.security.crypto.asn1.ASN1Object, java.io.Externalizable

An X.509 certificate or CRL extension.

An X.509 extensions consists of an ID which is an ASN.1 object identifier which indicates the type of the extension, together with a value, which is the DER encoding of an ASN.1 object, and a flag which indicates whether the extension is critical.

See Also:
X509, CRL, Serialized Form

Field Summary
static oracle.security.crypto.asn1.ASN1ObjectID id_netscape_ce
          The Netscape certificate extensions OID prefix.
static oracle.security.crypto.asn1.ASN1ObjectID id_netscape_ce_type
          The Netscape certificate type extension OID.
static oracle.security.crypto.asn1.ASN1ObjectID id_set_ce
          The SET certificate extensions OID prefix.
static oracle.security.crypto.asn1.ASN1ObjectID id_set_ce_type
          The SET certificate type extension OID.
protected  boolean isDecoded
          For use by subclasses that decode the DER-encoded byte array value.

 

Constructor Summary
  X509Extension()
          Creates a new empty instance.
protected X509Extension(oracle.security.crypto.asn1.ASN1ObjectID type)
           
  X509Extension(oracle.security.crypto.asn1.ASN1ObjectID type, oracle.security.crypto.asn1.ASN1Object value)
          Creates a new X.509 extension with the given ID and value.
protected X509Extension(oracle.security.crypto.asn1.ASN1ObjectID type, boolean critical)
           
  X509Extension(oracle.security.crypto.asn1.ASN1ObjectID type, boolean critical, oracle.security.crypto.asn1.ASN1Object value)
          Creates a new X.509 extension with the given ID and value.
  X509Extension(oracle.security.crypto.asn1.ASN1ObjectID type, boolean critical, byte[] value)
          Creates a new X.509 extension with the given ID and value.
  X509Extension(oracle.security.crypto.asn1.ASN1ObjectID type, byte[] value)
          Creates a new X.509 extension with the given ID and value.
  X509Extension(java.io.InputStream is)
          Creates a new X.509 extension by reading its encoding from the given input stream.

 

Method Summary
 boolean getCritical()
          Indicates whether this extension is critical.
 oracle.security.crypto.asn1.ASN1ObjectID getType()
           
 byte[] getValue()
          Returns the value of this extension.
 void input(java.io.InputStream is)
          Read from the specified input stream.
static X509Extension inputInstance(java.io.InputStream is)
          Instantiates a X509Extension or one of its sub-classes by reading its contents from the given input stream.
 boolean isRecognized()
          Returns true if this object's type is a recognized, specific sub-class of X509Extension, otherwise false.
 int length()
          Returns length of ASN.1 encoding.
 void output(java.io.OutputStream os)
          Output to the specified output stream.
 void readExternal(java.io.ObjectInput is)
           
protected  void setCritical(boolean critical)
          Sets if yes or not this extension is critical.
protected  void setValue(byte[] value)
          Sets the value of this extension.
 java.lang.String toString()
          Returns a string representation of this object.
 void writeExternal(java.io.ObjectOutput os)
           

 

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

 

Field Detail

id_netscape_ce

public static final oracle.security.crypto.asn1.ASN1ObjectID id_netscape_ce
The Netscape certificate extensions OID prefix.

id_netscape_ce_type

public static final oracle.security.crypto.asn1.ASN1ObjectID id_netscape_ce_type
The Netscape certificate type extension OID.

id_set_ce

public static final oracle.security.crypto.asn1.ASN1ObjectID id_set_ce
The SET certificate extensions OID prefix.

id_set_ce_type

public static final oracle.security.crypto.asn1.ASN1ObjectID id_set_ce_type
The SET certificate type extension OID.

isDecoded

protected boolean isDecoded
For use by subclasses that decode the DER-encoded byte array value. Should always be false for an instance of the X509Extension superclass.

Constructor Detail

X509Extension

public X509Extension()
Creates a new empty instance. This constructor is to be used with serialization or with the input method.

X509Extension

protected X509Extension(oracle.security.crypto.asn1.ASN1ObjectID type)

X509Extension

protected X509Extension(oracle.security.crypto.asn1.ASN1ObjectID type,
                        boolean critical)

X509Extension

public X509Extension(oracle.security.crypto.asn1.ASN1ObjectID type,
                     byte[] value)
Creates a new X.509 extension with the given ID and value. The extension will not be marked critical.
Parameters:
type - The ID which identifies the type of the extension.
value - The value of this extension. This should be the DER encoding of an ASN.1 object.

X509Extension

public X509Extension(oracle.security.crypto.asn1.ASN1ObjectID type,
                     oracle.security.crypto.asn1.ASN1Object value)
Creates a new X.509 extension with the given ID and value. The extension will not be marked critical.
Parameters:
type - The ID which identifies the type of the extension.
value - The value of this extension.

X509Extension

public X509Extension(oracle.security.crypto.asn1.ASN1ObjectID type,
                     boolean critical,
                     byte[] value)
Creates a new X.509 extension with the given ID and value.
Parameters:
type - The ID which identifies the type of the extension.
critical - true if this extension is critical, otherwise false
value - The value of this extension. This should be the DER encoding of an ASN.1 object.

X509Extension

public X509Extension(oracle.security.crypto.asn1.ASN1ObjectID type,
                     boolean critical,
                     oracle.security.crypto.asn1.ASN1Object value)
Creates a new X.509 extension with the given ID and value.
Parameters:
type - The ID which identifies the type of the extension.
critical - true if this extension is critical, otherwise false
value - The value of this extension.

X509Extension

public X509Extension(java.io.InputStream is)
              throws java.io.IOException
Creates a new X.509 extension by reading its encoding from the given input stream.
Parameters:
is - the input stream
Throws:
java.io.IOException

Method Detail

inputInstance

public static X509Extension inputInstance(java.io.InputStream is)
                                   throws java.io.IOException
Instantiates a X509Extension or one of its sub-classes by reading its contents from the given input stream.
Parameters:
is - input stream containing the extension.
Returns:
returns an instance of the appropriate sub-class of X509Extension if the input extension's type/OID is known, otherwise returns an instance of X509Extension.
Throws:
java.io.IOException - if an error occurs reading from the input stream or instantiating the extension object.

isRecognized

public boolean isRecognized()
Returns true if this object's type is a recognized, specific sub-class of X509Extension, otherwise false.

getType

public oracle.security.crypto.asn1.ASN1ObjectID getType()

getCritical

public boolean getCritical()
Indicates whether this extension is critical.

setCritical

protected void setCritical(boolean critical)
Sets if yes or not this extension is critical.

getValue

public byte[] getValue()
Returns the value of this extension.

setValue

protected void setValue(byte[] value)
Sets the value of this extension.

output

public void output(java.io.OutputStream os)
            throws java.io.IOException
Output to the specified output stream.
Specified by:
output in interface oracle.security.crypto.util.Streamable
Throws:
java.io.IOException

input

public void input(java.io.InputStream is)
           throws java.io.IOException
Read from the specified input stream.
Specified by:
input in interface oracle.security.crypto.util.Streamable
Throws:
java.io.IOException

length

public int length()
Returns length of ASN.1 encoding.
Specified by:
length in interface oracle.security.crypto.util.Streamable

toString

public java.lang.String toString()
Returns a string representation of this object.
Overrides:
toString in class java.lang.Object
Returns:
a string representation

writeExternal

public void writeExternal(java.io.ObjectOutput os)
                   throws java.io.IOException
Specified by:
writeExternal in interface java.io.Externalizable
Throws:
java.io.IOException

readExternal

public void readExternal(java.io.ObjectInput is)
                  throws java.io.IOException,
                         java.lang.ClassNotFoundException
Specified by:
readExternal in interface java.io.Externalizable
Throws:
java.io.IOException
java.lang.ClassNotFoundException

Skip navigation links

Oracle Fusion Middleware Security Engine Java API Reference for Oracle Security Developer Tools
11g Release 1 (11.1.1)

E10674-01


Copyright © 2005, 2009, Oracle. All rights reserved.