com.objsys.asn1j.runtime

Class Asn1PerDecodeBuffer

java.lang.Object

com.objsys.asn1j.runtime.Asn1MessageBufferBase

com.objsys.asn1j.runtime.Asn1MessageBuffer

com.objsys.asn1j.runtime.Asn1DecodeBuffer

com.objsys.asn1j.runtime.Asn1DecodeBitBuffer

com.objsys.asn1j.runtime.Asn1PerDecodeBuffer

All Implemented Interfaces:

Asn1BitMessageBuffer, Asn1PerMessageBuffer

Direct Known Subclasses:

Asn1PerInputStream

public class Asn1PerDecodeBuffer
extends Asn1DecodeBitBuffer
implements Asn1PerMessageBuffer

This class handles the decoding of ASN.1 messages as specified in the Packed Encoding Rules (PER) as specified in the ITU-T X.691 standard.

Field Summary

Fields inherited from class com.objsys.asn1j.runtime.Asn1DecodeBitBuffer

mTraceHandler

Fields inherited from class com.objsys.asn1j.runtime.Asn1DecodeBuffer

mByteCount

Fields inherited from class com.objsys.asn1j.runtime.Asn1MessageBufferBase

context, mTypeCode

Constructor Summary

Constructors

Constructor and Description
Asn1PerDecodeBuffer(byte[] msgdata, boolean aligned) This constructor creates a PER decode buffer object that references an encoded ASN.1 message.
Asn1PerDecodeBuffer(java.io.InputStream istream, boolean aligned) This constructor creates a PER decode buffer object that references an encoded ASN.1 message.

Method Summary

Modifier and Type	Method and Description
void	byteAlign() This methods byte-aligns the buffer.
boolean	decodeBit() This method decodes a single bit value.
boolean	decodeBit(java.lang.String ident) This method decodes a single bit value.
int	decodeBitsToInt(int nbits) This method decodes bits from the input stream into a standard integer value.
int	decodeBitsToInt(int nbits, java.lang.String ident) This method decodes bits from the input stream into a standard integer value.
long	decodeBitsToLong(int nbits) This method decodes bits from the input stream into a long integer value.
long	decodeBitsToLong(int nbits, java.lang.String ident) This method decodes bits from the input stream into a long integer value.
void	decodeBitsToOctetArray(byte[] value, int offset, int nbits) This method decodes bits from the input stream into an array of octets.
void	decodeBitsToOctetArray(byte[] value, int offset, int bitOffset, int nbits, java.lang.String ident) This method decodes bits from the input stream into an array of octets.
void	decodeBitsToOctetArray(byte[] value, int offset, int nbits, java.lang.String ident) This method decodes bits from the input stream into an array of octets.
void	decodeCharString(int nchars, int abpc, int ubpc, Asn1CharSet charSet, java.lang.StringBuffer sbuf) This method decodes the contents of a known-multiplier character string.
long	decodeConsWholeNumber(long rangeValue) This method implements the rules to decode a constrained whole number as specified in section 10.5 of the X.691 standard.
long	decodeConsWholeNumber(long rangeValue, boolean retval, java.lang.String ident) This method implements the rules to decode a constrained whole number as specified in section 10.5 of the X.691 standard.
long	decodeConsWholeNumber(long rangeValue, java.lang.String ident) This method implements the rules to decode a constrained whole number as specified in section 10.5 of the X.691 standard.
long	decodeExtLength() This method decodes an extension length value.
long	decodeInt(int nocts, boolean signExtend) This method implements the rules to decode an unconstrained integer value.
long	decodeInt(int nocts, boolean signExtend, java.lang.String ident) This method implements the rules to decode an unconstrained integer value.
long	decodeLength() This method decodes either a constrained or unconstrained length depending on whether a size constraint object is set in this object.
long	decodeLength(long lower, long upper) This method decodes a constrained length determinant value.
int	decodeSmallLength() This method implements the rules to decode a normally small length as specified in section 11.9 of the X.691 standard.
int	decodeSmallNonNegWholeNumber() This method implements the rules to decode a small non-negative whole number as specified in section 10.6 of the X.691 standard.
long	decodeUnconsLength() This method decodes a general (unconstrained) length determinant value as described in section 10.9 of the 2008 X.691 standard.
boolean	isAligned() This method tests if PER alignment is turned on or off.
void	setAligned(boolean value) This method is used to turn PER aligned encoding on or off.
static Asn1PerDecodeBuffer	setBuffer(Asn1PerDecodeBuffer buffer, byte[] msgdata, boolean aligned) This method will create or reinitialize a PER decode message buffer object to read data from the given byte array.
void	setSizeConstraint(long lower, long upper) This method is used to set a size constraint within the buffer object.
void	setSizeConstraintExt(long lower, long upper, long extLower, long extUpper) This method is used to set an extensible size constraint within the buffer object.

