org.apache.commons.ssl.org.bouncycastle.asn1

Class ASN1InputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

org.apache.commons.ssl.org.bouncycastle.asn1.ASN1InputStream

All Implemented Interfaces:

Closeable, AutoCloseable, BERTags

public class ASN1InputStream
extends FilterInputStream
implements BERTags

a general purpose ASN.1 decoder - note: this class differs from the others in that it returns null after it has read the last object in the stream. If an ASN.1 NULL is encountered a DER/BER Null object is returned.

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	lazyEvaluate
private int	limit
private byte[][]	tmpBuffers

Fields inherited from class java.io.FilterInputStream

in

Fields inherited from interface org.apache.commons.ssl.org.bouncycastle.asn1.BERTags

APPLICATION, BIT_STRING, BMP_STRING, BOOLEAN, CONSTRUCTED, ENUMERATED, EXTERNAL, GENERAL_STRING, GENERALIZED_TIME, GRAPHIC_STRING, IA5_STRING, INTEGER, NULL, NUMERIC_STRING, OBJECT_IDENTIFIER, OCTET_STRING, PRINTABLE_STRING, SEQUENCE, SEQUENCE_OF, SET, SET_OF, T61_STRING, TAGGED, UNIVERSAL_STRING, UTC_TIME, UTF8_STRING, VIDEOTEX_STRING, VISIBLE_STRING

Constructor Summary

Constructors

Constructor and Description
ASN1InputStream(byte[] input) Create an ASN1InputStream based on the input byte array.
ASN1InputStream(byte[] input, boolean lazyEvaluate) Create an ASN1InputStream based on the input byte array.
ASN1InputStream(InputStream is)
ASN1InputStream(InputStream input, boolean lazyEvaluate) Create an ASN1InputStream where no DER object will be longer than limit, and constructed objects such as sequences will be parsed lazily.
ASN1InputStream(InputStream input, int limit) Create an ASN1InputStream where no DER object will be longer than limit.
ASN1InputStream(InputStream input, int limit, boolean lazyEvaluate) Create an ASN1InputStream where no DER object will be longer than limit, and constructed objects such as sequences will be parsed lazily.

Method Summary

Modifier and Type	Method and Description
(package private) ASN1EncodableVector	buildDEREncodableVector(DefiniteLengthInputStream dIn)
(package private) ASN1EncodableVector	buildEncodableVector()
protected ASN1Primitive	buildObject(int tag, int tagNo, int length) build an object given its tag and the number of bytes to construct it from.
(package private) static ASN1Primitive	createPrimitiveDERObject(int tagNo, DefiniteLengthInputStream defIn, byte[][] tmpBuffers)
private static char[]	getBMPCharBuffer(DefiniteLengthInputStream defIn)
private static byte[]	getBuffer(DefiniteLengthInputStream defIn, byte[][] tmpBuffers)
(package private) int	getLimit()
protected void	readFully(byte[] bytes)
protected int	readLength()
(package private) static int	readLength(InputStream s, int limit)
ASN1Primitive	readObject()
(package private) static int	readTagNumber(InputStream s, int tag)

Methods inherited from class java.io.FilterInputStream

available, close, mark, markSupported, read, read, read, reset, skip

Methods inherited from class java.lang.Object

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

Field Detail

limit

private final int limit

lazyEvaluate

private final boolean lazyEvaluate

tmpBuffers

private final byte[][] tmpBuffers

Constructor Detail

ASN1InputStream

public ASN1InputStream(InputStream is)

ASN1InputStream

public ASN1InputStream(byte[] input)

Create an ASN1InputStream based on the input byte array. The length of DER objects in the stream is automatically limited to the length of the input array.

Parameters:

input - array containing ASN.1 encoded data.

ASN1InputStream

public ASN1InputStream(byte[] input,
                       boolean lazyEvaluate)

Create an ASN1InputStream based on the input byte array. The length of DER objects in the stream is automatically limited to the length of the input array.

Parameters:

input - array containing ASN.1 encoded data.

lazyEvaluate - true if parsing inside constructed objects can be delayed.

ASN1InputStream

public ASN1InputStream(InputStream input,
                       int limit)

Create an ASN1InputStream where no DER object will be longer than limit.

Parameters:

input - stream containing ASN.1 encoded data.

limit - maximum size of a DER encoded object.

ASN1InputStream

public ASN1InputStream(InputStream input,
                       boolean lazyEvaluate)

Create an ASN1InputStream where no DER object will be longer than limit, and constructed objects such as sequences will be parsed lazily.

Parameters:

input - stream containing ASN.1 encoded data.

lazyEvaluate - true if parsing inside constructed objects can be delayed.

ASN1InputStream

public ASN1InputStream(InputStream input,
                       int limit,
                       boolean lazyEvaluate)

Create an ASN1InputStream where no DER object will be longer than limit, and constructed objects such as sequences will be parsed lazily.

Parameters:

input - stream containing ASN.1 encoded data.

limit - maximum size of a DER encoded object.

lazyEvaluate - true if parsing inside constructed objects can be delayed.

Method Detail

getLimit

int getLimit()

readLength

protected int readLength()
                  throws IOException

Throws:

IOException

readFully

protected void readFully(byte[] bytes)
                  throws IOException

Throws:

IOException

buildObject

protected ASN1Primitive buildObject(int tag,
                                    int tagNo,
                                    int length)
                             throws IOException

build an object given its tag and the number of bytes to construct it from.

Parameters:

tag - the full tag details.

tagNo - the tagNo defined.

length - the length of the object.

Returns:

the resulting primitive.

Throws:

IOException - on processing exception.

buildEncodableVector

ASN1EncodableVector buildEncodableVector()
                                  throws IOException

Throws:

IOException

buildDEREncodableVector

ASN1EncodableVector buildDEREncodableVector(DefiniteLengthInputStream dIn)
                                     throws IOException

Throws:

IOException

readObject

public ASN1Primitive readObject()
                         throws IOException

Throws:

IOException

readTagNumber

static int readTagNumber(InputStream s,
                         int tag)
                  throws IOException

Throws:

IOException

readLength

static int readLength(InputStream s,
                      int limit)
               throws IOException

Throws:

IOException

getBuffer

private static byte[] getBuffer(DefiniteLengthInputStream defIn,
                                byte[][] tmpBuffers)
                         throws IOException

Throws:

IOException

getBMPCharBuffer

private static char[] getBMPCharBuffer(DefiniteLengthInputStream defIn)
                                throws IOException

Throws:

IOException

createPrimitiveDERObject

static ASN1Primitive createPrimitiveDERObject(int tagNo,
                                              DefiniteLengthInputStream defIn,
                                              byte[][] tmpBuffers)
                                       throws IOException

Throws:

IOException