[COLLECTIONS-288] Javadoc: incorrect behavior explained for ListUtils.transformedList

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 4.0-alpha1, 4.0
• Component/s: List
• Assignee: Unassigned
• Reporter: Paul Benedict
• Created: 17/Mar/08 16:34
• Updated: 09/Nov/14 14:31
• Resolved: 28/Feb/13 19:38

Description

The contract stated for ListUtils.transformedList is wrong. The list is not transformed – it decorates the existing list and transforms NEW objects – EXISTING objects are not transformed.

Compare this to the javadoc found in MapUtils.transformedMap:
"This method returns a new map (decorating the specified map) that will transform any new entries added to it. Existing entries in the specified map will not be transformed. "

That little missing piece of information messed me up. Just replace "map" with "list" and append it to the existing LilstUtils javadoc.

Issue Links

• is duplicated by: COLLECTIONS-256 ListUtils.transformedList(list, transformer) doesn't transform
• relates to: COLLECTIONS-348 Javadoc: incorrect behavior explained for XXXUtils.transformedXXX