Package org.eclipse.emf.common.util

Class SegmentSequence.SegmentSequencePool

java.lang.Object

java.util.AbstractCollection<SegmentSequence>

java.util.AbstractSet<SegmentSequence>

org.eclipse.emf.common.util.WeakInterningHashSet<SegmentSequence>

org.eclipse.emf.common.util.Pool<SegmentSequence>

org.eclipse.emf.common.util.SegmentSequence.SegmentSequencePool

All Implemented Interfaces:

Serializable, Iterable<SegmentSequence>, Collection<SegmentSequence>, Set<SegmentSequence>, InterningSet<SegmentSequence>

Enclosing class:

SegmentSequence

protected static class SegmentSequence.SegmentSequencePool
extends Pool<SegmentSequence>

A cached pool of weakly referenced segment sequences. There are several ways of interning instances, all of which seek to avoid creating new objects whenever possible. Note that we've carefully ensured that a segment sequence's hash code is the same as that of its string representation. This is exploited to allow fast lookup of strings against their already segmented representation.

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	SegmentSequence.SegmentSequencePool.AccessUnitBase	A base class for all this pool's access units.
protected static class	SegmentSequence.SegmentSequencePool.CachedToString	A weak reference for caching a segment sequence's string representation.
protected static class	SegmentSequence.SegmentSequencePool.SegmentsAccessUnit	An access unit for accessing a delimiter and segments.
protected static class	SegmentSequence.SegmentSequencePool.SegmentsAndSegmentAccessUnit	An access unit for accessing segments and one additional segment.
protected static class	SegmentSequence.SegmentSequencePool.SegmentsAndSegmentsAccessUnit	An access units for accessing the composition of two sets of segments.
protected static class	SegmentSequence.SegmentSequencePool.StringAccessUnit	An access unit for basic string access.

Nested classes/interfaces inherited from class org.eclipse.emf.common.util.Pool

Pool.AccessUnit<E>, Pool.ExternalRehasher<E>, Pool.ObjectAccessUnit<E>, Pool.PoolEntry<E>

Nested classes/interfaces inherited from class org.eclipse.emf.common.util.WeakInterningHashSet

WeakInterningHashSet.Entry<E>, WeakInterningHashSet.SelfCleaningEntry<E>

Field Summary

Fields

Modifier and Type	Field	Description
protected final ReferenceQueue<String>	cachedToStrings	A reference queue for internally managing the collection of cached SegmentSequence.toStrings.
protected final SegmentSequence.SegmentSequencePool.SegmentsAccessUnit.Queue	segmentsAccessUnits	Access units for accessing a delimiter and segments.
protected final SegmentSequence.SegmentSequencePool.SegmentsAndSegmentAccessUnit.Queue	segmentsAndSegmentAccessUnits	Access units for accessing segments and one additional segment.
protected final SegmentSequence.SegmentSequencePool.SegmentsAndSegmentsAccessUnit.Queue	segmentsAndSegmentsAccessUnits	Access units for accessing the composition of two sequences of segments.
protected final SegmentSequence.SegmentSequencePool.StringAccessUnit.Queue	stringAccessUnits	Access units for basic string access.

Fields inherited from class org.eclipse.emf.common.util.Pool

accessCount, cleanupPeriod, primaryAccessUnits, readLock, readWriteLock, writeLock

Fields inherited from class org.eclipse.emf.common.util.WeakInterningHashSet

capacityIndex, containsNull, entries, externalQueue, internalQueue, modCount, NULL_ENTRY, PRIME_CAPACITIES, size, threshold

Constructor Summary

Constructors

Constructor	Description
SegmentSequencePool(ReferenceQueue<Object> queue)	Creates an instance managed the given external queue.

Method Summary

