OpenJDK / amber / amber
changeset 64:3244b8bab101
6583872: (coll) Direct uninformed users away from Vector/Hashtable
Reviewed-by: dholmes
author | martin |
---|---|
date | Mon, 10 Mar 2008 23:23:48 -0700 |
parents | 919733f875ac |
children | 51fc1d79463f |
files | jdk/src/share/classes/java/util/Hashtable.java jdk/src/share/classes/java/util/Vector.java |
diffstat | 2 files changed, 14 insertions(+), 8 deletions(-) [+] |
line wrap: on
line diff
--- a/jdk/src/share/classes/java/util/Hashtable.java Mon Mar 10 23:23:48 2008 -0700 +++ b/jdk/src/share/classes/java/util/Hashtable.java Mon Mar 10 23:23:48 2008 -0700 @@ -100,9 +100,15 @@ * * <p>As of the Java 2 platform v1.2, this class was retrofitted to * implement the {@link Map} interface, making it a member of the - * <a href="{@docRoot}/../technotes/guides/collections/index.html"> Java - * Collections Framework</a>. Unlike the new collection - * implementations, {@code Hashtable} is synchronized. + * <a href="{@docRoot}/../technotes/guides/collections/index.html"> + * + * Java Collections Framework</a>. Unlike the new collection + * implementations, {@code Hashtable} is synchronized. If a + * thread-safe implementation is not needed, it is recommended to use + * {@link HashMap} in place of {@code Hashtable}. If a thread-safe + * highly-concurrent implementation is desired, then it is recommended + * to use {@link java.util.concurrent.ConcurrentHashMap} in place of + * {@code Hashtable}. * * @author Arthur van Hoff * @author Josh Bloch
--- a/jdk/src/share/classes/java/util/Vector.java Mon Mar 10 23:23:48 2008 -0700 +++ b/jdk/src/share/classes/java/util/Vector.java Mon Mar 10 23:23:48 2008 -0700 @@ -64,15 +64,15 @@ * * <p>As of the Java 2 platform v1.2, this class was retrofitted to * implement the {@link List} interface, making it a member of the - * <a href="{@docRoot}/../technotes/guides/collections/index.html"> Java - * Collections Framework</a>. Unlike the new collection - * implementations, {@code Vector} is synchronized. + * <a href="{@docRoot}/../technotes/guides/collections/index.html"> + * Java Collections Framework</a>. Unlike the new collection + * implementations, {@code Vector} is synchronized. If a thread-safe + * implementation is not needed, it is recommended to use {@link + * ArrayList} in place of {@code Vector}. * * @author Lee Boynton * @author Jonathan Payne * @see Collection - * @see List - * @see ArrayList * @see LinkedList * @since JDK1.0 */