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
Number160	contentDigest()
SimpleBloomFilter<Number160>	contentKeyBloomFilter(BloomfilterFactory factory)
NavigableMap<Number640,Collection<Number160>>	digests()
SimpleBloomFilter<Number160>	domainKeyBloomFilter(BloomfilterFactory factory)
boolean	equals(Object obj)
int	hashCode()
boolean	isEmpty()
Number160	keyDigest()
SimpleBloomFilter<Number160>	locationKeyBloomFilter(BloomfilterFactory factory)
void	put(Number640 key, Collection<Number160> basedOnSet) Stores a key and the hash of the content for further processing.
int	size()
SimpleBloomFilter<Number160>	versionKeyBloomFilter(BloomfilterFactory factory)

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

keyDigest

public Number160 keyDigest()

Returns:

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

contentDigest

public Number160 contentDigest()

Returns:

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

locationKeyBloomFilter

public SimpleBloomFilter<Number160> locationKeyBloomFilter(BloomfilterFactory factory)

Parameters:

factory - The bloom filter creator

Returns:

The bloom filter of the keys that are on this peer

domainKeyBloomFilter

public SimpleBloomFilter<Number160> domainKeyBloomFilter(BloomfilterFactory factory)

Parameters:

factory - The bloom filter creator

Returns:

The bloom filter of the keys that are on this peer

contentKeyBloomFilter

public SimpleBloomFilter<Number160> contentKeyBloomFilter(BloomfilterFactory factory)

Parameters:

factory - The bloom filter creator

Returns:

The bloom filter of the keys that are on this peer

versionKeyBloomFilter

public SimpleBloomFilter<Number160> versionKeyBloomFilter(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,
       Collection<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

digests

public NavigableMap<Number640,Collection<Number160>> digests()

Returns:

The list of hashes

size

public int size()

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