[LANG-258] Enum JavaDoc: 1) outline 5.0 native Enum migration 2) warn not to use the switch() , 3) point out approaches for persistence and gui

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 2.1
• Fix Version/s: 2.3

Environment

all

• Assignee: Unassigned
• Reporter: Ralf Hauser
• Created: 21/May/06 00:31
• Updated: 06/Feb/07 23:47
• Resolved: 20/Oct/06 22:37

Description

http://jakarta.apache.org/commons/lang/api/org/apache/commons/lang/enums/Enum.html is great!

Now that Jdk5.0 has its own approach for type-safe enums, would it be great to provide a few sentences

• whether they simply should co-habit?
• how one would best migrate?
• where the concepts are different

Also, it would be great to provide some hints how to work on the with a MVC/GUI framework - see SB-20.

also, http://jakarta.apache.org/commons/lang/api/org/apache/commons/lang/enums/ValuedEnum.html has a minor typo

it says "doSomething(JavaVersion", but should say "doSomething(JavaVersionEnum"

also, it should contain a big warning that by using switch(), one opens up for type-unsafety!

Issue Links

• relates to: LANG-259 ValuedEnum.compareTo(Object other) not typesafe - it easily could be...