Methods inherited from class com.objsys.asn1j.runtime.Asn1DecodeBitBuffer

binDump, binDump, decodeBitsToOctetArray, getAvailableBits, getBitOffset, getBitOffsetInByte, getMsgBitCnt, getTraceHandler, hasMoreBits, mark, moveBitCursor, readByte, reset, setInputStream, skipBits

Methods inherited from class com.objsys.asn1j.runtime.Asn1DecodeBuffer

addCaptureBuffer, capture, decodeIntValue, decodeOIDContents, decodeOIDContentsBig, decodeRelOIDContents, decodeRelOIDContentsBig, getByteCount, getInputStream, getLazyOpenTypeDecode, hexDump, init, read, read, read, read2Bytes, read4Bytes, removeCaptureBuffer, setLazyOpenTypeDecode, skip, skipOIDContents, skipRelOIDContents

Methods inherited from class com.objsys.asn1j.runtime.Asn1MessageBuffer

addNamedEventHandler, getEventHandlerListCount, hasEventHandlers, invokeCharacters, invokeEndElement, invokeStartElement, setEventHandlerList

Methods inherited from class com.objsys.asn1j.runtime.Asn1MessageBufferBase

getContext, hexDump, hexDump, setKey, setTypeCode

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.objsys.asn1j.runtime.Asn1BitMessageBuffer

getInputStream, getMsgBitCnt, getTraceHandler

Constructor Detail

Asn1PerDecodeBuffer

public Asn1PerDecodeBuffer(byte[] msgdata,
                           boolean aligned)

This constructor creates a PER decode buffer object that references an encoded ASN.1 message.

Parameters:

msgdata - Byte array containing an encoded ASN.1 message.

aligned - Boolean specifying PER aligned or unaligned encoding.

Asn1PerDecodeBuffer

public Asn1PerDecodeBuffer(java.io.InputStream istream,
                           boolean aligned)

This constructor creates a PER decode buffer object that references an encoded ASN.1 message. In this case, the message is passed in using an InputStream object.

Parameters:

istream - Input stream containing an encoded ASN.1 message.

aligned - Boolean specifying PER aligned or unaligned encoding.

Method Detail

byteAlign

public void byteAlign()

This methods byte-aligns the buffer. If the buffer was created unaligned, this does nothing.

Specified by:

byteAlign in interface Asn1BitMessageBuffer

Overrides:

byteAlign in class Asn1DecodeBitBuffer

decodeBit

public boolean decodeBit(java.lang.String ident)
                  throws Asn1EndOfBufferException,
                         java.io.IOException

This method decodes a single bit value.

Parameters:

ident - Bit field identifier name for tracing.

Returns:

Boolean value of bit that was decoded.

Throws:

Asn1EndOfBufferException

java.io.IOException

decodeBit

public boolean decodeBit()
                  throws Asn1EndOfBufferException,
                         java.io.IOException

