Modifier and Type	Class and Description
private static class	AbstractComponentTracker.Entry<C>
private static interface	AbstractComponentTracker.RemovalPredicator<C>

Modifier and Type	Field and Description
private static final boolean	ACCESS_ORDERED
private AbstractComponentTracker.RemovalPredicator<C>	byExcedent
private AbstractComponentTracker.RemovalPredicator<C>	byLingering
private AbstractComponentTracker.RemovalPredicator<C>	byTimeout
pack-priv long	lastCheck
pack-priv LinkedHashMap<String, AbstractComponentTracker.Entry<C>>	lingerersMap
public static final long	LINGERING_TIMEOUT
pack-priv LinkedHashMap<String, AbstractComponentTracker.Entry<C>>	liveMap
protected int	maxComponents
protected long	timeout
public static final long	WAIT_BETWEEN_SUCCESSIVE_REMOVAL_ITERATIONS The minimum amount of time that has to elapse between successive removal iterations.

Access	Constructor and Description
public	AbstractComponentTracker()

Method Summary

Modifier and Type	Method and Description
public Collection<C>	allComponents() Implements ch.qos.logback.core.spi.ComponentTracker.allComponents. Returns the collection of all components tracked by this instance.
public Set<String>	allKeys() Implements ch.qos.logback.core.spi.ComponentTracker.allKeys. Set of all keys in this tracker in no particular order.
protected abstract C	buildComponent(String key) Build a component based on the key.
public void	endOfLife(String key) Implements ch.qos.logback.core.spi.ComponentTracker.endOfLife. Mark component identified by 'key' as having reached its end-of-life.
public synchronized C	Returns: corresponding component, may be null find(String key) Implements ch.qos.logback.core.spi.ComponentTracker.find. Find the component identified by 'key', without updating the timestamp.
private void	genericStaleComponentRemover(LinkedHashMap<String, AbstractComponentTracker.Entry<C>> map, long now, AbstractComponentTracker.RemovalPredicator<C> removalPredicator)
public int	getComponentCount() Implements ch.qos.logback.core.spi.ComponentTracker.getComponentCount. Returns the number of components tracked.
private AbstractComponentTracker.Entry<C>	getFromEitherMap(String key) Get an entry from the liveMap, if not found search the lingerersMap.
public int	getMaxComponents()
public synchronized C	getOrCreate(String key, long timestamp) Implements ch.qos.logback.core.spi.ComponentTracker.getOrCreate. Get the component identified by 'key', updating its timestamp in the process.
public long	getTimeout()
protected abstract boolean	isComponentStale(C c) Components can declare themselves stale.
private boolean	isEntryDoneLingering(AbstractComponentTracker.Entry<C> entry, long now)
private boolean	isEntryStale(AbstractComponentTracker.Entry<C> entry, long now)
private boolean	isTooSoonForRemovalIteration(long now)
protected abstract void	processPriorToRemoval(C component) Stop or clean the component.
private void	removeExcedentComponents()
public synchronized void	removeStaleComponents(long now) Implements ch.qos.logback.core.spi.ComponentTracker.removeStaleComponents. Clear (and detach) components which are stale.
private void	removeStaleComponentsFromLingerersMap(long now)
private void	removeStaleComponentsFromMainMap(long now)
public void	setMaxComponents(int maxComponents)
public void	setTimeout(long timeout)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

ACCESS_ORDERED	back to summary
private static final boolean ACCESS_ORDERED

byExcedent	back to summary
private AbstractComponentTracker.RemovalPredicator<C> byExcedent

byLingering	back to summary
private AbstractComponentTracker.RemovalPredicator<C> byLingering

byTimeout	back to summary
private AbstractComponentTracker.RemovalPredicator<C> byTimeout

lastCheck	back to summary
pack-priv long lastCheck

lingerersMap	back to summary
pack-priv LinkedHashMap<String, AbstractComponentTracker.Entry<C>> lingerersMap

LINGERING_TIMEOUT	back to summary
public static final long LINGERING_TIMEOUT

liveMap	back to summary
pack-priv LinkedHashMap<String, AbstractComponentTracker.Entry<C>> liveMap

maxComponents	back to summary
protected int maxComponents

timeout	back to summary
protected long timeout

WAIT_BETWEEN_SUCCESSIVE_REMOVAL_ITERATIONS	back to summary
public static final long WAIT_BETWEEN_SUCCESSIVE_REMOVAL_ITERATIONS The minimum amount of time that has to elapse between successive removal iterations.

