TLV

java.lang.Object
- ch.fhnw.imvs.smartcard.TLV

```
public final class TLV
extends java.lang.Object
```
Immutable class representing a BERTLV-Formatted message. The constructor takes a bytearray, reads the data to fill the fields of this class and recursively create children as necessary.

Author:

Christof Arnosti (christof.arnosti@fhnw.ch)

Field Summary

Fields
Modifier and Type	Field and Description
`private java.util.List<TLV>`	`children` If this TLV has children: A List of children, null otherwise
`private static int`	`CLASS_APPLICATION`
`private static int`	`CLASS_CONTEXT`
`private static int`	`CLASS_MASK`
`private static int`	`CLASS_PRIVATE`
`private static int`	`CLASS_UNIVERSAL`
`private static int`	`CONSTRUCTED_MASK`
`private byte[]`	`content` If this TLV has no children: The content, null otherwise
`private boolean`	`hasChildren` Distinguish primitive from composed TLV
`private byte[]`	`header` Contains the header bytes
`private static int`	`IDENTIFIER_MASK`
`private static int`	`LENGTH_MASK`
`private int`	`lengthlength` Length of the Length part of the header
`private int`	`typelength` Length of the Type part of the header

Constructor Summary

Constructors
Constructor and Description
`TLV(byte[] data)` Default Constructor.
`TLV(byte[] data, int offset)` This constructor returns a TLV-Object representing the TLV-Formatted message at position `offset` in the `data` -bytearray.

Method Summary

Methods
Modifier and Type	Method and Description
`private void`	`addToStringBuilder(java.lang.StringBuilder sb, int indent)`
`private java.lang.String`	`bufToString(byte[] buf, int start, int len)`
`boolean`	`equals(java.lang.Object obj)` Equals based on the raw bytes which were used to create this TLV-Object.
`TLV`	`getChildByNumber(int number)` Get a child of the current TLV by the index, ordered by their occurence in the original bytearray.
`TLV`	`getChildByTag(byte[] header)` Get a specific child of this TLV, identified by its Type.
`java.util.List<TLV>`	`getChildren()` Returns an unmodifiable list containing all children of this TLV
`byte[]`	`getContent()` Returns a copy of the content (Value) of this TLV, if this TLV does not contain children.
`private java.lang.String`	`getContentDescription(int bytevalue)`
`byte[]`	`getHeader()` Returns a copy of the header of this TLV
`int`	`getLength()` Returns the length of the byte-representation of this TLV, including header and value.
`byte[]`	`getRaw()` Returns a bytearray containing the byte representation of this TLV.
`private int`	`getValueLength()` Returns the length of the value of this TLV as reported in the TLV header.
`java.lang.String`	`toString()` Human-readable representation of this TLV.

Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - CLASS_MASK
```
private static final int CLASS_MASK
```
    See Also:
    Constant Field Values
  - CLASS_UNIVERSAL
```
private static final int CLASS_UNIVERSAL
```
    See Also:
    Constant Field Values
  - CLASS_APPLICATION
```
private static final int CLASS_APPLICATION
```
    See Also:
    Constant Field Values
  - CLASS_CONTEXT
```
private static final int CLASS_CONTEXT
```
    See Also:
    Constant Field Values
  - CLASS_PRIVATE
```
private static final int CLASS_PRIVATE
```
    See Also:
    Constant Field Values
  - IDENTIFIER_MASK
```
private static final int IDENTIFIER_MASK
```
    See Also:
    Constant Field Values
  - LENGTH_MASK
```
private static final int LENGTH_MASK
```
    See Also:
    Constant Field Values
  - CONSTRUCTED_MASK
```
private static final int CONSTRUCTED_MASK
```
    See Also:
    Constant Field Values
  - header
```
private final byte[] header
```
    Contains the header bytes
  - children
```
private final java.util.List<TLV> children
```
    If this TLV has children: A List of children, null otherwise
  - content
