net.tomp2p.rpc

Class DigestInfo

java.lang.Object

net.tomp2p.rpc.DigestInfo

public class DigestInfo
extends Object

Calculates or sets a global hash. The digest is used in two places: for routing, where a message needs to have a predictable size. Thus in this case a global hash is calculated. The second usage is get() for getting a list of hashes from peers. Here we don't need to restrict ourself, since we use TCP.

Author:

Thomas Bocek

Constructor Summary

Constructors

Constructor and Description
DigestInfo() Empty constructor is used to add the hashes to the list.
DigestInfo(int size) Create a digest with the size only.
DigestInfo(Number160 keyDigest, Number160 contentDigest, int size) If a global hash has already been calculated, then this constructor is used to store those.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object obj)
Number160	getContentDigest()
SimpleBloomFilter<Number160>	getContentKeyBloomFilter(BloomfilterFactory factory)
NavigableMap<Number640,Set<Number160>>	getDigests()
SimpleBloomFilter<Number160>	getDomainKeyBloomFilter(BloomfilterFactory factory)
Number160	getKeyDigest()
SimpleBloomFilter<Number160>	getLocationKeyBloomFilter(BloomfilterFactory factory)
int	getSize()
SimpleBloomFilter<Number160>	getVersionKeyBloomFilter(BloomfilterFactory factory)
int	hashCode()
boolean	isEmpty()
void	put(Number640 key, Set<Number160> basedOnSet) Stores a key and the hash of the content for further processing.

Methods inherited from class java.lang.Object

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

Constructor Detail

DigestInfo

public DigestInfo()

Empty constructor is used to add the hashes to the list.

DigestInfo

public DigestInfo(int size)

Create a digest with the size only.

Parameters:

size - The number of items

DigestInfo

public DigestInfo(Number160 keyDigest,
          Number160 contentDigest,
          int size)

If a global hash has already been calculated, then this constructor is used to store those. Note that once a global hash is set it cannot be unset.

Parameters:

keyDigest - The digest of all keys

contentDigest - The digest of all contents

size - The number of entries

Method Detail

getKeyDigest

public Number160 getKeyDigest()

Returns:

Returns or calculates the global key hash. The global key hash will be calculated if the empty constructor is used.

getContentDigest

public Number160 getContentDigest()

Returns:

Returns or calculates the global content hash. The global content hash will be calculated if the empty constructor is used.

getLocationKeyBloomFilter

public SimpleBloomFilter<Number160> getLocationKeyBloomFilter(BloomfilterFactory factory)

Parameters:

factory - The bloom filter creator

Returns:

The bloom filter of the keys that are on this peer

getDomainKeyBloomFilter

public SimpleBloomFilter<Number160> getDomainKeyBloomFilter(BloomfilterFactory factory)

Parameters:

factory - The bloom filter creator

Returns:

The bloom filter of the keys that are on this peer

getContentKeyBloomFilter

public SimpleBloomFilter<Number160> getContentKeyBloomFilter(BloomfilterFactory factory)

Parameters:

factory - The bloom filter creator

Returns:

The bloom filter of the keys that are on this peer

getVersionKeyBloomFilter

public SimpleBloomFilter<Number160> getVersionKeyBloomFilter(BloomfilterFactory factory)

Parameters:

factory - The bloom filter creator

Returns:

The bloom filter of the content keys that are on this peer

put

public void put(Number640 key,
       Set<Number160> basedOnSet)

Stores a key and the hash of the content for further processing.

Parameters:

key - The key of the content

basedOn - The hash of the content

getDigests

public NavigableMap<Number640,Set<Number160>> getDigests()

Returns:

The list of hashes

getSize

public int getSize()

Returns:

The number of hashes

isEmpty

public boolean isEmpty()

Returns:

True is the digest information has not been provided.

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object