net.named_data.jndn.util

Class SignedBlob

java.lang.Object

net.named_data.jndn.util.Blob

net.named_data.jndn.util.SignedBlob

All Implemented Interfaces:

Comparable

public class SignedBlob
extends Blob

A SignedBlob extends Blob to keep the offsets of a signed portion (e.g., the bytes of Data packet). This inherits from Blob, including Blob.size and Blob.buf.

Constructor Summary

Constructors

Constructor and Description
SignedBlob() Create a new SignedBlob with a null pointer and 0 for the offsets.
SignedBlob(Blob blob, int signedPortionBeginOffset, int signedPortionEndOffset) Create a new SignedBlob and take another pointer to the given blob's buffer.
SignedBlob(byte[] value, boolean copy, int signedPortionBeginOffset, int signedPortionEndOffset) Create a new SignedBlob from the the byte array.
SignedBlob(ByteBuffer buffer, boolean copy, int signedPortionBeginOffset, int signedPortionEndOffset) Create a new SignedBlob from an existing ByteBuffer.
SignedBlob(SignedBlob signedBlob) Create a new SignedBlob as a copy of the given signedBlob.

Method Summary

Modifier and Type	Method and Description
ByteBuffer	signedBuf() Get a new read-only ByteBuffer for the signed portion of the byte buffer.
int	signedSize() Get the length of the signed portion of the immutable byte buffer.

Methods inherited from class net.named_data.jndn.util.Blob

buf, compare, compareTo, CompareTo, equals, equals, getImmutableArray, hashCode, isNull, size, toHex, toHex, toHex, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

SignedBlob

public SignedBlob()

Create a new SignedBlob with a null pointer and 0 for the offsets.

SignedBlob

public SignedBlob(SignedBlob signedBlob)

Create a new SignedBlob as a copy of the given signedBlob.

Parameters:

signedBlob - The SignedBlob to copy.

SignedBlob

public SignedBlob(Blob blob,
                  int signedPortionBeginOffset,
                  int signedPortionEndOffset)

Create a new SignedBlob and take another pointer to the given blob's buffer.

Parameters:

blob - The Blob from which we take another pointer to the same buffer.

signedPortionBeginOffset - The offset in the buffer of the beginning of the signed portion.

signedPortionEndOffset - The offset in the buffer of the end of the signed portion.

SignedBlob

public SignedBlob(ByteBuffer buffer,
                  boolean copy,
                  int signedPortionBeginOffset,
                  int signedPortionEndOffset)

Create a new SignedBlob from an existing ByteBuffer. IMPORTANT: If copy is false, after calling this constructor, if you keep a pointer to the buffer then you must treat it as immutable and promise not to change it.

Parameters:

buffer - The existing ByteBuffer. It is important that the buffer position and limit are correct.

copy - If true, copy the contents into a new byte array. If false, just take a slice which uses the existing byte array in buffer.

signedPortionBeginOffset - The offset in the buffer of the beginning of the signed portion.

signedPortionEndOffset - The offset in the buffer of the end of the signed portion.

SignedBlob

public SignedBlob(byte[] value,
                  boolean copy,
                  int signedPortionBeginOffset,
                  int signedPortionEndOffset)

Create a new SignedBlob from the the byte array. IMPORTANT: If copy is false, after calling this constructor, if you keep a pointer to the buffer then you must treat it as immutable and promise not to change it.

Parameters:

value - The byte array. If copy is true, this makes a copy.

copy - If true, copy the contents into a new byte array. If false, just use ByteBuffer.wrap which uses the existing byte array.

signedPortionBeginOffset - The offset in the buffer of the beginning of the signed portion.

signedPortionEndOffset - The offset in the buffer of the end of the signed portion.

Method Detail

signedSize

public final int signedSize()

Get the length of the signed portion of the immutable byte buffer.

Returns:

The length of the signed portion, or 0 if the pointer is null.

signedBuf

public final ByteBuffer signedBuf()

Get a new read-only ByteBuffer for the signed portion of the byte buffer.

Returns:

The new ByteBuffer, or null if the pointer is null.