123 * the iterator is created, in any way except through the iterator's own
124 * {@code remove} method, the iterator will throw a {@link
125 * ConcurrentModificationException}. Thus, in the face of concurrent
126 * modification, the iterator fails quickly and cleanly, rather than risking
127 * arbitrary, non-deterministic behavior at an undetermined time in the future.
128 *
129 * <p>Note that the fail-fast behavior of an iterator cannot be guaranteed
130 * as it is, generally speaking, impossible to make any hard guarantees in the
131 * presence of unsynchronized concurrent modification. Fail-fast iterators
132 * throw {@code ConcurrentModificationException} on a best-effort basis.
133 * Therefore, it would be wrong to write a program that depended on this
134 * exception for its correctness: <i>the fail-fast behavior of iterators
135 * should be used only to detect bugs.</i>
136 *
137 * <p>The spliterators returned by the spliterator method of the collections
138 * returned by all of this class's collection view methods are
139 * <em><a href="Spliterator.html#binding">late-binding</a></em>,
140 * <em>fail-fast</em>, and additionally report {@link Spliterator#ORDERED}.
141 *
142 * <p>This class is a member of the
143 * <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework">
144 * Java Collections Framework</a>.
145 *
146 * @implNote
147 * The spliterators returned by the spliterator method of the collections
148 * returned by all of this class's collection view methods are created from
149 * the iterators of the corresponding collections.
150 *
151 * @param <K> the type of keys maintained by this map
152 * @param <V> the type of mapped values
153 *
154 * @author Josh Bloch
155 * @see Object#hashCode()
156 * @see Collection
157 * @see Map
158 * @see HashMap
159 * @see TreeMap
160 * @see Hashtable
161 * @since 1.4
162 */
163 public class LinkedHashMap<K,V>
|
123 * the iterator is created, in any way except through the iterator's own
124 * {@code remove} method, the iterator will throw a {@link
125 * ConcurrentModificationException}. Thus, in the face of concurrent
126 * modification, the iterator fails quickly and cleanly, rather than risking
127 * arbitrary, non-deterministic behavior at an undetermined time in the future.
128 *
129 * <p>Note that the fail-fast behavior of an iterator cannot be guaranteed
130 * as it is, generally speaking, impossible to make any hard guarantees in the
131 * presence of unsynchronized concurrent modification. Fail-fast iterators
132 * throw {@code ConcurrentModificationException} on a best-effort basis.
133 * Therefore, it would be wrong to write a program that depended on this
134 * exception for its correctness: <i>the fail-fast behavior of iterators
135 * should be used only to detect bugs.</i>
136 *
137 * <p>The spliterators returned by the spliterator method of the collections
138 * returned by all of this class's collection view methods are
139 * <em><a href="Spliterator.html#binding">late-binding</a></em>,
140 * <em>fail-fast</em>, and additionally report {@link Spliterator#ORDERED}.
141 *
142 * <p>This class is a member of the
143 * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
144 * Java Collections Framework</a>.
145 *
146 * @implNote
147 * The spliterators returned by the spliterator method of the collections
148 * returned by all of this class's collection view methods are created from
149 * the iterators of the corresponding collections.
150 *
151 * @param <K> the type of keys maintained by this map
152 * @param <V> the type of mapped values
153 *
154 * @author Josh Bloch
155 * @see Object#hashCode()
156 * @see Collection
157 * @see Map
158 * @see HashMap
159 * @see TreeMap
160 * @see Hashtable
161 * @since 1.4
162 */
163 public class LinkedHashMap<K,V>
|