net.named_data.jndn.encoding.der

Class DerNode

java.lang.Object

net.named_data.jndn.encoding.der.DerNode

Direct Known Subclasses:

DerNode.DerBitString, DerNode.DerBoolean, DerNode.DerByteString, DerNode.DerExplicitlyTagged, DerNode.DerGeneralizedTime, DerNode.DerInteger, DerNode.DerNull, DerNode.DerOid, DerNode.DerStructure

public class DerNode
extends Object

DerNode implements the DER node types used in encoding/decoding DER-formatted data.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DerNode.DerBitString A DerBitString extends DerNode to handle a bit string.
static class	DerNode.DerBoolean DerBoolean extends DerNode to encode a boolean value.
static class	DerNode.DerByteString A DerByteString extends DerNode to handle byte strings.
static class	DerNode.DerExplicitlyTagged A DerExplicitlyTagged extends DerNode to represent an explicitly-tagged type which wraps another DerNode.
static class	DerNode.DerGeneralizedTime A DerGeneralizedTime extends DerNode to represent a date and time, with millisecond accuracy.
static class	DerNode.DerInteger DerInteger extends DerNode to encode an integer value.
static class	DerNode.DerNull A DerNull extends DerNode to encode a null value.
static class	DerNode.DerOctetString DerOctetString extends DerByteString to encode a string of bytes.
static class	DerNode.DerOid A DerOid extends DerNode to represent an object identifier
static class	DerNode.DerPrintableString A DerPrintableString extends DerByteString to handle a a printable string.
static class	DerNode.DerSequence A DerSequence extends DerStructure to contains an ordered sequence of other nodes.
static class	DerNode.DerStructure A DerStructure extends DerNode to hold other DerNodes.

Field Summary

Fields

Modifier and Type	Field and Description
protected ByteBuffer	header_
protected DerNode.DerStructure	parent_
protected DynamicByteBuffer	payload_

Method Summary

Modifier and Type	Method and Description
protected void	decode(ByteBuffer inputBuf, int startIdx) Decode and store the data from an input buffer.
protected int	decodeHeader(ByteBuffer inputBuf, int startIdx) Extract the header from an input buffer and return the size.
Blob	encode() Get the raw data encoding for this node.
protected void	encodeHeader(int size) Encode the given size and update the header.
List	getChildren() If this object is a DerSequence, get the children of this node.
Blob	getPayload() Get a copy of the payload bytes.
static DerNode.DerSequence	getSequence(List children, int index) Check that index is in bounds for the children list, cast children.get(index) to DerSequence and return it.
int	getSize()
static DerNode	parse(ByteBuffer inputBuf) Parse the data from the input buffer recursively and return the root as an object of a subclass of DerNode.
static DerNode	parse(ByteBuffer inputBuf, int startIdx) Parse the data from the input buffer recursively and return the root as an object of a subclass of DerNode.
Object	toVal() Convert the encoded data to a standard representation.

Methods inherited from class java.lang.Object

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

Field Detail

parent_

protected DerNode.DerStructure parent_

header_

protected ByteBuffer header_

payload_

protected DynamicByteBuffer payload_

Method Detail

getSize

public int getSize()

encodeHeader

protected final void encodeHeader(int size)

Encode the given size and update the header.

Parameters:

size - The payload size to encode.

decodeHeader

protected final int decodeHeader(ByteBuffer inputBuf,
                                 int startIdx)
                          throws DerDecodingException

Extract the header from an input buffer and return the size.

Parameters:

inputBuf - The input buffer to read from. This reads from startIdx (regardless of the buffer's position) and does not change the position.

startIdx - The offset into the buffer.

Returns:

The parsed size in the header.

Throws:

DerDecodingException

encode

public Blob encode()

Get the raw data encoding for this node.

Returns:

The raw data encoding.

decode

protected void decode(ByteBuffer inputBuf,
                      int startIdx)
               throws DerDecodingException

Decode and store the data from an input buffer.

Parameters:

inputBuf - The input buffer to read from. This reads from startIdx (regardless of the buffer's position) and does not change the position.

startIdx - The offset into the buffer.

Throws:

DerDecodingException

parse

public static DerNode parse(ByteBuffer inputBuf,
                            int startIdx)
                     throws DerDecodingException

Parse the data from the input buffer recursively and return the root as an object of a subclass of DerNode.

Parameters:

inputBuf - The input buffer to read from. This reads from startIdx (regardless of the buffer's position) and does not change the position.

startIdx - The offset into the buffer.

Returns:

An object of a subclass of DerNode.

Throws:

DerDecodingException

parse

public static DerNode parse(ByteBuffer inputBuf)
                     throws DerDecodingException

Parse the data from the input buffer recursively and return the root as an object of a subclass of DerNode.

Parameters:

inputBuf - The input buffer to read from. This reads from position and does not change the position.

Returns:

An object of a subclass of DerNode.

Throws:

DerDecodingException

toVal

public Object toVal()
             throws DerDecodingException

Convert the encoded data to a standard representation. Overridden by some subclasses (e.g. DerBoolean).

Returns:

The encoded data as a Blob.

Throws:

DerDecodingException

getPayload

public final Blob getPayload()

Get a copy of the payload bytes.

Returns:

A copy of the payload.

getChildren

public List getChildren()
                 throws DerDecodingException

If this object is a DerSequence, get the children of this node. Otherwise, throw an exception. (DerSequence overrides to implement this method.)

Returns:

The children as a List of DerNode.

Throws:

DerDecodingException - if this object is not a DerSequence.

getSequence

public static DerNode.DerSequence getSequence(List children,
                                              int index)
                                       throws DerDecodingException

Check that index is in bounds for the children list, cast children.get(index) to DerSequence and return it.

Parameters:

children - The list of DerNode, usually returned by another call to getChildren.

index - The index of the children.

Returns:

children.get(index) cast to DerSequence.

Throws:

DerDecodingException - if index is out of bounds or if children.get(index) is not a DerSequence.