net.tomp2p.storage

Class Data

java.lang.Object

net.tomp2p.storage.Data

public class Data
extends Object

This class holds the data for the transport. The data is already serialized and a hash may be created. It is reasonable to create the hash on the remote peer, but not on the local peer. The remote peer uses the hash to tell the other peers, which version is stored and its used quite often.

Author:

Thomas Bocek

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Data.Type small means 8 bit, medium is 32bit.

Constructor Summary

Constructors

Constructor and Description
Data()
Data(byte[] buffer)
Data(byte[] buffer, int offest, int length) Creates a data object from an already existing byte buffer.
Data(DataBuffer buffer)
Data(DataBuffer buffer, int length) Create a data object that does have the complete data.
Data(int header, int length) Creates an empty data object.
Data(Object object)

Method Summary

Methods

Modifier and Type	Method and Description
Data	addBasedOn(Number160 basedOn)
Set<Number160>	basedOnSet()
io.netty.buffer.ByteBuf	buffer()
boolean	decodeBuffer(io.netty.buffer.ByteBuf buf) Add data to the byte buffer.
boolean	decodeDone(io.netty.buffer.ByteBuf buf, PublicKey publicKey, SignatureFactory signatureFactory)
static Data	decodeHeader(io.netty.buffer.ByteBuf buf, SignatureFactory signatureFactory) Reads the header.
Data	duplicate()
Data	duplicateMeta()
boolean	encodeBuffer(AlternativeCompositeByteBuf buf)
void	encodeDone(io.netty.buffer.ByteBuf buf, SignatureFactory signatureFactory)
void	encodeHeader(AlternativeCompositeByteBuf buf, SignatureFactory signatureFactory)
boolean	equals(Object obj)
long	expirationMillis()
Data	flag1(boolean flag1)
Data	flag2(boolean flag2)
Number160	hash()
int	hashCode()
boolean	hasPublicKey()
Data	hasPublicKey(boolean publicKeyFlag)
boolean	isFlag1()
boolean	isFlag2()
boolean	isMeta()
boolean	isProtectedEntry()
boolean	isSigned()
Data	lazySign(KeyPair keyPair)
Data	lazySign(PrivateKey privateKey)
int	length()
Data	meta(boolean meta)
Object	object()
PrivateKey	privateKey()
Data	protectedEntry(boolean protectedEntry)
PublicKey	publicKey()
Data	publicKey(PublicKey publicKey)
void	resetAlreadyTransferred()
Data	setFlag1()
Data	setFlag2()
Data	setMeta()
Data	setProtectedEntry()
Data	setPublicKey()
Data	sign(KeyPair keyPair, SignatureFactory signatureFactory)
Data	sign(PrivateKey privateKey, SignatureFactory signatureFactory)
SignatureCodec	signature()
Data	signature(SignatureCodec signature)
SignatureFactory	signatureFactory()
Data	signatureFactory(SignatureFactory signatureFactory)
Data	signed()
Data	signed(boolean signed)
ByteBuffer[]	toByteBuffers()
byte[]	toBytes()
String	toString()
int	ttlSeconds()
Data	ttlSeconds(int ttlSeconds)
static Data.Type	type(int header)
long	validFromMillis()
boolean	verify(PublicKey publicKey, SignatureFactory signatureFactory)
boolean	verify(SignatureFactory signatureFactory)

Methods inherited from class java.lang.Object

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

Constructor Detail

Data

public Data(DataBuffer buffer)

Data

public Data(DataBuffer buffer,
    int length)

Create a data object that does have the complete data.

Parameters:

length - The expected length of the buffer. This does not include the header + size (2, 5, or 9).

version - The version of a data object, optional

ttlSeconds - The TTL of a data object, optional

hasHash - Indication if a hash should also be transmitted

isProtectedEntry - True if this entry is protected

Data

public Data(int header,
    int length)

Creates an empty data object. The data can be filled at a later stage using #append(ByteBuf).

Parameters:

header - The 8 bit header

length - The length, which depends on the header values

Data

public Data(Object object)
     throws IOException

Throws:

IOException

Data

public Data(byte[] buffer)

Data

public Data()

Data

public Data(byte[] buffer,
    int offest,
    int length)

Creates a data object from an already existing byte buffer.

Parameters:

buffer - The data buffer

version - The version of a data object, optional

ttlSeconds - The ttl of a data object, optional

hasHash - Indication if a hash should also be transmitted

isProtectedEntry - True if this entry is protected

Method Detail

decodeHeader