AbstractComponentTracker	back to summary
public AbstractComponentTracker()

Method Detail

allComponents	back to summary
public Collection<C> allComponents() Implements ch.qos.logback.core.spi.ComponentTracker.allComponents. Doc from ch.qos.logback.core.spi.ComponentTracker.allComponents. Returns the collection of all components tracked by this instance. Returns:Collection<C> collection of components

allComponents

back to summary

public Collection<C> allComponents()

Implements ch.qos.logback.core.spi.ComponentTracker.allComponents.

Doc from ch.qos.logback.core.spi.ComponentTracker.allComponents.

Returns the collection of all components tracked by this instance.

Returns:Collection<C>: collection of components

allKeys	back to summary
public Set<String> allKeys() Implements ch.qos.logback.core.spi.ComponentTracker.allKeys. Doc from ch.qos.logback.core.spi.ComponentTracker.allKeys. Set of all keys in this tracker in no particular order.

allKeys

back to summary

public Set<String> allKeys()

Implements ch.qos.logback.core.spi.ComponentTracker.allKeys.

Doc from ch.qos.logback.core.spi.ComponentTracker.allKeys.

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

buildComponent	back to summary
protected abstract C buildComponent(String key) Build a component based on the key.

endOfLife	back to summary
public void endOfLife(String key) Implements ch.qos.logback.core.spi.ComponentTracker.endOfLife. Mark component identified by 'key' as having reached its end-of-life.

endOfLife

back to summary

public void endOfLife(String key)

Implements ch.qos.logback.core.spi.ComponentTracker.endOfLife.

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

find	back to summary
public synchronized C find(String key) Implements ch.qos.logback.core.spi.ComponentTracker.find. Doc from ch.qos.logback.core.spi.ComponentTracker.find. 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. Returns:C corresponding component, may be null

find

back to summary

public synchronized C find(String key)

Implements ch.qos.logback.core.spi.ComponentTracker.find.

Doc from ch.qos.logback.core.spi.ComponentTracker.find.

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.

Returns:C: corresponding component, may be null

genericStaleComponentRemover	back to summary
private void genericStaleComponentRemover(LinkedHashMap<String, AbstractComponentTracker.Entry<C>> map, long now, AbstractComponentTracker.RemovalPredicator<C> removalPredicator)

getComponentCount	back to summary
public int getComponentCount() Implements ch.qos.logback.core.spi.ComponentTracker.getComponentCount. Doc from ch.qos.logback.core.spi.ComponentTracker.getComponentCount. Returns the number of components tracked. Returns:int number of components

getComponentCount

back to summary

public int getComponentCount()

Implements ch.qos.logback.core.spi.ComponentTracker.getComponentCount.

Doc from ch.qos.logback.core.spi.ComponentTracker.getComponentCount.

Returns the number of components tracked.

Returns:int: number of components

getFromEitherMap	back to summary
private AbstractComponentTracker.Entry<C> getFromEitherMap(String key) Get an entry from the liveMap, if not found search the lingerersMap.

getMaxComponents	back to summary
public int getMaxComponents()

getOrCreate	back to summary
public synchronized C getOrCreate(String key, long timestamp) Implements ch.qos.logback.core.spi.ComponentTracker.getOrCreate. Doc from ch.qos.logback.core.spi.ComponentTracker.getOrCreate. 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.

getOrCreate

back to summary

public synchronized C getOrCreate(String key, long timestamp)

Implements ch.qos.logback.core.spi.ComponentTracker.getOrCreate.

Doc from ch.qos.logback.core.spi.ComponentTracker.getOrCreate.

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.

getTimeout	back to summary
public long getTimeout()

isComponentStale	back to summary
protected abstract boolean isComponentStale(C c) Components can declare themselves stale. Such components may be removed before they time out.

isEntryDoneLingering	back to summary
private boolean isEntryDoneLingering(AbstractComponentTracker.Entry<C> entry, long now)

isEntryStale	back to summary
private boolean isEntryStale(AbstractComponentTracker.Entry<C> entry, long now)

isTooSoonForRemovalIteration	back to summary
private boolean isTooSoonForRemovalIteration(long now)

processPriorToRemoval	back to summary
protected abstract void processPriorToRemoval(C component) Stop or clean the component.

removeExcedentComponents	back to summary
private void removeExcedentComponents()

