eu.mais_h.mathsync

Interface BucketSelector

All Known Implementing Classes:

PadAndHashBucketSelector

public interface BucketSelector

Selects buckets to store items in.

This interface leaks internal details about summary structure. One can implement and use custom instances to customize settings but be ready for major changes in following versions.

Method Summary

Methods

Modifier and Type	Method and Description
int[]	selectBuckets(int seed, byte[] content) Selects buckets to store items in.

Method Detail

selectBuckets

int[] selectBuckets(int seed,
                  byte[] content)

Selects buckets to store items in.

The output array must contain integers between 0 and Integer.MAX_VALUE. It is better if all integers in that range have the same probability of appearance.

The output must be consistent, for any byte arraycontent, for any positive integer s, multiple invocations of selectBuckets(s, content) must return the same array.

Different seed values should lead to different resulting arrays.

The number of returned buckets may vary for different contents and the returned array may contain duplicates.

Parameters:

seed - a seed preventing items to fall in the same buckets at all compression levels.

content - the content to store.

Returns:

an array of buckets to store content in.