[TAP5-1668] JavaDoc for @Parameter.value() should be clearer about the empty string

• Type: Bug
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 5.2
• Fix Version/s: 5.4
• Assignee: Howard Lewis Ship
• Reporter: Geoff Callender
• Created: 24/Sep/11 02:46
• Updated: 25/Jul/13 19:23
• Resolved: 25/Jul/13 19:23

Description

After reading the Parameter javadoc I expected these 3 to be equivalent.

@Parameter
private String tab;

@Parameter(value = "")
private String tab;

@Parameter
private String tab = "";

but they are not: if the parameter is not bound, then in the first two its value will be null, and in the third one it will be "".

The javadoc is http://tapestry.apache.org/tapestry5.2-dev/apidocs/org/apache/tapestry5/annotations/Parameter.html .

Is the behaviour wrong or does the javadoc need to be clearer?