removeStaleComponents	back to summary
public synchronized void removeStaleComponents(long now) Implements ch.qos.logback.core.spi.ComponentTracker.removeStaleComponents. Clear (and detach) components which are stale. Components which have not been accessed for more than a user-specified duration are deemed stale.

removeStaleComponents

back to summary

public synchronized void removeStaleComponents(long now)

Implements ch.qos.logback.core.spi.ComponentTracker.removeStaleComponents.

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

removeStaleComponentsFromLingerersMap	back to summary
private void removeStaleComponentsFromLingerersMap(long now)

removeStaleComponentsFromMainMap	back to summary
private void removeStaleComponentsFromMainMap(long now)

setMaxComponents	back to summary
public void setMaxComponents(int maxComponents)

setTimeout	back to summary
public void setTimeout(long timeout)

ch.qos.logback.core.spi back to summary

private Class AbstractComponentTracker.Entry<C>

Class Inheritance

extends Object

java.lang.Object
ch.qos.logback.core.spi.AbstractComponentTracker.Entry

Field Summary

Modifier and Type	Field and Description
pack-priv C	component
pack-priv String	key
pack-priv long	timestamp

Constructor Summary

Access	Constructor and Description
pack-priv	Entry(String k, C c, long timestamp)

Method Summary

Modifier and Type	Method and Description
public boolean	equals(Object the reference object with which to compare. obj) Overrides java.lang.Object.equals. Indicates whether some other object is "equal to" this one.
public int	hashCode() Overrides java.lang.Object.hashCode. Returns a hash code value for the object.
public void	setTimestamp(long timestamp)
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.

Inherited from java.lang.Object:: clone finalize getClass notify notifyAll wait wait wait

Field Detail

component	back to summary
pack-priv C component

key	back to summary
pack-priv String key

timestamp	back to summary
pack-priv long timestamp

Constructor Detail

Entry	back to summary
pack-priv Entry(String k, C c, long timestamp)

Method Detail

equals back to summary

equals	back to summary
public boolean equals(Object obj) Overrides java.lang.Object.equals. Doc from java.lang.Object.equals. Indicates whether some other object is "equal to" this one. The `equals` method implements an equivalence relation on non-null object references: It is reflexive: for any non-null reference value `x`, `x.equals(x)` should return `true`. It is symmetric: for any non-null reference values `x` and `y`, `x.equals(y)` should return `true` if and only if `y.equals(x)` returns `true`. It is transitive: for any non-null reference values `x`, `y`, and `z`, if `x.equals(y)` returns `true` and `y.equals(z)` returns `true`, then `x.equals(z)` should return `true`. It is consistent: for any non-null reference values `x` and `y`, multiple invocations of `x.equals(y)` consistently return `true` or consistently return `false`, provided no information used in `equals` comparisons on the objects is modified. For any non-null reference value `x`, `x.equals(null)` should return `false`. An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes. Parameters obj:Object the reference object with which to compare. Returns:boolean `true` if this object is the same as the obj argument; `false` otherwise. Annotations @Override

public boolean equals(Object obj)

Overrides java.lang.Object.equals.

Doc from java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

It is reflexive: for any non-null reference value x, x.equals(x) should return true.
It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

Parameters

obj:Object: the reference object with which to compare.

Returns:boolean

true if this object is the same as the obj argument; false otherwise.

Annotations

@Override

hashCode back to summary

hashCode	back to summary
public int hashCode() Overrides java.lang.Object.hashCode. Doc from java.lang.Object.hashCode. Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by `java.util.HashMap`. The general contract of `hashCode` is: Whenever it is invoked on the same object more than once during an execution of a Java application, the `hashCode` method must consistently return the same integer, provided no information used in `equals` comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application. If two objects are equal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce the same integer result. It is not required that if two objects are unequal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables. Returns:int a hash code value for this object. Annotations @Override

public int hashCode()

Overrides java.lang.Object.hashCode.

Doc from java.lang.Object.hashCode.

Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

Returns:int

a hash code value for this object.

Annotations

@Override

setTimestamp	back to summary
public void setTimestamp(long timestamp)

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Doc from java.lang.Object.toString. Returns a string representation of the object. Returns:String a string representation of the object. Annotations @Override

toString

back to summary

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object.

Returns:String

a string representation of the object.

Annotations

@Override

public abstract Class AbstractComponentTracker<C>

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class AbstractComponentTracker.Entry<C>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Interface AbstractComponentTracker.RemovalPredicator<C>

Method Summary

Method Detail