svn commit: r603147 - /wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/convert/IConverter.java

[iv...@apache.org]

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 {@link Date} object.
+ * 
+ * Notice that incoming value, when used by a FormComponent, will never be null because before
+ * validation form components perform the required (see {@link 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