This method decodes a single bit value. The ident argument which is used for tracing is defaulted to 'value'.

Overrides:

decodeBit in class Asn1DecodeBitBuffer

Returns:

Boolean value of bit that was decoded.

Throws:

Asn1EndOfBufferException

java.io.IOException

decodeBitsToLong

public long decodeBitsToLong(int nbits,
                             java.lang.String ident)
                      throws Asn1Exception,
                             java.io.IOException

This method decodes bits from the input stream into a long integer value. Up to 64 bits can be decoded. The bits are placed in the least-significant bytes of the long integer.

Parameters:

nbits - Number of bits to decode

ident - Bit field identifier name for tracing.

Returns:

Long integer value containing decoded bits

Throws:

Asn1Exception

java.io.IOException

decodeBitsToLong

public long decodeBitsToLong(int nbits)
                      throws Asn1Exception,
                             java.io.IOException

This method decodes bits from the input stream into a long integer value. Up to 64 bits can be decoded. The bits are placed in the least-significant bytes of the long integer. The ident argument which is used for tracing is defaulted to 'value'.

Overrides:

decodeBitsToLong in class Asn1DecodeBitBuffer

Parameters:

nbits - Number of bits to decode

Returns:

Long integer value containing decoded bits

Throws:

Asn1Exception

java.io.IOException

decodeBitsToInt

public int decodeBitsToInt(int nbits,
                           java.lang.String ident)
                    throws Asn1Exception,
                           java.io.IOException

This method decodes bits from the input stream into a standard integer value. Up to 32 bits can be decoded. The bits are placed in the least-significant bytes of the integer.

Parameters:

nbits - Number of bits to decode

ident - Bit field identifier name for tracing.

Returns:

Integer value containing decoded bits

Throws:

Asn1Exception

java.io.IOException

decodeBitsToInt

public int decodeBitsToInt(int nbits)
                    throws Asn1Exception,
                           java.io.IOException

This method decodes bits from the input stream into a standard integer value. Up to 32 bits can be decoded. The bits are placed in the least-significant bytes of the integer. The ident argument which is used for tracing is defaulted to 'value'.

Overrides:

decodeBitsToInt in class Asn1DecodeBitBuffer

Parameters:

nbits - Number of bits to decode

Returns:

Integer value containing decoded bits

Throws:

Asn1Exception

java.io.IOException

decodeBitsToOctetArray

public void decodeBitsToOctetArray(byte[] value,
                                   int offset,
                                   int nbits,
                                   java.lang.String ident)
                            throws Asn1Exception,
                                   java.io.IOException

This method decodes bits from the input stream into an array of octets. The user is expected to have provided an array large enough to hold the number of bits requested to be decoded.

Parameters:

value - Octet array for decoded data

offset - Starting byte offset into array

nbits - Number of bits to decode

ident - Bit field identifier name for tracing, or null.

Throws:

Asn1Exception

java.io.IOException

decodeBitsToOctetArray

public void decodeBitsToOctetArray(byte[] value,
                                   int offset,
                                   int bitOffset,
                                   int nbits,
                                   java.lang.String ident)
                            throws Asn1Exception,
                                   java.io.IOException

This method decodes bits from the input stream into an array of octets. The user is expected to have provided an array large enough to hold the number of bits requested to be decoded. The first bit is decoded into the given offset byte at the MSB if bitOffset == 0, and at the LSB if bitOffset == 7.

Parameters:

value - Octet array for decoded data

offset - Starting byte offset into array

bitOffset - Where in first byte the first bit goes

nbits - Number of bits to decode

ident - Bit field identifier name for tracing, or null.

Throws:

Asn1Exception

java.io.IOException

decodeBitsToOctetArray

public void decodeBitsToOctetArray(byte[] value,
                                   int offset,
                                   int nbits)
                            throws Asn1Exception,
                                   java.io.IOException