public static Data decodeHeader(io.netty.buffer.ByteBuf buf,
                SignatureFactory signatureFactory)

Reads the header. Does not modify the buffer positions if header could not be fully read.

Parameters:

buf - The buffer to read from

Returns:

The data object, may be partially filled

decodeBuffer

public boolean decodeBuffer(io.netty.buffer.ByteBuf buf)

Add data to the byte buffer.

Parameters:

buf - The byte buffer to append

Returns:

True if we are done reading

decodeDone

public boolean decodeDone(io.netty.buffer.ByteBuf buf,
                 PublicKey publicKey,
                 SignatureFactory signatureFactory)

verify

public boolean verify(SignatureFactory signatureFactory)
               throws InvalidKeyException,
                      SignatureException,
                      IOException

Throws:

InvalidKeyException

SignatureException

IOException

verify

public boolean verify(PublicKey publicKey,
             SignatureFactory signatureFactory)
               throws InvalidKeyException,
                      SignatureException,
                      IOException

Throws:

InvalidKeyException

SignatureException

IOException

encodeHeader

public void encodeHeader(AlternativeCompositeByteBuf buf,
                SignatureFactory signatureFactory)

encodeBuffer

public boolean encodeBuffer(AlternativeCompositeByteBuf buf)

encodeDone

public void encodeDone(io.netty.buffer.ByteBuf buf,
              SignatureFactory signatureFactory)
                throws InvalidKeyException,
                       SignatureException,
                       IOException

Throws:

InvalidKeyException

SignatureException

IOException

buffer

public io.netty.buffer.ByteBuf buffer()

object

public Object object()
              throws ClassNotFoundException,
                     IOException

Throws:

ClassNotFoundException

IOException

validFromMillis

public long validFromMillis()

sign

public Data sign(KeyPair keyPair,
        SignatureFactory signatureFactory)
          throws InvalidKeyException,
                 SignatureException,
                 IOException

Throws:

InvalidKeyException

SignatureException

IOException

sign

public Data sign(PrivateKey privateKey,
        SignatureFactory signatureFactory)
          throws InvalidKeyException,
                 SignatureException,
                 IOException

Throws:

InvalidKeyException

SignatureException

IOException

lazySign

public Data lazySign(KeyPair keyPair)

lazySign

public Data lazySign(PrivateKey privateKey)

length

public int length()

expirationMillis

public long expirationMillis()

ttlSeconds

public int ttlSeconds()

ttlSeconds

public Data ttlSeconds(int ttlSeconds)

addBasedOn

public Data addBasedOn(Number160 basedOn)

basedOnSet

public Set<Number160> basedOnSet()

signatureFactory

public SignatureFactory signatureFactory()

signatureFactory

public Data signatureFactory(SignatureFactory signatureFactory)

isProtectedEntry

public boolean isProtectedEntry()

isSigned

public boolean isSigned()

signed

public Data signed(boolean signed)

signed

public Data signed()

protectedEntry

public Data protectedEntry(boolean protectedEntry)

setProtectedEntry

public Data setProtectedEntry()

isFlag1

public boolean isFlag1()

flag1

public Data flag1(boolean flag1)

setFlag1

public Data setFlag1()

isFlag2

public boolean isFlag2()

flag2

public Data flag2(boolean flag2)

setFlag2

public Data setFlag2()

hasPublicKey

public boolean hasPublicKey()

hasPublicKey

public Data hasPublicKey(boolean publicKeyFlag)

setPublicKey

public Data setPublicKey()

isMeta

public boolean isMeta()

meta

public Data meta(boolean meta)

setMeta

public Data setMeta()

toString

public String toString()

Overrides:

toString in class Object

resetAlreadyTransferred

public void resetAlreadyTransferred()

duplicate

public Data duplicate()

Returns:

A shallow copy where the data is shared but the reader and writer index is not shared

duplicateMeta

public Data duplicateMeta()

type

public static Data.Type type(int header)

toBytes

public byte[] toBytes()

Returns:

The byte array that is the payload. Here we copy the buffer

toByteBuffers

public ByteBuffer[] toByteBuffers()

Returns:

The ByteBuffers that is the payload. We do not make a copy here

publicKey

public PublicKey publicKey()

privateKey

public PrivateKey privateKey()

Returns:

A private key if we want to sign it lazy (during encoding).

publicKey

public Data publicKey(PublicKey publicKey)

signature

public SignatureCodec signature()

signature

public Data signature(SignatureCodec signature)

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hash

public Number160 hash()