summaryrefslogtreecommitdiff
path: root/external/jsr166/java/util/concurrent/ConcurrentMap.java
diff options
context:
space:
mode:
authorTom Tromey <tromey@redhat.com>2006-06-16 18:12:22 +0000
committerTom Tromey <tromey@redhat.com>2006-06-16 18:12:22 +0000
commit6e3cb55ff69ff06734603f5c7f5d45f069a52db0 (patch)
tree0208d06669c5e74a875cff595e4b44ecad89fe1b /external/jsr166/java/util/concurrent/ConcurrentMap.java
parentfb10a7fb852158d97502c3658e3112193f8dd05f (diff)
downloadclasspath-6e3cb55ff69ff06734603f5c7f5d45f069a52db0.tar.gz
* external/jsr166: Removed files from cvs trunk.
Diffstat (limited to 'external/jsr166/java/util/concurrent/ConcurrentMap.java')
-rw-r--r--external/jsr166/java/util/concurrent/ConcurrentMap.java134
1 files changed, 0 insertions, 134 deletions
diff --git a/external/jsr166/java/util/concurrent/ConcurrentMap.java b/external/jsr166/java/util/concurrent/ConcurrentMap.java
deleted file mode 100644
index 6e5bd0738..000000000
--- a/external/jsr166/java/util/concurrent/ConcurrentMap.java
+++ /dev/null
@@ -1,134 +0,0 @@
-/*
- * Written by Doug Lea with assistance from members of JCP JSR-166
- * Expert Group and released to the public domain, as explained at
- * http://creativecommons.org/licenses/publicdomain
- */
-
-package java.util.concurrent;
-import java.util.Map;
-
-/**
- * A {@link java.util.Map} providing additional atomic
- * <tt>putIfAbsent</tt>, <tt>remove</tt>, and <tt>replace</tt> methods.
- *
- * <p>Memory consistency effects: As with other concurrent
- * collections, actions in a thread prior to placing an object into a
- * {@code ConcurrentMap} as a key or value
- * <a href="package-summary.html#MemoryVisibility"><i>happen-before</i></a>
- * actions subsequent to the access or removal of that object from
- * the {@code ConcurrentMap} in another thread.
- *
- * <p>This interface is a member of the
- * <a href="{@docRoot}/../technotes/guides/collections/index.html">
- * Java Collections Framework</a>.
- *
- * @since 1.5
- * @author Doug Lea
- * @param <K> the type of keys maintained by this map
- * @param <V> the type of mapped values
- */
-public interface ConcurrentMap<K, V> extends Map<K, V> {
- /**
- * If the specified key is not already associated
- * with a value, associate it with the given value.
- * This is equivalent to
- * <pre>
- * if (!map.containsKey(key))
- * return map.put(key, value);
- * else
- * return map.get(key);</pre>
- * except that the action is performed atomically.
- *
- * @param key key with which the specified value is to be associated
- * @param value value to be associated with the specified key
- * @return the previous value associated with the specified key, or
- * <tt>null</tt> if there was no mapping for the key.
- * (A <tt>null</tt> return can also indicate that the map
- * previously associated <tt>null</tt> with the key,
- * if the implementation supports null values.)
- * @throws UnsupportedOperationException if the <tt>put</tt> operation
- * is not supported by this map
- * @throws ClassCastException if the class of the specified key or value
- * prevents it from being stored in this map
- * @throws NullPointerException if the specified key or value is null,
- * and this map does not permit null keys or values
- * @throws IllegalArgumentException if some property of the specified key
- * or value prevents it from being stored in this map
- *
- */
- V putIfAbsent(K key, V value);
-
- /**
- * Removes the entry for a key only if currently mapped to a given value.
- * This is equivalent to
- * <pre>
- * if (map.containsKey(key) &amp;&amp; map.get(key).equals(value)) {
- * map.remove(key);
- * return true;
- * } else return false;</pre>
- * except that the action is performed atomically.
- *
- * @param key key with which the specified value is associated
- * @param value value expected to be associated with the specified key
- * @return <tt>true</tt> if the value was removed
- * @throws UnsupportedOperationException if the <tt>remove</tt> operation
- * is not supported by this map
- * @throws ClassCastException if the key or value is of an inappropriate
- * type for this map (optional)
- * @throws NullPointerException if the specified key or value is null,
- * and this map does not permit null keys or values (optional)
- */
- boolean remove(Object key, Object value);
-
- /**
- * Replaces the entry for a key only if currently mapped to a given value.
- * This is equivalent to
- * <pre>
- * if (map.containsKey(key) &amp;&amp; map.get(key).equals(oldValue)) {
- * map.put(key, newValue);
- * return true;
- * } else return false;</pre>
- * except that the action is performed atomically.
- *
- * @param key key with which the specified value is associated
- * @param oldValue value expected to be associated with the specified key
- * @param newValue value to be associated with the specified key
- * @return <tt>true</tt> if the value was replaced
- * @throws UnsupportedOperationException if the <tt>put</tt> operation
- * is not supported by this map
- * @throws ClassCastException if the class of a specified key or value
- * prevents it from being stored in this map
- * @throws NullPointerException if a specified key or value is null,
- * and this map does not permit null keys or values
- * @throws IllegalArgumentException if some property of a specified key
- * or value prevents it from being stored in this map
- */
- boolean replace(K key, V oldValue, V newValue);
-
- /**
- * Replaces the entry for a key only if currently mapped to some value.
- * This is equivalent to
- * <pre>
- * if (map.containsKey(key)) {
- * return map.put(key, value);
- * } else return null;</pre>
- * except that the action is performed atomically.
- *
- * @param key key with which the specified value is associated
- * @param value value to be associated with the specified key
- * @return the previous value associated with the specified key, or
- * <tt>null</tt> if there was no mapping for the key.
- * (A <tt>null</tt> return can also indicate that the map
- * previously associated <tt>null</tt> with the key,
- * if the implementation supports null values.)
- * @throws UnsupportedOperationException if the <tt>put</tt> operation
- * is not supported by this map
- * @throws ClassCastException if the class of the specified key or value
- * prevents it from being stored in this map
- * @throws NullPointerException if the specified key or value is null,
- * and this map does not permit null keys or values
- * @throws IllegalArgumentException if some property of the specified key
- * or value prevents it from being stored in this map
- */
- V replace(K key, V value);
-}