This method decodes bits from the input stream into an array of octets. The user is expected to have provided an array large enough to hold the number of bits requested to be decoded. The ident argument which is used for tracing is defaulted to 'value'.

Overrides:

decodeBitsToOctetArray in class Asn1DecodeBitBuffer

Parameters:

value - Octet array for decoded data

offset - Starting byte offset into array

nbits - Number of bits to decode

Throws:

Asn1Exception

java.io.IOException

decodeCharString

public void decodeCharString(int nchars,
                             int abpc,
                             int ubpc,
                             Asn1CharSet charSet,
                             java.lang.StringBuffer sbuf)
                      throws Asn1Exception,
                             java.io.IOException

This method decodes the contents of a known-multiplier character string. This version of the method assumes a permitted alphabet constraint is in place.

Parameters:

nchars - Number of characters

abpc - Number of bits per character (aligned)

ubpc - Number of bits per character (unaligned)

charSet - Object representing the permitted alphabet constraint character set (optional)

sbuf - If not null, string buffer to receive decoded result

Throws:

Asn1Exception

java.io.IOException

decodeConsWholeNumber

public long decodeConsWholeNumber(long rangeValue,
                                  java.lang.String ident)
                           throws Asn1Exception,
                                  java.io.IOException

This method implements the rules to decode a constrained whole number as specified in section 10.5 of the X.691 standard.

Parameters:

rangeValue - upper - lower + 1. If a negative value is passed, it will be interpreted as an unsigned integer. If 0 is given, it will be interpreted as 2^64.

ident - Tracing identifier

Returns:

Decoded adjusted value = value - lower range endpoint value.

Throws:

Asn1Exception

java.io.IOException

decodeConsWholeNumber

public long decodeConsWholeNumber(long rangeValue,
                                  boolean retval,
                                  java.lang.String ident)
                           throws Asn1Exception,
                                  java.io.IOException

This method implements the rules to decode a constrained whole number as specified in section 10.5 of the X.691 standard.

Parameters:

rangeValue - upper - lower + 1. If a negative value is passed, it will be interpreted as an unsigned integer. If 0 is given, it will be interpreted as 2^64.

retval - If true, return decoded adjusted value; else return 0.

ident - Tracing identifier

Returns:

0 or decoded adjusted value = value - lower range endpoint value.

Throws:

Asn1Exception

java.io.IOException

decodeConsWholeNumber

public long decodeConsWholeNumber(long rangeValue)
                           throws Asn1Exception,
                                  java.io.IOException

This method implements the rules to decode a constrained whole number as specified in section 10.5 of the X.691 standard. The ident argument which is used for tracing is defaulted to 'value'.

Parameters:

rangeValue - upper - lower + 1. If a negative value is passed, it will be interpreted as an unsigned integer. If 0 is given, it will be interpreted as 2^64.

Returns:

Decoded adjusted value = value - lower range endpoint value

Throws:

Asn1Exception

java.io.IOException

decodeExtLength

public long decodeExtLength()
                     throws Asn1Exception,
                            java.io.IOException

This method decodes an extension length value. Note that the decoded length is not what is returned. The bit offset to the start of the next element within the decode buffer is returned.

Returns:

Bit offset to next element in buffer

Throws:

Asn1Exception

java.io.IOException

decodeInt

public long decodeInt(int nocts,
                      boolean signExtend,
                      java.lang.String ident)
               throws Asn1Exception,
                      java.io.IOException

This method implements the rules to decode an unconstrained integer value.

Parameters:

nocts - Number of octets to decode

signExtend - Sign extend resulting value?

ident - Tracing identifier

Returns:

Decoded long integer value

Throws:

Asn1Exception

java.io.IOException

decodeInt

public long decodeInt(int nocts,
                      boolean signExtend)
               throws Asn1Exception,
                      java.io.IOException

This method implements the rules to decode an unconstrained integer value. The ident argument which is used for tracing is defaulted to 'value'.

