com.itextpdf.kernel.counter.data

Class EventDataHandler<T,V extends EventData<T>>

java.lang.Object

com.itextpdf.kernel.counter.data.EventDataHandler<T,V>

Type Parameters:

T - data signature type

V - data type

public abstract class EventDataHandler<T,V extends EventData<T>>
extends Object

This class is intended for some heavy concurrent event operations (like writing to database or file). On registration of new IEvent the instance of EventData is created with the IEventDataFactory that can add some additional information like system info or version. This data instance is immediately cached with IEventDataCache that can for example merge data with the same signature by summing there count. If the previous processing operation is finished and the wait time is passed then the next event is retrieved from cache (it may be for example based on some comparator like the biggest count, if EventDataCacheComparatorBased is used, or just queue based if the EventDataCacheQueueBased is used or any other order determined by custom cache) and the processing is started asynchronously This class can be considered thread-safe if the cache and factory instances aren't used anywhere else in the code.

Constructor Summary

Constructors

Constructor and Description
EventDataHandler(IEventDataCache<T,V> cache, IEventDataFactory<T,V> factory, long initialWaitTimeMillis, long maxWaitTimeMillis)

Method Summary

Modifier and Type	Method and Description
List<V>	clear()
WaitTime	getWaitTime()
void	increaseWaitTime()
protected void	onFailure(V data)
protected boolean	onProcessException(Exception exception) Is called when exception is thrown in process.
protected void	onSuccess(V data)
protected abstract boolean	process(V data)
void	register(IEvent event, IMetaInfo metaInfo)
void	resetWaitTime()
void	setNoWaitTime()
void	tryProcessNext()
void	tryProcessNextAsync()
void	tryProcessNextAsync(Boolean daemon)
void	tryProcessRest() Method that will try to immediately process all cashed data, ignoring the usual error fallback procedures.

Methods inherited from class java.lang.Object

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

Constructor Detail

EventDataHandler

public EventDataHandler(IEventDataCache<T,V> cache,
                        IEventDataFactory<T,V> factory,
                        long initialWaitTimeMillis,
                        long maxWaitTimeMillis)

Method Detail

clear

public List<V> clear()

register

public void register(IEvent event,
                     IMetaInfo metaInfo)

tryProcessNext

public void tryProcessNext()

tryProcessNextAsync

public void tryProcessNextAsync()

tryProcessNextAsync

public void tryProcessNextAsync(Boolean daemon)

tryProcessRest

public void tryProcessRest()

Method that will try to immediately process all cashed data, ignoring the usual error fallback procedures.

resetWaitTime

public void resetWaitTime()

increaseWaitTime

public void increaseWaitTime()

setNoWaitTime

public void setNoWaitTime()

getWaitTime

public WaitTime getWaitTime()

onSuccess

protected void onSuccess(V data)

onFailure

protected void onFailure(V data)

onProcessException

protected boolean onProcessException(Exception exception)

Is called when exception is thrown in process.

Parameters:

exception - caught exception

Returns:

whether processing is treated as success

process

protected abstract boolean process(V data)