ASN1InputStream (Bouncy Castle Library 1.54 API Specification)
Date: 2015-12-29

org.bouncycastle.asn1

## Class ASN1InputStream

- java.lang.Object
- - java.io.InputStream
  - - java.io.FilterInputStream
    - - org.bouncycastle.asn1.ASN1InputStream

- All Implemented Interfaces:
    java.io.Closeable, java.lang.AutoCloseable, BERTags

      public class ASN1InputStream
      extends java.io.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 inherited from class java.io.FilterInputStream

      `in`

    - ### Fields inherited from interface 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(java.io.InputStream is)`
    `ASN1InputStream(java.io.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(java.io.InputStream input, int limit)` Create an ASN1InputStream where no DER object will be longer than limit.
    `ASN1InputStream(java.io.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

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `protected ASN1Primitive` | `buildObject(int tag, int tagNo, int length)` build an object given its tag and the number of bytes to construct it from.
    `protected void` | `readFully(byte[] bytes)`
    `protected int` | `readLength()`
    `ASN1Primitive` | `readObject()`

    - ### 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`

- - ### Constructor Detail

    - #### ASN1InputStream

          public ASN1InputStream(java.io.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(java.io.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(java.io.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(java.io.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

    - #### readLength

          protected int readLength()
                            throws java.io.IOException

      Throws:
        `java.io.IOException`

    - #### readFully

          protected void readFully(byte[] bytes)
                            throws java.io.IOException

      Throws:
        `java.io.IOException`

    - #### buildObject

          protected ASN1Primitive buildObject(int tag,
                                  int tagNo,
                                  int length)
                                       throws java.io.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:
        `java.io.IOException` - on processing exception.

    - #### readObject

          public ASN1Primitive readObject()
                                   throws java.io.IOException

      Throws:
        `java.io.IOException`