net.named_data.jndn.encoding

Class Tlv0_1_1WireFormat

java.lang.Object

net.named_data.jndn.encoding.WireFormat

net.named_data.jndn.encoding.Tlv0_1_1WireFormat

Direct Known Subclasses:

Tlv0_1WireFormat, TlvWireFormat

public class Tlv0_1_1WireFormat
extends WireFormat

A Tlv0_1_1WireFormat implements the WireFormat interface for encoding and decoding with the NDN-TLV wire format, version 0.1.1.

Field Summary

Fields inherited from class net.named_data.jndn.encoding.WireFormat

ENABLE_NDNX

Constructor Summary

Constructors

Constructor and Description
Tlv0_1_1WireFormat()

Method Summary

Methods

Modifier and Type	Method and Description
void	decodeControlParameters(ControlParameters controlParameters, ByteBuffer input) Decode input as a control parameters in NDN-TLV and set the fields of the controlParameters object.
void	decodeData(Data data, ByteBuffer input, int[] signedPortionBeginOffset, int[] signedPortionEndOffset) Decode input as a data packet in NDN-TLV and set the fields in the data object.
void	decodeInterest(Interest interest, ByteBuffer input, int[] signedPortionBeginOffset, int[] signedPortionEndOffset) Decode input as an interest in NDN-TLV and set the fields of the interest object.
void	decodeLocalControlHeader(LocalControlHeader localControlHeader, ByteBuffer input) Decode input as a LocalControlHeader in NDN-TLV and set the fields of the localControlHeader object.
void	decodeName(Name name, ByteBuffer input) Decode input as a name in NDN-TLV and set the fields of the interest object.
Signature	decodeSignatureInfoAndValue(ByteBuffer signatureInfo, ByteBuffer signatureValue) Decode signatureInfo as an NDN-TLV signature info and signatureValue as the related NDN-TLV SignatureValue, and return a new object which is a subclass of Signature.
Blob	encodeControlParameters(ControlParameters controlParameters) Encode controlParameters in NDN-TLV and return the encoding.
Blob	encodeData(Data data, int[] signedPortionBeginOffset, int[] signedPortionEndOffset) Encode data in NDN-TLV and return the encoding.
Blob	encodeInterest(Interest interest, int[] signedPortionBeginOffset, int[] signedPortionEndOffset) Encode interest using NDN-TLV and return the encoding.
Blob	encodeLocalControlHeader(LocalControlHeader localControlHeader) Encode the LocalControlHeader in NDN-TLV and return the encoding.
Blob	encodeName(Name name) Encode name in NDN-TLV and return the encoding.
Blob	encodeSignatureInfo(Signature signature) Encode signature as a SignatureInfo in NDN-TLV and return the encoding.
Blob	encodeSignatureValue(Signature signature) Encode the signatureValue in the Signature object as a SignatureValue (the signature bits) in NDN-TLV and return the encoding.
static Tlv0_1_1WireFormat	get() Get a singleton instance of a Tlv1_0a2WireFormat.

Methods inherited from class net.named_data.jndn.encoding.WireFormat

decodeData, decodeForwardingEntry, decodeInterest, encodeData, encodeForwardingEntry, encodeInterest, getDefaultWireFormat, setDefaultWireFormat

Methods inherited from class java.lang.Object

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

Constructor Detail

Tlv0_1_1WireFormat

public Tlv0_1_1WireFormat()

Method Detail

encodeName

public Blob encodeName(Name name)

Encode name in NDN-TLV and return the encoding.

Overrides:

encodeName in class WireFormat

Parameters:

name - The Name object to encode.

Returns:

A Blob containing the encoding.

decodeName

public void decodeName(Name name,
              ByteBuffer input)
                throws EncodingException

Decode input as a name in NDN-TLV and set the fields of the interest object.

Overrides:

decodeName in class WireFormat

Parameters:

name - The Name object whose fields are updated.

input - The input buffer to decode. This reads from position() to limit(), but does not change the position.

Throws:

EncodingException - For invalid encoding.

encodeInterest

public Blob encodeInterest(Interest interest,
                  int[] signedPortionBeginOffset,
                  int[] signedPortionEndOffset)

Encode interest using NDN-TLV and return the encoding.

Overrides:

encodeInterest in class WireFormat

Parameters:

interest - The Interest object to encode.

signedPortionBeginOffset - Return the offset in the encoding of the beginning of the signed portion. The signed portion starts from the first name component and ends just before the final name component (which is assumed to be a signature for a signed interest).

signedPortionEndOffset - Return the offset in the encoding of the end of the signed portion. The signed portion starts from the first name component and ends just before the final name component (which is assumed to be a signature for a signed interest).

Returns:

A Blob containing the encoding.

decodeInterest

public void decodeInterest(Interest interest,
                  ByteBuffer input,
                  int[] signedPortionBeginOffset,
                  int[] signedPortionEndOffset)
                    throws EncodingException

Decode input as an interest in NDN-TLV and set the fields of the interest object.

Overrides:

decodeInterest in class WireFormat

Parameters:

interest - The Interest object whose fields are updated.

input - The input buffer to decode. This reads from position() to limit(), but does not change the position.