Parameters:

nocts - Number of octets to decode

signExtend - Sign extend resulting value?

Returns:

Decoded long integer value

Throws:

Asn1Exception

java.io.IOException

decodeLength

public long decodeLength()
                  throws Asn1Exception,
                         java.io.IOException

This method decodes either a constrained or unconstrained length depending on whether a size constraint object is set in this object.

Returns:

Decoded length value.

Throws:

Asn1Exception

java.io.IOException

decodeUnconsLength

public long decodeUnconsLength()
                        throws Asn1Exception,
                               java.io.IOException

This method decodes a general (unconstrained) length determinant value as described in section 10.9 of the 2008 X.691 standard. The maximum value that will be returned is 64K which is the largest length fragment size defined for PER. If a value of 16K or larger is returned, the user must repeat this call to fully decode the fragmented contents.

Returns:

Decoded length value. If the returned value is >= 16k, this indicates a fragmented length was decoded. The user must call this method again after the data fragment is decoded to get the next fragment length.

Throws:

Asn1Exception

java.io.IOException

decodeLength

public long decodeLength(long lower,
                         long upper)
                  throws Asn1Exception,
                         java.io.IOException

This method decodes a constrained length determinant value. If upper >= 64K, it is possible that the data has been fragmented. If this is the case and this method returns >= 16K, then there will be another length encoded following the current chunk.

Parameters:

lower - Lower bound (inclusive) of length value range

upper - Upper bound (inclusive) of length value range

Returns:

Decoded length value

Throws:

Asn1Exception

java.io.IOException

decodeSmallLength

public int decodeSmallLength()
                      throws Asn1Exception,
                             java.io.IOException

This method implements the rules to decode a normally small length as specified in section 11.9 of the X.691 standard.

Throws:

Asn1Exception

java.io.IOException

decodeSmallNonNegWholeNumber

public int decodeSmallNonNegWholeNumber()
                                 throws Asn1Exception,
                                        java.io.IOException

This method implements the rules to decode a small non-negative whole number as specified in section 10.6 of the X.691 standard.

Throws:

Asn1Exception

java.io.IOException

isAligned

public boolean isAligned()

This method tests if PER alignment is turned on or off.

Specified by:

isAligned in interface Asn1PerMessageBuffer

setAligned

public void setAligned(boolean value)

This method is used to turn PER aligned encoding on or off.

Parameters:

value - Boolean specifying PER aligned (true) or unaligned encoding (false).

setBuffer

public static Asn1PerDecodeBuffer setBuffer(Asn1PerDecodeBuffer buffer,
                                            byte[] msgdata,
                                            boolean aligned)

This method will create or reinitialize a PER decode message buffer object to read data from the given byte array. If the existing buffer reference is null, a new buffer will be created; otherwise, the existing buffer will be reused.

Parameters:

buffer - Existing message buffer object

msgdata - Byte array containing message data

aligned - Boolean specifying PER aligned or unaligned encoding.

setSizeConstraint

public void setSizeConstraint(long lower,
                              long upper)

This method is used to set a size constraint within the buffer object. The constraint will only be set if an existing constraint is not already in place (i.e. if the existing reference is not null). This is used for length decoding of SEQUENCE OF objects to pass constraints applied to referenced objects to the base object.

Parameters:

lower - Lower bound of root constraint

upper - Upper bound of root constraint

setSizeConstraintExt

public void setSizeConstraintExt(long lower,
                                 long upper,
                                 long extLower,
                                 long extUpper)

This method is used to set an extensible size constraint within the buffer object. The constraint will only be set if an existing constraint is not already in place (i.e. if the existing reference is not null). This is used for length encoding of SEQUENCE OF objects to pass constraints applied to referenced objects to the base object.

Parameters:

lower - Lower bound of root constraint

upper - Upper bound of root constraint

extLower - Lower bound of extension constraint

extUpper - Upper bound of extension constraint