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 */