com.opensymphony.xwork
Interface ValidationAware

All Known Subinterfaces:
ValidatorContext
All Known Implementing Classes:
ActionSupport, DelegatingValidatorContext, ValidationAwareSupport

public interface ValidationAware

ValidationAware classes can accept Action (class level) or field level error messages. Action level messages are kept in a Collection. Field level error messages are kept in a Map from String field name to a List of field error msgs.

Version:
$Revision: 1.11 $
Author:
$Author: mbogaert $

Method Summary
 void addActionError(String anErrorMessage)
          Add an Action-level error message to this Action.
 void addActionMessage(String aMessage)
          Add an Action-level message to this Action.
 void addFieldError(String fieldName, String errorMessage)
          Add an error message for a given field.
 Collection getActionErrors()
          Get the Collection of Action-level error messages for this action.
 Collection getActionMessages()
          Get the Collection of Action-level messages for this action.
 Map getFieldErrors()
          Get the field specific errors associated with this action.
 boolean hasActionErrors()
          Check whether there are any Action-level error messages.
 boolean hasActionMessages()
          Checks whether there are any Action-level messages.
 boolean hasErrors()
          Note that this does not have the same meaning as in WW 1.x.
 boolean hasFieldErrors()
          Check whether there are any field errors associated with this action.
 void setActionErrors(Collection errorMessages)
          Set the Collection of Action-level String error messages.
 void setActionMessages(Collection messages)
          Set the Collection of Action-level String messages (not errors).
 void setFieldErrors(Map errorMap)
          Set the field error map of fieldname (String) to Collection of String error messages.
 

Method Detail

setActionErrors

public void setActionErrors(Collection errorMessages)
Set the Collection of Action-level String error messages.

Parameters:
errorMessages -

getActionErrors

public Collection getActionErrors()
Get the Collection of Action-level error messages for this action. Error messages should not be added directly here, as implementations are free to return a new Collection or an Unmodifiable Collection.

Returns:
Collection of String error messages

setActionMessages

public void setActionMessages(Collection messages)
Set the Collection of Action-level String messages (not errors).


getActionMessages

public Collection getActionMessages()
Get the Collection of Action-level messages for this action. Messages should not be added directly here, as implementations are free to return a new Collection or an Unmodifiable Collection.

Returns:
Collection of String messages

setFieldErrors

public void setFieldErrors(Map errorMap)
Set the field error map of fieldname (String) to Collection of String error messages.

Parameters:
errorMap -

getFieldErrors

public Map getFieldErrors()
Get the field specific errors associated with this action. Error messages should not be added directly here, as implementations are free to return a new Collection or an Unmodifiable Collection.

Returns:
Map with errors mapped from fieldname (String) to Collection of String error messages

addActionError

public void addActionError(String anErrorMessage)
Add an Action-level error message to this Action.

Parameters:
anErrorMessage -

addActionMessage

public void addActionMessage(String aMessage)
Add an Action-level message to this Action.


addFieldError

public void addFieldError(String fieldName,
                          String errorMessage)
Add an error message for a given field.

Parameters:
fieldName - name of field
errorMessage - the error message

hasActionErrors

public boolean hasActionErrors()
Check whether there are any Action-level error messages.

Returns:
true if any Action-level error messages have been registered

hasActionMessages

public boolean hasActionMessages()
Checks whether there are any Action-level messages.

Returns:
true if any Action-level messages have been registered

hasErrors

public boolean hasErrors()
Note that this does not have the same meaning as in WW 1.x.

Returns:
(hasActionErrors() || hasFieldErrors())

hasFieldErrors

public boolean hasFieldErrors()
Check whether there are any field errors associated with this action.

Returns:
whether there are any field errors

XWork Project Page