```
private final byte[] content
```
    If this TLV has no children: The content, null otherwise
  - hasChildren
```
private final boolean hasChildren
```
    Distinguish primitive from composed TLV
  - typelength
```
private final int typelength
```
    Length of the Type part of the header
  - lengthlength
```
private final int lengthlength
```
    Length of the Length part of the header
- Constructor Detail
  - TLV
```
public TLV(byte[] data)
```
    Default Constructor. Tries to construct a TLV Object out of the data, starting with byte 0 until the end.
    
    Parameters:
    data - bytearray of TLV-Encoded Data
  - TLV
```
public TLV(byte[] data,
   int offset)
```
    This constructor returns a TLV-Object representing the TLV-Formatted message at position offset in the data -bytearray.
    
    Parameters:
    data - Bytearray containing the TLV-Coded message.
    offset - Start of the TLV-Formatted message in the data-bytearray.
    
    Throws:
    
    java.lang.IllegalArgumentException - If data
- Method Detail
  - getLength
```
public int getLength()
```
    Returns the length of the byte-representation of this TLV, including header and value.
    
    Returns:
    Length of this TLV.
  - getValueLength
```
private int getValueLength()
```
    Returns the length of the value of this TLV as reported in the TLV header.
    
    Returns:
    Length of the value.
  - getContent
```
public byte[] getContent()
```
    Returns a copy of the content (Value) of this TLV, if this TLV does not contain children.
    
    Returns:
    copy of the content.
    
    Throws:
    
    java.lang.IllegalStateException - If this TLV has children
  - getRaw
```
public byte[] getRaw()
```
    Returns a bytearray containing the byte representation of this TLV.
    
    Returns:
    bytearray containing this TLV.
  - getHeader
```
public byte[] getHeader()
```
    Returns a copy of the header of this TLV
    
    Returns:
    copy of the header.
  - getChildren
```
public java.util.List<TLV> getChildren()
```
    Returns an unmodifiable list containing all children of this TLV
    
    Returns:
    unmodifiable list of the children of this TLV
  - addToStringBuilder
```
private void addToStringBuilder(java.lang.StringBuilder sb,
                      int indent)
```
  - toString
```
public java.lang.String toString()
```
    Human-readable representation of this TLV.
    
    Overrides:
    
    toString in class java.lang.Object
  - getContentDescription
```
private java.lang.String getContentDescription(int bytevalue)
```
  - getChildByNumber
```
public TLV getChildByNumber(int number)
```
    Get a child of the current TLV by the index, ordered by their occurence in the original bytearray.
    
    Parameters:
    number - The Index of the child.
    
    Returns:
    The child TLV.
    
    Throws:
    
    java.lang.IllegalStateException - If this method was called on a TLV without children.
    
    java.lang.IndexOutOfBoundsException - If the index of the child is invalid.
  - getChildByTag
```
public TLV getChildByTag(byte[] header)
```
    Get a specific child of this TLV, identified by its Type.
    
    Parameters:
    header - A bytearray containing the type to search for.
    
    Returns:
    Specific child of the current TLV if the type matches the parameter, null otherwise
  - bufToString
```
private java.lang.String bufToString(byte[] buf,
                           int start,
                           int len)
```
  - equals
```
public boolean equals(java.lang.Object obj)
```
    Equals based on the raw bytes which were used to create this TLV-Object.
    
    Overrides:
    
    equals in class java.lang.Object

Class TLV

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

CLASS_MASK

CLASS_UNIVERSAL

CLASS_APPLICATION

CLASS_CONTEXT

CLASS_PRIVATE

IDENTIFIER_MASK

LENGTH_MASK

CONSTRUCTED_MASK

header

children

content

hasChildren

typelength

lengthlength

Constructor Detail

TLV

TLV

Method Detail

getLength

getValueLength

getContent

getRaw

getHeader

getChildren

addToStringBuilder

toString

getContentDescription

getChildByNumber

getChildByTag

bufToString

equals