Apache Struts API Documentation: Class DynaValidatorForm

org.apache.struts.validator Class DynaValidatorForm

java.lang.Object
  |
  +--org.apache.struts.action.ActionForm
        |
        +--org.apache.struts.action.DynaActionForm
              |
              +--org.apache.struts.validator.DynaValidatorForm

All Implemented Interfaces:

org.apache.commons.beanutils.DynaBean, java.io.Serializable

Direct Known Subclasses:

DynaValidatorActionForm

public class DynaValidatorForm

extends DynaActionForm

implements org.apache.commons.beanutils.DynaBean, java.io.Serializable

This class extends DynaActionForm and provides basic field validation based on an XML file. The key passed into the validator is the action element's 'name' attribute from the struts-config.xml which should match the form element's name attribute in the validation.xml.

• See ValidatorPlugin definition in struts-config.xml for validation rules.

Since:

Struts 1.1

Version:

$Rev: 164862 $ $Date: 2005-04-26 20:08:32 +0100 (Tue, 26 Apr 2005) $

See Also:

ActionForm, Serialized Form

log

private static org.apache.commons.logging.Log log

Commons Logging instance.

validatorResults

protected org.apache.commons.validator.ValidatorResults validatorResults

The results returned from the validation performed by the Validator.

page

protected int page

Used to indicate the current page of a multi-page form.

DynaValidatorForm

public DynaValidatorForm()

getPage

public int getPage()

Gets page.

Returns:

page number.

setPage

public void setPage(int page)

Sets page.

Parameters:

page - page number

validate

public ActionErrors validate(ActionMapping mapping,
                             javax.servlet.http.HttpServletRequest request)

Validate the properties that have been set from this HTTP request, and return an ActionErrors object that encapsulates any validation errors that have been found. If no errors are found, return null or an ActionErrors object with no recorded error messages.

Overrides:

validate in class ActionForm

Parameters:

mapping - The mapping used to select this instance.

request - The servlet request we are processing.

Returns:

ActionErrors object that encapsulates any validation errors.

getValidationKey

public java.lang.String getValidationKey(ActionMapping mapping,
                                         javax.servlet.http.HttpServletRequest request)

Returns the Validation key.

Parameters:

mapping - The mapping used to select this instance

request - The servlet request we are processing

Returns:

validation key - the form element's name in this case

setPageFromDynaProperty

protected void setPageFromDynaProperty()

Sets this.page to the value of the Dyna property "page" if it's defined. This is used to setup the page variable before validation starts.

Since:

Struts 1.2

reset

public void reset(ActionMapping mapping,
                  javax.servlet.http.HttpServletRequest request)

Reset all properties to their default values.

Overrides:

reset in class DynaActionForm

Parameters:

mapping - The mapping used to select this instance

request - The servlet request we are processing

getValidatorResults

public org.apache.commons.validator.ValidatorResults getValidatorResults()

Get results of the validation performed by the Validator.

Returns:

validator results as ValidatorResults object

setValidatorResults

public void setValidatorResults(org.apache.commons.validator.ValidatorResults validatorResults)

Set results of the validation performed by the Validator.

Parameters:

validatorResults - Set results of the validation performed

getResultValueMap

public java.util.Map getResultValueMap()

Returns a Map of values returned from any validation that returns a value other than null or Boolean with the key the full property path of the field.

Returns:

Returns a Map of values, otherwise returns null if no results.