Author: ivaynberg
Date: Mon Dec 10 21:37:45 2007
New Revision: 603147
URL: http://svn.apache.org/viewvc?rev=603147&view=rev
Log:
WICKET-1179 Javadoc for IConverter need to be more clear regarding nullable
arguments
Modified:
wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/convert/IConverter.java
Modified:
wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/convert/IConverter.java
URL:
http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/convert/IConverter.java?rev=603147&r1=603146&r2=603147&view=diff
==============================================================================
---
wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/convert/IConverter.java
(original)
+++
wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/convert/IConverter.java
Mon Dec 10 21:37:45 2007
@@ -20,6 +20,7 @@
import java.util.Locale;
import org.apache.wicket.IClusterable;
+import org.apache.wicket.markup.html.form.FormComponent;
/**
@@ -32,6 +33,11 @@
* components to interpret incoming values Such values are strings as they are
send as request
* parameters from browsers. An incoming value could be the string
'12/12/2007' which could be
* translated to a corresponding [EMAIL PROTECTED] Date} object.
+ *
+ * Notice that incoming value, when used by a FormComponent, will never be
null because before
+ * validation form components perform the required (see [EMAIL PROTECTED]
FormComponent#isRequired()} check
+ * which errors out on null values. In the case the FormComponent is not
required and the user
+ * enters a null value converters will not be invoked because no type
conversion is necessary.
* </p>
*
* @author Eelco Hillenius
