X509Extension (Oracle® Fusion Middleware Java API Reference for Oracle Security Developer Tools)

java.lang.Object
- oracle.security.crypto.cert.X509Extension

All Implemented Interfaces:

java.io.Externalizable, java.io.Serializable

Direct Known Subclasses:

AcceptableResponseTypeExtension, ArchiveCutOffExtension, AuthorityInfoAccessExtension, AuthorityKeyIDExtension, BasicConstraintsExtension, CertificatePoliciesExtension, CRLCertificateIssuerExtension, CRLDistPointExtension, CRLHoldInstructionExtension, CRLInvalidityDateExtension, CRLNumberExtension, CRLReasonExtension, CRLReferenceExtension, DeltaCRLIndicatorExtension, ExtKeyUsageExtension, IssuerAltNameExtension, IssuingDistPointExtension, KeyUsageExtension, NameConstraintsExtension, NetscapeCertTypeExtension, NoCheckExtension, NonceExtension, PolicyConstraintsExtension, ServiceLocatorExtension, SubjectAltNameExtension, SubjectKeyIDExtension
```
public class X509Extension
extends java.lang.Object
implements 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

Fields
Modifier and Type	Field and Description
`static ASN1ObjectID`	`id_netscape_ce` The Netscape certificate extensions OID prefix.
`static ASN1ObjectID`	`id_netscape_ce_type` The Netscape certificate type extension OID.
`static ASN1ObjectID`	`id_set_ce` The SET certificate extensions OID prefix.
`static 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

Constructors
Modifier	Constructor and Description
	`X509Extension()` Creates a new empty instance.
`protected`	`X509Extension(ASN1ObjectID type)`
	`X509Extension(ASN1ObjectID type, ASN1Object value)` Creates a new X.509 extension with the given ID and value.
`protected`	`X509Extension(ASN1ObjectID type, boolean critical)`
	`X509Extension(ASN1ObjectID type, boolean critical, ASN1Object value)` Creates a new X.509 extension with the given ID and value.
	`X509Extension(ASN1ObjectID type, boolean critical, byte[] value)` Creates a new X.509 extension with the given ID and value.
	`X509Extension(ASN1ObjectID type, byte[] value)` Creates a new X.509 extension with the given ID and value.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`getCritical()` Indicates whether this extension is critical.
`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 ASN1ObjectID id_netscape_ce
```
    The Netscape certificate extensions OID prefix.
  - id_netscape_ce_type
```
public static final ASN1ObjectID id_netscape_ce_type
```
    The Netscape certificate type extension OID.
  - id_set_ce
```
public static final ASN1ObjectID id_set_ce
```
    The SET certificate extensions OID prefix.
  - id_set_ce_type
```
public static final 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(ASN1ObjectID type)
```
  - X509Extension
```
protected X509Extension(ASN1ObjectID type,
                        boolean critical)
```
  - X509Extension
```
public X509Extension(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(ASN1ObjectID type,
                     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(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(ASN1ObjectID type,
                     boolean critical,
                     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.
- 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 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.
    
    Throws:
    
    java.io.IOException
  - input
```
public void input(java.io.InputStream is)
           throws java.io.IOException
```
    Read from the specified input stream.
    
    Throws:
    
    java.io.IOException
  - length
```
public int length()
```
    Returns length of ASN.1 encoding.
  - 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

Class X509Extension

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

id_netscape_ce

id_netscape_ce_type

id_set_ce

id_set_ce_type

isDecoded

Constructor Detail

X509Extension

X509Extension

X509Extension

X509Extension

X509Extension

X509Extension

X509Extension

Method Detail

inputInstance

isRecognized

getType

getCritical

setCritical

getValue

setValue

output

input

length

toString

writeExternal

readExternal