struts-config.xml的controller 元素

<controller>用于配置ActionServlet. 属性 描述 
bufferSize 指定上载文件的输入缓冲的大小。该属性为可选项，默认值为4096. 
className 指定和<controller>元素对应的配置类。默认为org.apache.struts.config.ControllerConfig. 
contentType 指定响应结果的内容类型和字符编码。该属性为可选项，默认值为text/html。如果在Action和JSP网页中也设置了内容类型和字符编码，将会覆盖该设置。 
locale 指定是否把Locale对象保存到当前用户的Session中。默认值为false. 
processorClass 指定负责处理请求的Java类的完整类名。默认值为org.apache.struts.action.RequestProcessor。如果把此项设置为自定义的类，那么应该保证该类扩展了org.apache.struts.action.RequestProcessor类。 
tempDir 指定处理文件上传的临时工作目录。如果此项没有设置，将采用Servlet容器为Web应用分配的临时工作目录。 
nochache 如果为true，在响应结果中将加入特定的头参数 ：Pragma, Cache-Control和Expires，防止页面被存储在客户浏览器的缓存中。默认值为false.


如果应用包含多个子应用，可以在每个字应用的Struts配置文件中配置<controller>元素。这样，尽管这些子应用共享同一个ActionServlet对象，但是他们可以使用不同的RequestProcessor类。

以下是<controller>元素的配置代码示例：

<controller   contentType="text/html;charset=UTF-8"   locale="true"   processorClass="CustomRequestProcessor"/>





定制Struts控制器组件
在Struts API中，org.apache.struts.action.RequestProcessor类真正包含了Struts控制器在处理servlet请求时所遵循的控制逻辑。控制器核心组件ActionServlet就是通过调用RequestProcessor对象的process()方法来委托其处理客户端请求的，该方法格式如下：
public void process(

javax.servlet.http.HttpServletRequest request,

javax.servlet.http.HttpServletResponse response)

    throws java.io.IOException, javax.servlet.ServletException{ … }


     RequestProcessor类中还定义了多个processXXX()方法，process()方法正是通过调用他们来具体的处理工作的。下表中对其中重要的几个做简单介绍：

主要处理方法

protected String processPath()
获取客户端请求的路径URI

protected ActionForm processActionForm()
获取当前请求表单所映射的ActionForm Bean

protected ActionMapping processMapping()
根据请求URI获取所需的映射信息

protected Action processActionCreate()
初始化相应的ActionBean

protected ActionForward processActionPerform()
调用Action Bean的execute()方法处理请求

protected void processForwardConfig()
处理由Action Bean的execute()方法返回的ActionForward对象。



     如果要定制ActionServlet的行为规则，其实应从RequestProcessor这个RequestProcessor类着手。要开发自己的RequestProcessor类以实现定制的控制逻辑，应遵循以下步骤：
     1） 创建一个子类继承org.apache.struts.action.RequestProcessor类，在该子类中显式定义（或使用缺省的）无参、方法体为空的构造方法。
     2） 重写所需要的方法，加入定制功能。
     3） 将该子类编译后得到的class文件保存到Struts应用程序的WEB-INF/class/目录下
     4） 修改配置文件struts-config.xml，在其中加入一个名为<controller>的元素，用以指定客户定制的RequestProcessor类。
     在展示一个具体的实现定制功能的例子之前，有必要介绍一下RequestProcessor类中定义的另外几个有关方法：
 protected void log(java.lang.String message){…}
     功能：将参数String对象message的内容存入当前应用程序日志文件。
 protected void log(java.lang.String message, java.lang.Throwable exception) {…}
     功能：将参数String对象message和异常对象exception所封装的信息存入当前应用程序日志文件。
 protected boolean processPreprocess(javax.servlet.http.HttpServletRequest request,
   javax.servlet.http.HttpServletResponse response) {…}
     功能：专门用于在子类中被重写，加入由开发者定制的预处理功能。
     在RequestProcessor类中定义的processPreprocess()方法什么也不做，只是简单返回一个boolean类型值true，用以告知RequestProcessor继续后续处理程序。在定制RequestProcessor类时通常会重写此方法，注意一定要在方法的结尾返回true，如果重写如果返回值为false，则RequestProcessor对象终止对请求的处理，将控制权送回给ActionServlet的doPost()或doGet()方法。

     下面给出用户定制RequestProcessor组件的具体实现步骤：
     1）为已有的Struts应用程序创建用户自己的RequestProcessor类，重写其中的processPreprocess()方法，加入所需的控制逻辑。范例源代码如下：

源文件：MyRequestProcessor.java

package test;

import java.util.Enumeration;

import javax.servlet.http.*;

import org.apache.struts.action.RequestProcessor;


public class MyRequestProcessor extends RequestProcessor {

      public MyRequestProcessor() {} 

      public boolean processPreprocess(HttpServletRequest request,

             HttpServletResponse response) {               

             log("-------------- My Logging Start--------------");

             log("Request URI = " + request.getRequestURI());

             log("Context Path = " + request.getContextPath());                         

             Enumeration headerNames = request.getHeaderNames();

             log("Request Header:");

             while (headerNames.hasMoreElements()) {

                    String headerName =(String)headerNames.nextElement();

                    Enumeration headerValues =   request.getHeaders(headerName);

                    while (headerValues.hasMoreElements()) {

                           String headerValue =(String)headerValues.nextElement();

                           log("\t" + headerName + " = " + headerValue);

                    }                  

             }

             log("Locale = " + request.getLocale());

             log("Method = " + request.getMethod());

             log("Path Info = " + request.getPathInfo());

             log("Protocol = " + request.getProtocol());

             log("Remote Address = " + request.getRemoteAddr());

             log("Remote Host = " + request.getRemoteHost());

             log("Remote User = " + request.getRemoteUser());

             log("Requested Session Id = "

                    + request.getRequestedSessionId());

             log("Scheme = " + request.getScheme());

             log("Server Name = " + request.getServerName());

             log("Server Port = " + request.getServerPort());

             log("Servlet Path = " + request.getServletPath());

             log("Secure = " + request.isSecure());

             log("-------------- My Logging End   --------------");

             return true;

      }

}


     2）编译源文件MyRequestProcessor.java，将所生成的字节码文件（包括所在的package子目录）保存到Struts 应用程序的"WEB-INF/classes/"目录下。
     3）修改此Struts应用程序配置文件struts-config.xml，在其中加入<controller>元素：

     源文件：struts-config.xml

<?xml version="1.0" encoding="ISO-8859-1" ?>

<!DOCTYPE struts-config PUBLIC

      "-//Apache Software Foundation//DTD Struts Configuration 1.1//EN"

      "http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd">

<struts-config>

    ……

      <controller processorClass="test.MyRequestProcessor" /> 

</struts-config>


     说明：其他组成页面、类设计和应用程序配置均不需做改变。
     4）发布Struts应用程序，并通过客户端浏览器访问该应用程序。
     5）打开Web服务器日志文件<WAS_HOME>/logs/localhost_log.<当天日期>.txt，可以看到新加入的用户定制信息：
     2004-09-24 00:30:28 StandardContext[/myStrutsApp3]action:
-------------- My Logging Start--------------
Request URI = /myStrutsApp3/regist.do
Context Path = /myStrutsApp3
Request Header:
          accept = image/gif, image/x-xbitmap, image/jpeg, image/pjpeg,
     application/vnd.ms-powerpoint, application/vnd.ms-excel,
     application/msword , application/x-shockwave-flash, */*
          referer = http://localhost:8080/myStrutsApp3/
          accept-language = zh-cn
          content-type = application/x-www-form-urlencoded
          accept-encoding = gzip, deflate
          user-agent = Mozilla/4.0 (compatible; MSIE 6.0;
      Windows NT 5.1; .NET CLR 1.1.4322)
          host = localhost:8080
          content-length = 20
          connection = Keep-Alive
          cache-control = no-cache
          cookie = JSESSIONID=FD8A69F16E329A362DB219596897D6DA
Locale = zh_CN
Method = POST
Path Info = null
Protocol = HTTP/1.1
Remote Address = 127.0.0.1
Remote Host = 127.0.0.1
Remote User = null
Requested Session Id = FD8A69F16E329A362DB219596897D6DA
Scheme = http
Server Name = localhost
Server Port = 8080
Servlet Path = /regist.do
Secure = false
-------------- My Logging End   --------------