Author: jcompagner
Date: Mon Mar 24 04:35:43 2008
New Revision: 640386
URL: http://svn.apache.org/viewvc?rev=640386&view=rev
Log:
better javadoc explaining that checkRequired has to check isRequired first
Modified:
wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/markup/html/form/FormComponent.java
Modified:
wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/markup/html/form/FormComponent.java
URL:
http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/markup/html/form/FormComponent.java?rev=640386&r1=640385&r2=640386&view=diff
==============================================================================
---
wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/markup/html/form/FormComponent.java
(original)
+++
wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/markup/html/form/FormComponent.java
Mon Mar 24 04:35:43 2008
@@ -496,10 +496,18 @@
}
/**
- * Checks if the form component's 'required' requirement is met. This
method should typically
- * only be called when [EMAIL PROTECTED] #isRequired()} returns true.
+ * Checks if the form component's 'required' requirement is met by
first checking
+ * [EMAIL PROTECTED] #isRequired()} to see if it has to check for
requirement. If that is true then by
+ * default it checks if the input is null or an empty String
+ * [EMAIL PROTECTED] Strings#isEmpty(CharSequence)}
+ * <p>
+ * Subclasses that overwrite this method should also call [EMAIL
PROTECTED] #isRequired()} first.
+ * </p>
*
* @return true if the 'required' requirement is met, false otherwise
+ *
+ * @see Strings#isEmpty(CharSequence)
+ * @see #isInputNullable()
*/
public boolean checkRequired()
{
