ch.qos.logback.core.spi

Class AbstractComponentTracker<C>

java.lang.Object

ch.qos.logback.core.spi.AbstractComponentTracker<C>

Type Parameters:

C - component type

All Implemented Interfaces:

ComponentTracker<C>

Direct Known Subclasses:

AppenderTracker, CyclicBufferTracker

public abstract class AbstractComponentTracker<C>
extends java.lang.Object
implements ComponentTracker<C>

An abstract implementation of the ComponentTracker interface. Derived classes must implement buildComponent(String), processPriorToRemoval(Object), and isComponentStale(Object) methods as appropriate for their component type.

Field Summary

Fields

Modifier and Type	Field and Description
static long	LINGERING_TIMEOUT
static long	WAIT_BETWEEN_SUCCESSIVE_REMOVAL_ITERATIONS The minimum amount of time that has to elapse between successive removal iterations.

Fields inherited from interface ch.qos.logback.core.spi.ComponentTracker

DEFAULT_MAX_COMPONENTS, DEFAULT_TIMEOUT

Constructor Summary

Constructors

Constructor and Description
AbstractComponentTracker()

Method Summary

Modifier and Type	Method and Description
java.util.Collection<C>	allComponents() Returns the collection of all components tracked by this instance.
java.util.Set<java.lang.String>	allKeys() Set of all keys in this tracker in no particular order.
void	endOfLife(java.lang.String key) Mark component identified by 'key' as having reached its end-of-life.
C	find(java.lang.String key) Find the component identified by 'key', without updating the timestamp.
int	getComponentCount() Returns the number of components tracked.
int	getMaxComponents()
C	getOrCreate(java.lang.String key, long timestamp) Get the component identified by 'key', updating its timestamp in the process.
long	getTimeout()
void	removeStaleComponents(long now) Clear (and detach) components which are stale.
void	setMaxComponents(int maxComponents)
void	setTimeout(long timeout)

Methods inherited from class java.lang.Object

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

Field Detail

LINGERING_TIMEOUT

public static final long LINGERING_TIMEOUT

See Also:

Constant Field Values

WAIT_BETWEEN_SUCCESSIVE_REMOVAL_ITERATIONS

public static final long WAIT_BETWEEN_SUCCESSIVE_REMOVAL_ITERATIONS

The minimum amount of time that has to elapse between successive removal iterations.

See Also:

Constant Field Values

Constructor Detail

AbstractComponentTracker

public AbstractComponentTracker()

Method Detail

getComponentCount

public int getComponentCount()

Description copied from interface: ComponentTracker

Returns the number of components tracked.

Specified by:

getComponentCount in interface ComponentTracker<C>

Returns:

number of components

find

public C find(java.lang.String key)

Find the component identified by 'key', without updating the timestamp. Returns null if no corresponding component could be found.

Note that this method is synchronized.

Specified by:

find in interface ComponentTracker<C>

Parameters:

key -

Returns:

corresponding component, may be null

getOrCreate

public C getOrCreate(java.lang.String key,
                     long timestamp)

Get the component identified by 'key', updating its timestamp in the process. If the corresponding component could not be found, it is created.

Note that this method is atomic, i.e. synchronized.

Specified by:

getOrCreate in interface ComponentTracker<C>

Parameters:

key -

timestamp -

Returns:

endOfLife

public void endOfLife(java.lang.String key)

Mark component identified by 'key' as having reached its end-of-life.

Specified by:

endOfLife in interface ComponentTracker<C>

Parameters:

key -

removeStaleComponents

public void removeStaleComponents(long now)

Clear (and detach) components which are stale. Components which have not been accessed for more than a user-specified duration are deemed stale.

Specified by:

removeStaleComponents in interface ComponentTracker<C>

Parameters:

now -

allKeys

public java.util.Set<java.lang.String> allKeys()

Description copied from interface: ComponentTracker

Set of all keys in this tracker in no particular order.

Specified by:

allKeys in interface ComponentTracker<C>

Returns:

allComponents

public java.util.Collection<C> allComponents()

Description copied from interface: ComponentTracker

Returns the collection of all components tracked by this instance.

Specified by:

allComponents in interface ComponentTracker<C>

Returns:

collection of components

getTimeout

public long getTimeout()

setTimeout

public void setTimeout(long timeout)

getMaxComponents

public int getMaxComponents()

setMaxComponents

public void setMaxComponents(int maxComponents)