When iterating through the collections supplied by this class, the ordering of values for a given key agrees with the order in which the values were added.
This multimap allows duplicate key-value pairs. After adding a new key-value pair equal to an existing key-value pair, the {@code ArrayListMultimap} will contain entries for both the new value and the oldvalue.
Keys and values may be null. All optional multimap methods are supported, and all returned views are modifiable.
The lists returned by {@link #get}, {@link #removeAll}, and {@link #replaceValues} all implement {@link java.util.RandomAccess}.
This class is not threadsafe when any concurrent operations update the multimap. Concurrent read operations will work correctly. To allow concurrent update operations, wrap your multimap with a call to {@link Multimaps#synchronizedListMultimap}. @author Jared Levy @since Guava release 02 (imported from Google Collections Library)
| |