Author: jbq
Date: Wed Feb 21 09:38:19 2007
New Revision: 510115
URL: http://svn.apache.org/viewvc?view=rev&rev=510115
Log:
Improve Javadoc for Form.validate() to dissuade users from overriding this
method unnecessarily
Modified:
incubator/wicket/branches/wicket-1.x/wicket/src/main/java/wicket/markup/html/form/Form.java
incubator/wicket/trunk/wicket/src/main/java/wicket/markup/html/form/Form.java
Modified:
incubator/wicket/branches/wicket-1.x/wicket/src/main/java/wicket/markup/html/form/Form.java
URL:
http://svn.apache.org/viewvc/incubator/wicket/branches/wicket-1.x/wicket/src/main/java/wicket/markup/html/form/Form.java?view=diff&rev=510115&r1=510114&r2=510115
==============================================================================
---
incubator/wicket/branches/wicket-1.x/wicket/src/main/java/wicket/markup/html/form/Form.java
(original)
+++
incubator/wicket/branches/wicket-1.x/wicket/src/main/java/wicket/markup/html/form/Form.java
Wed Feb 21 09:38:19 2007
@@ -957,8 +957,13 @@
}
/**
- * Validates the form. This method is typically called before updating
any
- * models.
+ * Validates the form by checking required fields, converting raw input
and
+ * running validators for every form component, and last running global
form
+ * validators. This method is typically called before updating any
models.
+ * <p>
+ * NOTE: in most cases, custom validations on the form can be achieved
using
+ * an IFormValidator that can be added using addValidator().
+ * </p>
*/
protected void validate()
{
Modified:
incubator/wicket/trunk/wicket/src/main/java/wicket/markup/html/form/Form.java
URL:
http://svn.apache.org/viewvc/incubator/wicket/trunk/wicket/src/main/java/wicket/markup/html/form/Form.java?view=diff&rev=510115&r1=510114&r2=510115
==============================================================================
---
incubator/wicket/trunk/wicket/src/main/java/wicket/markup/html/form/Form.java
(original)
+++
incubator/wicket/trunk/wicket/src/main/java/wicket/markup/html/form/Form.java
Wed Feb 21 09:38:19 2007
@@ -1025,8 +1025,13 @@
}
/**
- * Validates the form. This method is typically called before updating
any
- * models.
+ * Validates the form by checking required fields, converting raw input
and
+ * running validators for every form component, and last running global
form
+ * validators. This method is typically called before updating any
models.
+ * <p>
+ * NOTE: in most cases, custom validations on the form can be achieved
using
+ * an IFormValidator that can be added using addValidator().
+ * </p>
*/
protected void validate()
{
