requestprocessor.html

struts api,学习使用struts必备的文档

                                    javax.servlet.ServletException</PRE>
<DL>
<DD><p>Forward or redirect to the specified destination, by the specified
 mechanism.  This method uses a <code>ForwardConfig</code> object instead
 an <code>ActionForward</code>.</p><DD><DL>
<DT><B>Parameters:</B><DD><CODE>request</CODE> - The servlet request we are processing<DD><CODE>response</CODE> - The servlet response we are creating<DD><CODE>forward</CODE> - The ForwardConfig controlling where we go next<DT><B>Throws:</B><DD><CODE>java.io.IOException</CODE> - if an input/output error occurs<DD><CODE>javax.servlet.ServletException</CODE> - if a servlet exception occurs</DL>
</DD>
</DL>
<HR>

<A NAME="processActionPerform(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, org.apache.struts.action.Action, org.apache.struts.action.ActionForm, org.apache.struts.action.ActionMapping)"><!-- --></A><H3>
processActionPerform</H3>
<PRE>
protected <A HREF="../../../../org/apache/struts/action/ActionForward.html">ActionForward</A> <B>processActionPerform</B>(javax.servlet.http.HttpServletRequest&nbsp;request,
                                             javax.servlet.http.HttpServletResponse&nbsp;response,
                                             <A HREF="../../../../org/apache/struts/action/Action.html">Action</A>&nbsp;action,
                                             <A HREF="../../../../org/apache/struts/action/ActionForm.html">ActionForm</A>&nbsp;form,
                                             <A HREF="../../../../org/apache/struts/action/ActionMapping.html">ActionMapping</A>&nbsp;mapping)
                                      throws java.io.IOException,
                                             javax.servlet.ServletException</PRE>
<DL>
<DD><P>Ask the specified <code>Action</code> instance to handle this
 request. Return the <code>ActionForward</code> instance (if any)
 returned by the called <code>Action</code> for further processing.
 </P><DD><DL>
<DT><B>Parameters:</B><DD><CODE>request</CODE> - The servlet request we are processing<DD><CODE>response</CODE> - The servlet response we are creating<DD><CODE>action</CODE> - The Action instance to be used<DD><CODE>form</CODE> - The ActionForm instance to pass to this Action<DD><CODE>mapping</CODE> - The ActionMapping instance to pass to this Action<DT><B>Throws:</B><DD><CODE>java.io.IOException</CODE> - if an input/output error occurs<DD><CODE>javax.servlet.ServletException</CODE> - if a servlet exception occurs</DL>
</DD>
</DL>
<HR>

<A NAME="processCachedMessages(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse)"><!-- --></A><H3>
processCachedMessages</H3>
<PRE>
protected void <B>processCachedMessages</B>(javax.servlet.http.HttpServletRequest&nbsp;request,
                                     javax.servlet.http.HttpServletResponse&nbsp;response)</PRE>
<DL>
<DD><p>Removes any <code>ActionMessages</code> object stored in the session 
 under <code>Globals.MESSAGE_KEY</code> and <code>Globals.ERROR_KEY</code> 
 if the messages' <code>isAccessed</code> method returns true.  This 
 allows messages to be stored in the session, display one time, and be 
 released here.</p><DD><DL>
<DT><B>Parameters:</B><DD><CODE>request</CODE> - The servlet request we are processing.<DD><CODE>response</CODE> - The servlet response we are creating.<DT><B>Since: </B><DD>Struts 1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="processContent(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse)"><!-- --></A><H3>
processContent</H3>
<PRE>
protected void <B>processContent</B>(javax.servlet.http.HttpServletRequest&nbsp;request,
                              javax.servlet.http.HttpServletResponse&nbsp;response)</PRE>
<DL>
<DD><p>Set the default content type (with optional character encoding) for
 all responses if requested.  <strong>NOTE</strong> - This header will
 be overridden automatically if a
 <code>RequestDispatcher.forward</code> call is
 ultimately invoked.</p><DD><DL>
<DT><B>Parameters:</B><DD><CODE>request</CODE> - The servlet request we are processing<DD><CODE>response</CODE> - The servlet response we are creating</DL>
</DD>
</DL>
<HR>

<A NAME="processException(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, java.lang.Exception, org.apache.struts.action.ActionForm, org.apache.struts.action.ActionMapping)"><!-- --></A><H3>
processException</H3>
<PRE>
protected <A HREF="../../../../org/apache/struts/action/ActionForward.html">ActionForward</A> <B>processException</B>(javax.servlet.http.HttpServletRequest&nbsp;request,
                                         javax.servlet.http.HttpServletResponse&nbsp;response,
                                         java.lang.Exception&nbsp;exception,
                                         <A HREF="../../../../org/apache/struts/action/ActionForm.html">ActionForm</A>&nbsp;form,
                                         <A HREF="../../../../org/apache/struts/action/ActionMapping.html">ActionMapping</A>&nbsp;mapping)
                                  throws java.io.IOException,
                                         javax.servlet.ServletException</PRE>
<DL>
<DD><p>Ask our exception handler to handle the exception. Return the
 <code>ActionForward</code> instance (if any) returned by the
 called <code>ExceptionHandler</code>.</p><DD><DL>
<DT><B>Parameters:</B><DD><CODE>request</CODE> - The servlet request we are processing<DD><CODE>response</CODE> - The servlet response we are processing<DD><CODE>exception</CODE> - The exception being handled<DD><CODE>form</CODE> - The ActionForm we are processing<DD><CODE>mapping</CODE> - The ActionMapping we are using<DT><B>Throws:</B><DD><CODE>java.io.IOException</CODE> - if an input/output error occurs<DD><CODE>javax.servlet.ServletException</CODE> - if a servlet exception occurs</DL>
</DD>
</DL>
<HR>

<A NAME="processForward(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, org.apache.struts.action.ActionMapping)"><!-- --></A><H3>
processForward</H3>
<PRE>
protected boolean <B>processForward</B>(javax.servlet.http.HttpServletRequest&nbsp;request,
                                 javax.servlet.http.HttpServletResponse&nbsp;response,
                                 <A HREF="../../../../org/apache/struts/action/ActionMapping.html">ActionMapping</A>&nbsp;mapping)
                          throws java.io.IOException,
                                 javax.servlet.ServletException</PRE>
<DL>
<DD><p>Process a forward requested by this mapping (if any). Return
 <code>true</code> if standard processing should continue, or
 <code>false</code> if we have already handled this request.</p><DD><DL>
<DT><B>Parameters:</B><DD><CODE>request</CODE> - The servlet request we are processing<DD><CODE>response</CODE> - The servlet response we are creating<DD><CODE>mapping</CODE> - The ActionMapping we are using</DL>
</DD>
</DL>
<HR>

<A NAME="processInclude(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, org.apache.struts.action.ActionMapping)"><!-- --></A><H3>
processInclude</H3>
<PRE>
protected boolean <B>processInclude</B>(javax.servlet.http.HttpServletRequest&nbsp;request,
                                 javax.servlet.http.HttpServletResponse&nbsp;response,
                                 <A HREF="../../../../org/apache/struts/action/ActionMapping.html">ActionMapping</A>&nbsp;mapping)
                          throws java.io.IOException,
                                 javax.servlet.ServletException</PRE>
<DL>
<DD><p>Process an include requested by this mapping (if any). Return
 <code>true</code> if standard processing should continue, or
 <code>false</code> if we have already handled this request.</p><DD><DL>
<DT><B>Parameters:</B><DD><CODE>request</CODE> - The servlet request we are processing<DD><CODE>response</CODE> - The servlet response we are creating<DD><CODE>mapping</CODE> - The ActionMapping we are using</DL>
</DD>
</DL>
<HR>

<A NAME="processLocale(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse)"><!-- --></A><H3>
processLocale</H3>
<PRE>
protected void <B>processLocale</B>(javax.servlet.http.HttpServletRequest&nbsp;request,
                             javax.servlet.http.HttpServletResponse&nbsp;response)</PRE>
<DL>
<DD><p>Automatically select a <code>Locale</code> for the current user, if requested.
 <strong>NOTE</strong> - configuring Locale selection will trigger
 the creation of a new <code>HttpSession</code> if necessary.</p><DD><DL>
<DT><B>Parameters:</B><DD><CODE>request</CODE> - The servlet request we are processing<DD><CODE>response</CODE> - The servlet response we are creating</DL>
</DD>
</DL>
<HR>

<A NAME="processMapping(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, java.lang.String)"><!-- --></A><H3>
processMapping</H3>
<PRE>
protected <A HREF="../../../../org/apache/struts/action/ActionMapping.html">ActionMapping</A> <B>processMapping</B>(javax.servlet.http.HttpServletRequest&nbsp;request,
                                       javax.servlet.http.HttpServletResponse&nbsp;response,
                                       java.lang.String&nbsp;path)
                                throws java.io.IOException</PRE>
<DL>
<DD><p>Select the mapping used to process the selection path for this request.
 If no mapping can be identified, create an error response and return
 <code>null</code>.</p><DD><DL>
<DT><B>Parameters:</B><DD><CODE>request</CODE> - The servlet request we are processing<DD><CODE>response</CODE> - The servlet response we are creating<DD><CODE>path</CODE> - The portion of the request URI for selecting a mapping<DT><B>Throws:</B><DD><CODE>java.io.IOException</CODE> - if an input/output error occurs</DL>
</DD>
</DL>
<HR>

<A NAME="processMultipart(javax.servlet.http.HttpServletRequest)"><!-- --></A><H3>
processMultipart</H3>
<PRE>
protected javax.servlet.http.HttpServletRequest <B>processMultipart</B>(javax.servlet.http.HttpServletRequest&nbsp;request)</PRE>
<DL>
<DD><p>If this is a multipart request, wrap it with a special wrapper.
 Otherwise, return the request unchanged.</p><DD><DL>
<DT><B>Parameters:</B><DD><CODE>request</CODE> - The HttpServletRequest we are processing</DL>
</DD>
</DL>
<HR>

<A NAME="processNoCache(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse)"><!-- --></A><H3>
processNoCache</H3>
<PRE>
protected void <B>processNoCache</B>(javax.servlet.http.HttpServletRequest&nbsp;request,
                              javax.servlet.http.HttpServletResponse&nbsp;response)</PRE>
<DL>
<DD><p>Set the no-cache headers for all responses, if requested.
 <strong>NOTE</strong> - This header will be overridden
 automatically if a <code>RequestDispatcher.forward</code> call is
 ultimately invoked.</p><DD><DL>
<DT><B>Parameters:</B><DD><CODE>request</CODE> - The servlet request we are processing<DD><CODE>response</CODE> - The servlet response we are creating</DL>
</DD>
</DL>
<HR>

<A NAME="processPath(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse)"><!-- --></A><H3>
processPath</H3>
<PRE>
protected java.lang.String <B>processPath</B>(javax.servlet.http.HttpServletRequest&nbsp;request,
                                       javax.servlet.http.HttpServletResponse&nbsp;response)
                                throws java.io.IOException</PRE>
<DL>
<DD><p>Identify and return the path component (from the request URI) that
 we will use to select an <code>ActionMapping</code> with which to dispatch.
 If no such path can be identified, create an error response and return
 <code>null</code>.</p><DD><DL>
<DT><B>Parameters:</B><DD><CODE>request</CODE> - The servlet request we are processing<DD><CODE>response</CODE> - The servlet response we are creating<DT><B>Throws:</B><DD><CODE>java.io.IOException</CODE> - if an input/output error occurs</DL>
</DD>
</DL>
<HR>

<A NAME="processPopulate(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, org.apache.struts.action.ActionForm, org.apache.struts.action.ActionMapping)"><!-- --></A><H3>
processPopulate</H3>
<PRE>
protected void <B>processPopulate</B>(javax.servlet.http.HttpServletRequest&nbsp;request,
                               javax.servlet.http.HttpServletResponse&nbsp;response,
                               <A HREF="../../../../org/apache/struts/action/ActionForm.html">ActionForm</A>&nbsp;form,
                               <A HREF="../../../../org/apache/struts/action/ActionMapping.html">ActionMapping</A>&nbsp;mapping)
                        throws javax.servlet.ServletException</PRE>
<DL>
<DD><p>Populate the properties of the specified <code>ActionForm</code> instance from
 the request parameters included with this request.  In addition,
 request attribute <code>Globals.CANCEL_KEY</code> will be set if
 the request was submitted with a button created by
 <code>CancelTag</code>.</p><DD><DL>
<DT><B>Parameters:</B><DD><CODE>request</CODE> - The servlet request we are processing<DD><CODE>response</CODE> - The servlet response we are creating<DD><CODE>form</CODE> - The ActionForm instance we are populating<DD><CODE>mapping</CODE> - The ActionMapping we are using<DT><B>Throws:</B><DD><CODE>javax.servlet.ServletException</CODE> - if thrown by RequestUtils.populate()</DL>
</DD>
</DL>
<HR>

<A NAME="processPreprocess(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse)"><!-- --></A><H3>
processPreprocess</H3>
<PRE>
protected boolean <B>processPreprocess</B>(javax.servlet.http.HttpServletRequest&nbsp;request,
                                    javax.servlet.http.HttpServletResponse&nbsp;response)</PRE>
<DL>
<DD><p>General-purpose preprocessing hook that can be overridden as required
 by subclasses. Return <code>true</code> if you want standard processing