|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.apache.struts.action.ActionForm
An ActionForm is a JavaBean optionally associated with
one or more ActionMappings
. Such a bean will have had its
properties initialized from the corresponding request parameters before
the corresonding action's perform()
method is called.
When the properties of this bean have been populated, but before the
perform()
method of the action is called, this bean's
validate()
method will be called, which gives the bean a chance
to verify that the properties submitted by the user are correct and valid.
If this method finds problems, it returns an error messages object that
encapsulates those problems, and the controller servlet will return control
to the corresponding input form. Otherwise, the validate()
method returns null()
, indicating that everything is acceptable
and the corresponding Action's perform()
method should be
called.
This class must be subclassed in order to be instantiated. Subclasses should provide property getter and setter methods for all of the bean properties they wish to expose, plus override any of the public or protected methods for which they wish to provide modified functionality.
Field Summary | |
protected MultipartRequestHandler |
multipartRequestHandler
The MultipartRequestHandler for this form, can be null |
protected ActionServlet |
servlet
The controller servlet instance to which we are attached. |
Constructor Summary | |
ActionForm()
|
Method Summary | |
MultipartRequestHandler |
getMultipartRequestHandler()
Return the MultipartRequestHandler for this form The reasoning behind this is to give form bean developers control over the lifecycle of their multipart requests through the use of the finish() and/or rollback() methods of MultipartRequestHandler. |
ActionServlet |
getServlet()
Return the controller servlet instance to which we are attached. |
void |
reset(ActionMapping mapping,
javax.servlet.http.HttpServletRequest request)
Reset all bean properties to their default state. |
void |
reset(ActionMapping mapping,
javax.servlet.ServletRequest request)
Reset all bean properties to their default state. |
void |
setMultipartRequestHandler(MultipartRequestHandler multipartRequestHandler)
|
void |
setServlet(ActionServlet servlet)
Set the controller servlet instance to which we are attached (if servlet is non-null), or release any allocated resources
(if servlet is null). |
java.lang.String[] |
validate()
Deprecated. This is the Struts 0.5 version of validation -- use the validate(ActionMapping,HttpServletRequest) method instead |
ActionErrors |
validate(ActionMapping mapping,
javax.servlet.http.HttpServletRequest request)
Validate the properties that have been set for this HTTP request, and return an ActionErrors object that encapsulates any
validation errors that have been found. |
ActionErrors |
validate(ActionMapping mapping,
javax.servlet.ServletRequest request)
Validate the properties that have been set for this non-HTTP request, and return an ActionErrors object that encapsulates any
validation errors that have been found. |
Methods inherited from class java.lang.Object |
|
Field Detail |
protected transient ActionServlet servlet
protected transient MultipartRequestHandler multipartRequestHandler
null
Constructor Detail |
public ActionForm()
Method Detail |
public ActionServlet getServlet()
public MultipartRequestHandler getMultipartRequestHandler()
null
if this form's enctype is not
"multipart/request-data".MultipartRequestHandler
public void setServlet(ActionServlet servlet)
servlet
is non-null), or release any allocated resources
(if servlet
is null).servlet
- The new controller servlet, if anypublic void setMultipartRequestHandler(MultipartRequestHandler multipartRequestHandler)
public void reset(ActionMapping mapping, javax.servlet.ServletRequest request)
The default implementation attempts to forward to the HTTP version of this method.
mapping
- The mapping used to select this instancerequest
- The servlet request we are processingpublic void reset(ActionMapping mapping, javax.servlet.http.HttpServletRequest request)
The default implementation does nothing. Subclasses should override this method to reset all bean properties to default values.
mapping
- The mapping used to select this instancerequest
- The servlet request we are processingpublic ActionErrors validate(ActionMapping mapping, javax.servlet.ServletRequest request)
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.
The default implementation attempts to forward to the HTTP version of this method.
mapping
- The mapping used to select this instancerequest
- The servlet request we are processingpublic java.lang.String[] validate()
null
.public ActionErrors validate(ActionMapping mapping, javax.servlet.http.HttpServletRequest request)
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.
The default ipmlementation performs no validation and returns
null
. Subclasses must override this method to provide
any validation they wish to perform.
mapping
- The mapping used to select this instancerequest
- The servlet request we are processing
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |