Adding note that using switch is not type-safe

git-svn-id: https://svn.apache.org/repos/asf/jakarta/commons/proper/lang/trunk@466275 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Henri Yandell 2006-10-20 22:02:34 +00:00
parent 94530f113e
commit fd206080b0
1 changed files with 4 additions and 0 deletions

View File

@ -94,6 +94,10 @@ import org.apache.commons.lang.ClassUtils;
* <p>As shown, each enum has a name and a value. These can be accessed using
* <code>getName</code> and <code>getValue</code>.</p>
*
* <p><em>NOTE:</em> Because the switch is ultimately sitting on top of an
* int, the example above is not type-safe. That is, there is nothing that
* checks that JAVA1_0_VALUE is a legal constant for JavaVersionEnum. </p>
*
* <p>The <code>getEnum</code> and <code>iterator</code> methods are recommended.
* Unfortunately, Java restrictions require these to be coded as shown in each subclass.
* An alternative choice is to use the {@link EnumUtils} class.</p>