|
Side of Software Dated Collections Library 2.0 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object sos.dated.util.AbstractDatedObject<D> sos.dated.util.AbstractDatedMap<K,V,D> sos.dated.util.AbstractMapByDate<K,V,D> sos.dated.util.LinkedHashMapByDate<K,V,D>
K
- the type of keys maintained by this dated mapV
- the type of values maintained by this dated mapD
- the type of dates used by this dated mappublic class LinkedHashMapByDate<K,V,D>
An implementation of DatedMap
that maintains a java.util.LinkedHashMap
at each date where a change occurs, yielding fast date iterations, fast retrievals,
and predictable entry iterations.
This implementation is serializable and cloneable; however, it is not
synchronized. To use it safely in a multi-threaded situation, wrap an
instance of the dated map with a call to DatedCollections.synchronizedDatedMap
.
LinkedHashSetByDate
,
DatedMap
,
DatedCollections.synchronizedDatedMap(DatedMap)
Nested Class Summary |
---|
Nested classes/interfaces inherited from interface sos.dated.util.DatedMap |
---|
DatedMap.Entry<K,V,D> |
Constructor Summary | |
---|---|
LinkedHashMapByDate()
Creates an insertion-ordered LinkedHashMapByDate
with a default initial capacity (16) and a default
load factor (0.75). |
|
LinkedHashMapByDate(DatedMap<? extends K,? extends V,D> datedMap)
Constructs an insertion-order LinkedHashMapByDate
initialized with the mappings of
datedMap . |
|
LinkedHashMapByDate(int initialCapacity)
Constructs an insertion-ordered LinkedHashMapByDate
with the specified initial capacity and
a default load factor (0.75). |
|
LinkedHashMapByDate(int initialCapacity,
float loadFactor)
Constructs an insertion-ordered LinkedHashMapByDate
with the specified initial capacity and
load factor. |
|
LinkedHashMapByDate(int initialCapacity,
float loadFactor,
boolean accessOrder)
Constructs an instance of LinkedHashMapByDate
with the specified initial capacity,
load factor, and ordering mode. |
Method Summary | |
---|---|
java.lang.Object |
clone()
Creates and returns a shallow copy of this object. |
protected java.util.Map<K,V> |
createMap(D from,
D to)
Returns a freshly created, empty LinkedHashMap . |
protected boolean |
removeEldestEntry(DatedMap.Entry<K,V,D> entry,
D from,
D to)
Returns true if this map should remove the specified eldest entry for
a given date range. |
Methods inherited from class sos.dated.util.AbstractMapByDate |
---|
checkForComodification, containsKey, containsValue, copyMap, dateIterator, entrySet, get, modCount, put, putAll, remove, upModCount |
Methods inherited from class sos.dated.util.AbstractDatedMap |
---|
clear, containsKeyThroughout, containsValueThroughout, equals, excludesKeyThroughout, excludesValueThroughout, get, hashCode, hasSizeThroughout, isEmpty, isEmptyThroughout, keySet, size, toString, values |
Methods inherited from class sos.dated.util.AbstractDatedObject |
---|
dateIterator, equals, hashCode, toString |
Methods inherited from class java.lang.Object |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
Methods inherited from interface sos.dated.util.DatedMap |
---|
clear, containsKey, containsKeyThroughout, containsValue, containsValueThroughout, entrySet, equals, excludesKeyThroughout, excludesValueThroughout, get, get, hashCode, hasSizeThroughout, isEmpty, isEmptyThroughout, keySet, put, putAll, remove, size, values |
Methods inherited from interface sos.dated.util.DatedObject |
---|
dateIterator, dateIterator, equals, hashCode, toString |
Constructor Detail |
---|
public LinkedHashMapByDate()
LinkedHashMapByDate
with a default initial capacity (16) and a default
load factor (0.75).
public LinkedHashMapByDate(int initialCapacity)
LinkedHashMapByDate
with the specified initial capacity and
a default load factor (0.75).
initialCapacity
- the initial capacity at all dates
java.lang.IllegalArgumentException
- if initialCapacity < 0
public LinkedHashMapByDate(int initialCapacity, float loadFactor)
LinkedHashMapByDate
with the specified initial capacity and
load factor.
initialCapacity
- the initial capacity at all datesloadFactor
- the load factor at all dates
java.lang.IllegalArgumentException
- if initialCapacity < 0
or
if loadFactor <= 0.0
public LinkedHashMapByDate(int initialCapacity, float loadFactor, boolean accessOrder)
LinkedHashMapByDate
with the specified initial capacity,
load factor, and ordering mode.
initialCapacity
- the initial capacity at all datesloadFactor
- the load factor at all datesaccessOrder
- true
for access order,
false
for insertion order
java.lang.IllegalArgumentException
- if initialCapacity < 0
or
if loadFactor <= 0.0
public LinkedHashMapByDate(DatedMap<? extends K,? extends V,D> datedMap)
LinkedHashMapByDate
initialized with the mappings of
datedMap
.
datedMap
- dated map with which to initialize this LinkedHashMapByDate
java.lang.NullPointerException
- if datedMap
is null
.Method Detail |
---|
public java.lang.Object clone()
clone
in class AbstractMapByDate<K,V,D>
protected java.util.Map<K,V> createMap(D from, D to)
LinkedHashMap
.
createMap
in class AbstractMapByDate<K,V,D>
from
- start date (inclusive) for which to create the mapto
- end date (exclusive) for which to create the map
LinkedHashMap
.protected boolean removeEldestEntry(DatedMap.Entry<K,V,D> entry, D from, D to)
true
if this map should remove the specified eldest entry for
a given date range.
entry
- eldest entry in questionfrom
- start of date range (inclusive) for which the entry is the eldestto
- end of date range (exclusive) for which the entry is the eldest
true
if entry
should be removed
java.lang.IllegalArgumentException
- if from
does not precede to
java.lang.NullPointerException
- if from
or to
is null
|
Side of Software Dated Collections Library 2.0 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |