Class Normalizer<T>

java.lang.Object

org.microbean.assign.Normalizer<T>

Type Parameters:

T - the type of object to be normalized

public final class Normalizer<T>
extends Object

An experimental, simple, mutable, concurrent cache of objects.

Author:

Laird Nelson

See Also:

• normalize(Object, Object)

Constructor Summary

Constructors

Constructor	Description
Normalizer()	Creates a new Normalizer.
Normalizer(ConcurrentMap<Object,T> cache)	Creates a new Normalizer.

Method Summary

Modifier and Type	Method	Description
final T	normalize(T element)	Normalizes the supplied element such that if this Normalizer already has an equivalent cached element, the cached element is returned, and, if it does not, the supplied element is cached indefinitely and returned.
final T	normalize(T element, Object extra)	Normalizes the supplied element such that if this Normalizer already has an equivalent cached element, the cached element is returned, and, if it does not, the supplied element is cached indefinitely and returned.

Methods inherited from class Object

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

Constructor Details

Normalizer

public Normalizer()

Creates a new Normalizer.

See Also:

• Normalizer(ConcurrentMap)

Normalizer

public Normalizer(ConcurrentMap<Object,T> cache)

Creates a new Normalizer.

Parameters:

cache - a ConcurrentMap that will be used as the internal cache; may be null in which case a default, unbounded, initially empty implementation will be used instead

Method Details

normalize

public final T normalize(T element)

Normalizes the supplied element such that if this Normalizer already has an equivalent cached element, the cached element is returned, and, if it does not, the supplied element is cached indefinitely and returned.

Parameters:

element - the element to normalize; may be null in which case null is returned

Returns:

the supplied element or a previously cached equivalent element

See Also:

• normalize(Object, Object)

normalize

public final T normalize(T element,
 Object extra)

Normalizes the supplied element such that if this Normalizer already has an equivalent cached element, the cached element is returned, and, if it does not, the supplied element is cached indefinitely and returned.

Parameters:

element - the element to normalize; may be null in which case null is returned

extra - additional data to include in equality comparisons; may be null; ignored if element is null

Returns:

the supplied element or a previously cached equivalent element