net.eduvax.util

Class EventCounter<T>

java.lang.Object

net.eduvax.util.EventCounter<T>

All Implemented Interfaces:

Handler<T>, Observable<EventCounter<T>>

public class EventCounter<T>
extends java.lang.Object
implements Handler<T>, Observable<EventCounter<T>>

Maintain abstract information regarding objects or event handling. The status counter is computed from refular expression applied to string serialisation of objects to be handled. The counter can be for each event incremented, decremented, reseted or kept as is.
warning: this class is not thread safe. Regular use steps are : - 1: setup (incoke constructor) - 2: config (invoke addMask, setMin, setMax, ...) - 3: provide and register this handler to a handler process string.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	EventCounter.EOpCode Operation code applicable to the status counter

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Hashtable<java.lang.String,java.util.regex.Pattern>	_masks Matching rules
private int	_max max value for the status counter
private int	_min min value for the status counter
private ObserverManager<EventCounter<T>>	_obsManager
private java.util.Hashtable<java.util.regex.Pattern,EventCounter.EOpCode>	_opCodes Matching rules to opcode links.
private int	_value status counter value

Constructor Summary

Constructors

Constructor and Description
EventCounter()

Method Summary

Methods

Modifier and Type	Method and Description
void	addMasks(java.lang.String regexStr, EventCounter.EOpCode opCode) Add matching pattern linked to an operation on counter.
ObserverManager<EventCounter<T>>	getObserverManager() Get this observable observer registration manager.
int	getValue() get current value of the status counter.
void	handle(T toHandle) handling one object
void	resetMasks() Remove all matching rules.
void	setMax(int m) Set max value for status counter.
void	setMin(int m) Set min value for the status counter.

Methods inherited from class java.lang.Object

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

Field Detail

_value

private int _value

status counter value

_min

private int _min

min value for the status counter

_max

private int _max

max value for the status counter

_obsManager

private ObserverManager<EventCounter<T>> _obsManager

_masks

private java.util.Hashtable<java.lang.String,java.util.regex.Pattern> _masks

Matching rules

_opCodes

private java.util.Hashtable<java.util.regex.Pattern,EventCounter.EOpCode> _opCodes

Matching rules to opcode links.

Constructor Detail

EventCounter

public EventCounter()

Method Detail

addMasks

public void addMasks(java.lang.String regexStr,
            EventCounter.EOpCode opCode)
              throws java.util.regex.PatternSyntaxException

Add matching pattern linked to an operation on counter.

Parameters:

regexStr - regular expression defining the matching rule.

opCode - operation link to the matching rule.

Throws:

java.util.regex.PatternSyntaxException

resetMasks

public void resetMasks()

Remove all matching rules. warning: use with caution, this method is not thread safe upon Handler interface implementation.

handle

public void handle(T toHandle)

Description copied from interface: Handler

handling one object

Specified by:

handle in interface Handler<T>

Parameters:

toHandle - object to handle

getValue

public int getValue()

get current value of the status counter.

Returns:

current count.

setMin

public void setMin(int m)

Set min value for the status counter.

Parameters:

m - new min value

setMax

public void setMax(int m)

Set max value for status counter.

Parameters:

m - new max value

getObserverManager

public ObserverManager<EventCounter<T>> getObserverManager()

Description copied from interface: Observable

Get this observable observer registration manager.

Specified by:

getObserverManager in interface Observable<EventCounter<T>>

Returns:

the observer manager.