stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8039527: Broken links in ConcurrentMap javadoc

Browse Source 
Reviewed-by: martin, alanb
This commit is contained in:
Chris Hegarty 2014-04-10 11:01:15 +01:00
parent 818bdc8117
commit b8e32d8ca5
1 changed files with 32 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

64
jdk/src/share/classes/java/util/Map.java
View File

@ -157,10 +157,10 @@ public interface Map<K,V> {
* key * key
* @throws ClassCastException if the key is of an inappropriate type for * @throws ClassCastException if the key is of an inappropriate type for
* this map * this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified key is null and this map * @throws NullPointerException if the specified key is null and this map
* does not permit null keys * does not permit null keys
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
boolean containsKey(Object key); boolean containsKey(Object key);
@ -177,10 +177,10 @@ public interface Map<K,V> {
* specified value * specified value
* @throws ClassCastException if the value is of an inappropriate type for * @throws ClassCastException if the value is of an inappropriate type for
* this map * this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified value is null and this * @throws NullPointerException if the specified value is null and this
* map does not permit null values * map does not permit null values
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
boolean containsValue(Object value); boolean containsValue(Object value);
@ -204,10 +204,10 @@ public interface Map<K,V> {
* {@code null} if this map contains no mapping for the key * {@code null} if this map contains no mapping for the key
* @throws ClassCastException if the key is of an inappropriate type for * @throws ClassCastException if the key is of an inappropriate type for
* this map * this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified key is null and this map * @throws NullPointerException if the specified key is null and this map
* does not permit null keys * does not permit null keys
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
V get(Object key); V get(Object key);
@ -264,10 +264,10 @@ public interface Map<K,V> {
* is not supported by this map * is not supported by this map
* @throws ClassCastException if the key is of an inappropriate type for * @throws ClassCastException if the key is of an inappropriate type for
* this map * this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified key is null and this * @throws NullPointerException if the specified key is null and this
* map does not permit null keys * map does not permit null keys
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
V remove(Object key); V remove(Object key);
@ -577,10 +577,10 @@ public interface Map<K,V> {
* {@code defaultValue} if this map contains no mapping for the key * {@code defaultValue} if this map contains no mapping for the key
* @throws ClassCastException if the key is of an inappropriate type for * @throws ClassCastException if the key is of an inappropriate type for
* this map * this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified key is null and this map * @throws NullPointerException if the specified key is null and this map
* does not permit null keys * does not permit null keys
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @since 1.8 * @since 1.8
*/ */
default V getOrDefault(Object key, V defaultValue) { default V getOrDefault(Object key, V defaultValue) {
@ -659,13 +659,13 @@ public interface Map<K,V> {
* values * values
* @throws ClassCastException if a replacement value is of an inappropriate * @throws ClassCastException if a replacement value is of an inappropriate
* type for this map * type for this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if function or a replacement value is null, * @throws NullPointerException if function or a replacement value is null,
* and this map does not permit null keys or values * and this map does not permit null keys or values
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws IllegalArgumentException if some property of a replacement value * @throws IllegalArgumentException if some property of a replacement value
* prevents it from being stored in this map * prevents it from being stored in this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ConcurrentModificationException if an entry is found to be * @throws ConcurrentModificationException if an entry is found to be
* removed during iteration * removed during iteration
* @since 1.8 * @since 1.8
@ -726,16 +726,16 @@ public interface Map<K,V> {
* if the implementation supports null values.) * if the implementation supports null values.)
* @throws UnsupportedOperationException if the {@code put} operation * @throws UnsupportedOperationException if the {@code put} operation
* is not supported by this map * is not supported by this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ClassCastException if the key or value is of an inappropriate * @throws ClassCastException if the key or value is of an inappropriate
* type for this map * type for this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified key or value is null, * @throws NullPointerException if the specified key or value is null,
* and this map does not permit null keys or values * and this map does not permit null keys or values
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws IllegalArgumentException if some property of the specified key * @throws IllegalArgumentException if some property of the specified key
* or value prevents it from being stored in this map * or value prevents it from being stored in this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @since 1.8 * @since 1.8
*/ */
default V putIfAbsent(K key, V value) { default V putIfAbsent(K key, V value) {
@ -772,13 +772,13 @@ public interface Map<K,V> {
* @return {@code true} if the value was removed * @return {@code true} if the value was removed
* @throws UnsupportedOperationException if the {@code remove} operation * @throws UnsupportedOperationException if the {@code remove} operation
* is not supported by this map * is not supported by this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ClassCastException if the key or value is of an inappropriate * @throws ClassCastException if the key or value is of an inappropriate
* type for this map * type for this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified key or value is null, * @throws NullPointerException if the specified key or value is null,
* and this map does not permit null keys or values * and this map does not permit null keys or values
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @since 1.8 * @since 1.8
*/ */
default boolean remove(Object key, Object value) { default boolean remove(Object key, Object value) {
@ -821,14 +821,14 @@ public interface Map<K,V> {
* @return {@code true} if the value was replaced * @return {@code true} if the value was replaced
* @throws UnsupportedOperationException if the {@code put} operation * @throws UnsupportedOperationException if the {@code put} operation
* is not supported by this map * is not supported by this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ClassCastException if the class of a specified key or value * @throws ClassCastException if the class of a specified key or value
* prevents it from being stored in this map * prevents it from being stored in this map
* @throws NullPointerException if a specified key or newValue is null, * @throws NullPointerException if a specified key or newValue is null,
* and this map does not permit null keys or values * and this map does not permit null keys or values
* @throws NullPointerException if oldValue is null and this map does not * @throws NullPointerException if oldValue is null and this map does not
* permit null values * permit null values
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws IllegalArgumentException if some property of a specified key * @throws IllegalArgumentException if some property of a specified key
* or value prevents it from being stored in this map * or value prevents it from being stored in this map
* @since 1.8 * @since 1.8
@ -871,10 +871,10 @@ public interface Map<K,V> {
* if the implementation supports null values.) * if the implementation supports null values.)
* @throws UnsupportedOperationException if the {@code put} operation * @throws UnsupportedOperationException if the {@code put} operation
* is not supported by this map * is not supported by this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ClassCastException if the class of the specified key or value * @throws ClassCastException if the class of the specified key or value
* prevents it from being stored in this map * prevents it from being stored in this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified key or value is null, * @throws NullPointerException if the specified key or value is null,
* and this map does not permit null keys or values * and this map does not permit null keys or values
* @throws IllegalArgumentException if some property of the specified key * @throws IllegalArgumentException if some property of the specified key
@ -942,10 +942,10 @@ public interface Map<K,V> {
* is null * is null
* @throws UnsupportedOperationException if the {@code put} operation * @throws UnsupportedOperationException if the {@code put} operation
* is not supported by this map * is not supported by this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ClassCastException if the class of the specified key or value * @throws ClassCastException if the class of the specified key or value
* prevents it from being stored in this map * prevents it from being stored in this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @since 1.8 * @since 1.8
*/ */
default V computeIfAbsent(K key, default V computeIfAbsent(K key,
@ -1003,10 +1003,10 @@ public interface Map<K,V> {
* remappingFunction is null * remappingFunction is null
* @throws UnsupportedOperationException if the {@code put} operation * @throws UnsupportedOperationException if the {@code put} operation
* is not supported by this map * is not supported by this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ClassCastException if the class of the specified key or value * @throws ClassCastException if the class of the specified key or value
* prevents it from being stored in this map * prevents it from being stored in this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @since 1.8 * @since 1.8
*/ */
default V computeIfPresent(K key, default V computeIfPresent(K key,
@ -1079,10 +1079,10 @@ public interface Map<K,V> {
* remappingFunction is null * remappingFunction is null
* @throws UnsupportedOperationException if the {@code put} operation * @throws UnsupportedOperationException if the {@code put} operation
* is not supported by this map * is not supported by this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ClassCastException if the class of the specified key or value * @throws ClassCastException if the class of the specified key or value
* prevents it from being stored in this map * prevents it from being stored in this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @since 1.8 * @since 1.8
*/ */
default V compute(K key, default V compute(K key,
@ -1157,10 +1157,10 @@ public interface Map<K,V> {
* value is associated with the key * value is associated with the key
* @throws UnsupportedOperationException if the {@code put} operation * @throws UnsupportedOperationException if the {@code put} operation
* is not supported by this map * is not supported by this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ClassCastException if the class of the specified key or value * @throws ClassCastException if the class of the specified key or value
* prevents it from being stored in this map * prevents it from being stored in this map
* (<a href="Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified key is null and this map * @throws NullPointerException if the specified key is null and this map
* does not support null keys or the value or remappingFunction is * does not support null keys or the value or remappingFunction is
* null * null