Modifier and Type	Method	Description
protected void	doCleanup()	Specialized to also clean up the cachedToStrings.
protected SegmentSequence	intern(boolean needsCopying, boolean needsToIntern, String delimiter, String[] segments, int count)	Interns the segments, taking into account the delimiter, copying the array, when needed, and interning the segments themselves, when needed.
protected SegmentSequence	intern(int hashCode, String delimiter, String[] segments, String segment)	Interns the segments along with the one additional segment, taking into account the delimiter and interning the additional segment.
protected SegmentSequence	intern(int hashCode, String delimiter, String[] segments1, String[] segments2, boolean needsToIntern)	Interns the composed segments, taking into account the delimiter.
protected SegmentSequence	intern(String delimiter, String value)	Interns the string representation of a segment sequence, splitting it into appropriate segments based on the delimiter.
protected WeakReference<String>	newCachedToString(SegmentSequence segmentSequence, String string)	Creates a new weak reference managed by the appropriate external or internal queue.

Methods inherited from class org.eclipse.emf.common.util.Pool

access, add, addEntry, cleanup, clear, contains, containsAll, doIntern, ensureCapacity, equals, get, getEntry, getReadLock, getWriteLock, grow, hashCode, intern, iterator, newDefaultAccessUnits, newExternalEntry, remove, removeAll, retainAll, toArray, toArray, toString

Methods inherited from class org.eclipse.emf.common.util.WeakInterningHashSet

addEntry, asInstance, dump, equals, hashCode, index, newEntries, newEntry, newInternalEntry, nullEntry, putEntry, removeEntry, removeEntry, size

Methods inherited from class java.util.AbstractCollection

addAll, isEmpty

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream, toArray

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.Set

addAll, isEmpty, spliterator

Field Details

stringAccessUnits

protected final SegmentSequence.SegmentSequencePool.StringAccessUnit.Queue stringAccessUnits

Access units for basic string access.

segmentsAccessUnits

protected final SegmentSequence.SegmentSequencePool.SegmentsAccessUnit.Queue segmentsAccessUnits

Access units for accessing a delimiter and segments.

segmentsAndSegmentAccessUnits

protected final SegmentSequence.SegmentSequencePool.SegmentsAndSegmentAccessUnit.Queue segmentsAndSegmentAccessUnits

Access units for accessing segments and one additional segment.

segmentsAndSegmentsAccessUnits

protected final SegmentSequence.SegmentSequencePool.SegmentsAndSegmentsAccessUnit.Queue segmentsAndSegmentsAccessUnits

Access units for accessing the composition of two sequences of segments.

cachedToStrings

protected final ReferenceQueue<String> cachedToStrings

A reference queue for internally managing the collection of cached SegmentSequence.toStrings.

Constructor Details

SegmentSequencePool

public SegmentSequencePool(ReferenceQueue<Object> queue)

Creates an instance managed the given external queue. If it's null, and internal queue will be used to managed the cached strings.

Method Details

doCleanup

protected void doCleanup()

Specialized to also clean up the cachedToStrings.

Overrides:

doCleanup in class Pool<SegmentSequence>

newCachedToString

protected WeakReference<String> newCachedToString(SegmentSequence segmentSequence,
 String string)

Creates a new weak reference managed by the appropriate external or internal queue.

intern

protected SegmentSequence intern(String delimiter,
 String value)

Interns the string representation of a segment sequence, splitting it into appropriate segments based on the delimiter.

intern

protected SegmentSequence intern(boolean needsCopying,
 boolean needsToIntern,
 String delimiter,
 String[] segments,
 int count)

Interns the segments, taking into account the delimiter, copying the array, when needed, and interning the segments themselves, when needed.

intern

protected SegmentSequence intern(int hashCode,
 String delimiter,
 String[] segments,
 String segment)

Interns the segments along with the one additional segment, taking into account the delimiter and interning the additional segment. All callers of this method will already have interned the segments.

intern

protected SegmentSequence intern(int hashCode,
 String delimiter,
 String[] segments1,
 String[] segments2,
 boolean needsToIntern)

Interns the composed segments, taking into account the delimiter. All callers of this method will already have interned the segments.