Package org.bitcoinj.net

Class FilterMerger

java.lang.Object

org.bitcoinj.net.FilterMerger

public class FilterMerger
extends java.lang.Object

A reusable object that will calculate, given a list of PeerFilterProviders, a merged BloomFilter and earliest key time for all of them. Used by the PeerGroup class internally.

Thread safety: threading here can be complicated. Each filter provider is given a begin event, which may acquire a lock (and is guaranteed to receive an end event). This class is mostly thread unsafe and is meant to be used from a single thread only, PeerGroup ensures this by only accessing it from the dedicated PeerGroup thread. PeerGroup does not hold any locks whilst this object is used, relying on the single thread to prevent multiple filters being calculated in parallel, thus a filter provider can do things like make blocking calls into PeerGroup from a separate thread. However the bloomFilterFPRate property IS thread safe, for convenience.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	FilterMerger.Result

Constructor Summary

Constructors

Constructor	Description
FilterMerger(double bloomFilterFPRate)

Method Summary

Modifier and Type	Method	Description
FilterMerger.Result	calculate(com.google.common.collect.ImmutableList<PeerFilterProvider> providers)
double	getBloomFilterFPRate()
BloomFilter	getLastFilter()
void	setBloomFilterFPRate(double bloomFilterFPRate)

Methods inherited from class java.lang.Object

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

Constructor Detail

FilterMerger

public FilterMerger(double bloomFilterFPRate)

Method Detail

calculate

public FilterMerger.Result calculate(com.google.common.collect.ImmutableList<PeerFilterProvider> providers)

setBloomFilterFPRate

public void setBloomFilterFPRate(double bloomFilterFPRate)

getBloomFilterFPRate

public double getBloomFilterFPRate()

getLastFilter

public BloomFilter getLastFilter()