signedPortionBeginOffset - Return the offset in the encoding of the beginning of the signed portion. The signed portion starts from the first name component and ends just before the final name component (which is assumed to be a signature for a signed interest).

signedPortionEndOffset - Return the offset in the encoding of the end of the signed portion. The signed portion starts from the first name component and ends just before the final name component (which is assumed to be a signature for a signed interest).

Throws:

EncodingException - For invalid encoding.

encodeData

public Blob encodeData(Data data,
              int[] signedPortionBeginOffset,
              int[] signedPortionEndOffset)

Encode data in NDN-TLV and return the encoding.

Overrides:

encodeData in class WireFormat

Parameters:

data - The Data object to encode.

signedPortionBeginOffset - Return the offset in the encoding of the beginning of the signed portion by setting signedPortionBeginOffset[0]. If you are not encoding in order to sign, you can call encodeData(data) to ignore this returned value.

signedPortionEndOffset - Return the offset in the encoding of the end of the signed portion by setting signedPortionEndOffset[0]. If you are not encoding in order to sign, you can call encodeData(data) to ignore this returned value.

Returns:

A Blob containing the encoding.

decodeData

public void decodeData(Data data,
              ByteBuffer input,
              int[] signedPortionBeginOffset,
              int[] signedPortionEndOffset)
                throws EncodingException

Decode input as a data packet in NDN-TLV and set the fields in the data object.

Overrides:

decodeData in class WireFormat

Parameters:

data - The Data object whose fields are updated.

input - The input buffer to decode. This reads from position() to limit(), but does not change the position.

signedPortionBeginOffset - Return the offset in the input buffer of the beginning of the signed portion by setting signedPortionBeginOffset[0]. If you are not decoding in order to verify, you can call decodeData(data, input) to ignore this returned value.

signedPortionEndOffset - Return the offset in the input buffer of the end of the signed portion by setting signedPortionEndOffset[0]. If you are not decoding in order to verify, you can call decodeData(data, input) to ignore this returned value.

Throws:

EncodingException - For invalid encoding.

encodeControlParameters

public Blob encodeControlParameters(ControlParameters controlParameters)

Encode controlParameters in NDN-TLV and return the encoding.

Overrides:

encodeControlParameters in class WireFormat

Parameters:

controlParameters - The ControlParameters object to encode.

Returns:

A Blob containing the encoding.

decodeControlParameters

public void decodeControlParameters(ControlParameters controlParameters,
                           ByteBuffer input)
                             throws EncodingException

Decode input as a control parameters in NDN-TLV and set the fields of the controlParameters object.

Overrides:

decodeControlParameters in class WireFormat

Parameters:

controlParameters - The ControlParameters object whose fields are updated.

input - The input buffer to decode. This reads from position() to limit(), but does not change the position.

Throws:

EncodingException - For invalid encoding

encodeSignatureInfo

public Blob encodeSignatureInfo(Signature signature)

Encode signature as a SignatureInfo in NDN-TLV and return the encoding.

Overrides:

encodeSignatureInfo in class WireFormat

Parameters:

signature - An object of a subclass of Signature to encode.

Returns:

A Blob containing the encoding.

decodeSignatureInfoAndValue

public Signature decodeSignatureInfoAndValue(ByteBuffer signatureInfo,
                                    ByteBuffer signatureValue)
                                      throws EncodingException

Decode signatureInfo as an NDN-TLV signature info and signatureValue as the related NDN-TLV SignatureValue, and return a new object which is a subclass of Signature.

Overrides:

decodeSignatureInfoAndValue in class WireFormat

Parameters:

signatureInfo - The signature info input buffer to decode. This reads from position() to limit(), but does not change the position.

signatureValue - The signature value input buffer to decode. This reads from position() to limit(), but does not change the position.

Returns:

A new object which is a subclass of Signature.

Throws:

EncodingException - For invalid encoding.

encodeSignatureValue

public Blob encodeSignatureValue(Signature signature)

Encode the signatureValue in the Signature object as a SignatureValue (the signature bits) in NDN-TLV and return the encoding.

Overrides:

encodeSignatureValue in class WireFormat

Parameters:

signature - An object of a subclass of Signature with the signature value to encode.

Returns:

A Blob containing the encoding.

encodeLocalControlHeader

public Blob encodeLocalControlHeader(LocalControlHeader localControlHeader)

Encode the LocalControlHeader in NDN-TLV and return the encoding.

Overrides:

encodeLocalControlHeader in class WireFormat

Parameters:

localControlHeader - The LocalControlHeader object to encode.

Returns:

A Blob containing the encoding.

decodeLocalControlHeader

public void decodeLocalControlHeader(LocalControlHeader localControlHeader,
                            ByteBuffer input)
                              throws EncodingException

Decode input as a LocalControlHeader in NDN-TLV and set the fields of the localControlHeader object.

Overrides:

decodeLocalControlHeader in class WireFormat

Parameters:

localControlHeader - The LocalControlHeader object whose fields are updated.

input - The input buffer to decode. This reads from position() to limit(), but does not change the position.

Throws:

EncodingException - For invalid encoding

get

public static Tlv0_1_1WireFormat get()

Get a singleton instance of a Tlv1_0a2WireFormat. To always use the preferred version NDN-TLV, you should use TlvWireFormat.get().

Returns:

The singleton instance.