Extension
interface Extension
java.security.cert.Extension |
This interface represents an X.509 extension.
Extensions provide a means of associating additional attributes with users or public keys and for managing a certification hierarchy. The extension format also allows communities to define private extensions to carry information unique to those communities.
Each extension contains an object identifier, a criticality setting indicating whether it is a critical or a non-critical extension, and and an ASN.1 DER-encoded value. Its ASN.1 definition is:
Extension ::= SEQUENCE { extnId OBJECT IDENTIFIER, critical BOOLEAN DEFAULT FALSE, extnValue OCTET STRING -- contains a DER encoding of a value -- of the type registered for use with -- the extnId object identifier value }
This interface is designed to provide access to a single extension, unlike java.security.cert.X509Extension
which is more suitable for accessing a set of extensions.
Summary
Public methods | |
---|---|
abstract Unit |
encode(out: OutputStream!) Generates the extension's DER encoding and writes it to the output stream. |
abstract String! |
getId() Gets the extensions's object identifier. |
abstract ByteArray! |
getValue() Gets the extensions's DER-encoded value. |
abstract Boolean |
Gets the extension's criticality setting. |
Public methods
encode
abstract fun encode(out: OutputStream!): Unit
Generates the extension's DER encoding and writes it to the output stream.
Parameters | |
---|---|
out |
OutputStream!: the output stream |
Exceptions | |
---|---|
java.io.IOException |
on encoding or output error. |
java.lang.NullPointerException |
if out is null . |
getId
abstract fun getId(): String!
Gets the extensions's object identifier.
Return | |
---|---|
String! |
the object identifier as a String |
getValue
abstract fun getValue(): ByteArray!
Gets the extensions's DER-encoded value. Note, this is the bytes that are encoded as an OCTET STRING. It does not include the OCTET STRING tag and length.
Return | |
---|---|
ByteArray! |
a copy of the extension's value, or null if no extension value is present. |
isCritical
abstract fun isCritical(): Boolean
Gets the extension's criticality setting.
Return | |
---|---|
Boolean |
true if this is a critical extension. |