struts2中struts.xml配置文件详解

墨蓝 2022-05-18 09:27 237阅读 0赞

常用配置

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN" "http://struts.apache.org/dtds/struts-2.3.dtd">
    <struts>
        
        <constant name="struts.action.extension" value="action" />
        
        <constant name="struts.devMode" value="true" />
        
        <constant name="struts.configuration.xml.reload" value="true" />
        
        <constant name="struts.serve.static.browserCache" value="false" />
        
        <constant name="struts.i18n.encoding" value="utf-8" />
        
        <constant name="struts.i18n.reload" value="true" />
        
        <constant name="struts.multipart.maxSize" value="104857600" />
        
        <constant name="struts.enable.DynamicMethodInvocation" value="true" />
        
        <constant name="struts.enable.SlashesInActionNames" value="false" />
        
        <constant name="struts.tag.altSyntax" value="true" />
        
        <constant name="struts.dispatcher.parametersWorkaround" value="false" />
    
        <package name="basePackage" extends="struts-default">
    
    
        </package>
    
    </struts>

常见的配置示例

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd" >
    <struts>
    
        
        <include file="struts-default.xml"></include>
        
        
        
        <package name="com.kay.struts2" extends="struts-default" namespace="/test">
            <interceptors>
                
                <interceptor name="timer" class="com.kay.timer"></interceptor>
                <interceptor name="logger" class="com.kay.logger"></interceptor>
                
                <interceptor-stack name="mystack">
                    <interceptor-ref name="timer"></interceptor-ref>
                    <interceptor-ref name="logger"></interceptor-ref>
                </interceptor-stack>
            </interceptors>
            
            
            <default-interceptor-ref name="mystack"></default-interceptor-ref>
            
            
            
            <global-results>
                <result name="input">/error.jsp</result>
            </global-results>
            
            
            <action name="hello" class="com.kay.struts2.Action.LoginAction">
                
                <interceptor-ref name="timer"></interceptor-ref>
            
                
             <result name="success" type="dispatcher">/talk.jsp</result>
             
             <param name="url">http://www.sina.com</param>
            </action>
        </package>
    </struts>

**一个Action内包含多个请求处理方法的处理**

**Struts1提供了DispatchAction，从而允许一个Action内包含多个请求处理方法。Struts2也提供了类似的功能。**

**处理方式主要有以下三种方式：**

**1. 1   动态方法调用：**

DMI：Dynamic Method Invocation 动态方法调用。

动态方法调用是指：表单元素的action不直接等于某个Action的名字，而是以感叹号后加方法名来指定对应的动作名：

<form action="computeAction!add.action" name="from" >
            <s:form action="computeAction!add.action" name="form" theme="simple" >

则用户的请求将提交到名为”computeAction”的Action实例，Action实例将调用名为”add”方法来处理请求。  
　　当指定调用某一方法来处理请求时，就不会走默认执行处理请求的execute()方法。

注意：要使用动态方法调用，必须设置Struts2允许动态方法调用，通过设置struts.enable.DynamicMethodInvocation常量来完成，该常量属性的默认值是true。

**示列：简单的一个加法和减法例子。**

1. index.jsp用户在页面输入两个数字，选择相加，或者相减  
　　　当用户点击加或减需要走同一个Action但处理请求方法不同，这里使用了js动态选择。

<body>
        
            <s: name="form" theme="simple" >
            
                num1:<s:textfield name="num1" />
                num2:<s:textfield name="num2" />
                <s:submit type="button" value="加" onclick="computeMethod('add')" />
                <s:submit type="button" value="减" onclick="computeMethod('subtract')" />
            </s:form>
            
             
            
        
        <script type="text/javascript">
            function computeMethod(op){
                document.form.action="computeAction!"+op;//动态选择处理请求的方法
                document.form.submit();//提交
            }
        </script>
                
      </body>

2. struts.xml配置信息，启用动态方法调用（可选）

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" "struts-2.1.dtd" >
    <struts>
        
        <constant name="struts.enable.DynamicMethodInvocation" value="true" />
        <package name="struts2" extends="struts-default">
            <action name="computeAction" class="com.struts.ComputeAction" >
                <result name="fruitPage" >/fruit.jsp</result>
            </action>
        </package>
    </struts>

3. ComputeAction控制器的类处理请求

package com.struts;
    /**
     * Struts2控制器的类
     * @author asus
     *
     */
    public class ComputeAction {
    
        /** 属性 */
        private int num1;
        private int num2;
        private int fruit;//结果
        
        /** 若请求为指定操作方法默认执行execute()方法 */
        public String execute(){
            
            System.out.println("当调用其它方法就不会走这个方法！");
            return "";
        }
        
        /** 执行处理加法 */
        public String add(){
            this.fruit=num1+num2;//加
            return "fruitPage";
        }
        
        /** 执行处理减法 */
        public String subtract(){
            this.fruit=num1-num2;//减
            return "fruitPage";
        }
        
        
        
        
        /** JavaBean */
        public int getNum1() {
            return num1;
        }
    
        public void setNum1(int num1) {
            this.num1 = num1;
        }
    
        public int getNum2() {
            return num2;
        }
    
        public void setNum2(int num2) {
            this.num2 = num2;
        }
    
        public int getFruit() {
            return fruit;
        }
    
        public void setFruit(int fruit) {
            this.fruit = fruit;
        }
        
    }

4. fruit.jsp响应结果的页面

**1.2Action配置method属性（示列与以上代码大多一致，只修改有变更的）：**

将Action类中的每一个处理方法都定义成一个逻辑Action方法。

1. index.jsp页面

<body>
      
        
            <s:form name="form" theme="simple" >
            
                num1:<s:textfield name="num1" />
                num2:<s:textfield name="num2" />
                <s:submit type="button" value="加" onclick="computeMethod('addAction')" />
                <s:submit type="button" value="减" onclick="computeMethod('subtractAction')" />
            </s:form>
            
             
            
        
        <script type="text/javascript">
            function computeMethod(op){
                document.form.action=op;//动态选择处理请求的方法
                document.form.submit();//提交
            }
                
        </script>
                
      </body>

2. struts.xml配置信息

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" "struts-2.1.dtd" >
    <struts>
        <package name="struts2" extends="struts-default">
            <action name="addAction" class="com.struts.ComputeAction" method="add" >
                <result name="fruitPage" >/fruit.jsp</result>
            </action>
            <action name="subtractAction" class="com.struts.ComputeAction" method="subtract" >
                <result name="fruitPage" >/fruit.jsp</result>
            </action>
        </package>
    </struts>

**　　通过action元素的method属性来指定Action执行时调用的方法。**

优点：使得以更加安全的方式来实现动态方法的调用，不让别人看到你的实现方法。  
　　　　缺点：繁琐，一个处理请求的方法要跟一个action。

**　　Struts2根据method属性查找方法有两种途径：**

1.查找与method属性值完全一致的方法

2.查找doMethod形式的方法

**使用动态方法调用和method属性的区别：**

**　　　　**1.通过以上三个struts.xml中的配置信息例子来说，他们的共同点是都在操作同一个Action。

2.<form action="">中请求地址不同。

3.动态方法的返回值相同，则会通过result进入一个页面。而method属性就算两个方法的返回值相同但进去不同的result，可能会进入两个不同的页面。

由上可以分析出：  
　　　　　　(1)如果使用同一个Action，不同的处理请求的方法，响应使用相同的配置（result等）则使用动态方法调用。

(2)如果使用同一个Action，不同的处理请求的方法，响应分别使用不同的配置，则使用action元素的method属性，为同一个Action配置多个名称。

1.3**使用通配符映射(wildcard mappings)方式（示列与以上代码大多一致，只修改有变更的）：**

1. index.jsp页面只改动了js部分。

<body>
        
        
            <s:form name="form" theme="simple" >
            
                num1:<s:textfield name="num1" />
                num2:<s:textfield name="num2" />
                <s:submit type="button" value="加" onclick="computeMethod('addAction')" />
                <s:submit type="button" value="减" onclick="computeMethod('subtractAction')" />
            </s:form>
            
             
            
        
        <script type="text/javascript">
            function computeMethod(op){
                document.form.action=op;//相比mothod属性改动只有这里
                document.form.submit();//提交
            }
                
        </script>
                
      </body>

2.struts.xml的配置信息

在使用method属性来实现同一个Action的不同方法处理不同的请求时，会发现，随着方法的增多，从而导致大量的Action配置，这时我们就需要通过使用通配符来解决Action配置过多的方法。

在配置<action.../>元素时，需要指定name、class、method属性。其中name属性可支持通配符，然后可以在class、method属性中使用表达式。通配符用星号 \* 表示。

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" "struts-2.1.dtd" >
    <struts>
        <package name="struts2" extends="struts-default">
        
            <action name="*Action" class="com.struts.ComputeAction" method="{1}" >
                <result name="fruitPage" >/fruit.jsp</result>
                
            </action>
        </package>
    </struts>

**2.默认Action：**

在浏览器输入一个不存在的Action，页面将呈现404错误，为了网站更友好，我们可以设置一个默认的Action。

注意：有一部份的朋友在某个自定义的action中定义default-action-ref这个配置的时候，认为在地址栏中输入地址如http://localhost:8080/project的时候（project为项目名），如果该项目后面不输入任何名字或者输错地址，则会自动进入default-action-ref定义的action并进入对应的类方法中进行操作并根据result返回页面，但是很多人发现结果并不是这样，而不管怎样都返回进入到index.jsp页面。

实际上这一点从原理上来讲可以理解，default-action-ref这个配置的意思是当用户在点击了没有定义的action时，如果struts没有找到用户定义的action名称，则会自动跳转到该默认定义的action中。

个人觉得地址栏中项目后不写名称和名称不存在是两个概念。

**示列：**

**1. struts.xml　就在通配符例子中配置上默认Action**

**2. index.jsp页面　这里我们把提交的url :Action地址链接，写错打断，当提交时找不到对应的Action，则会进入默认Action，进入error.jsp页面**

<body>
    
        
            <s:form name="form" theme="simple" >
            
                num1:<s:textfield name="num1" />
                num2:<s:textfield name="num2" />    
                <s:submit type="button" value="加" onclick="computeMethod('ssss')" />
                <s:submit type="button" value="减" onclick="computeMethod('subtractActios')" />
            </s:form>
            
             
            
        
        <script type="text/javascript">
            function computeMethod(op){
                document.form.action=op;//改动只有这里
                document.form.submit();//提交
            }
                
        </script>
                
      </body>

**3. error.jsp 创建此页面查看效果**

<body>
               错误页面。！
                   未找到，Action实例时会默认走此页面！
      </body>

**3.处理结果**

Struts2的Action处理完用户请求后，将返回一个普通字符串，整个普通字符串就是一个逻辑视图名。Struts2通过配置逻辑视图名和物理视图资源之间的映射关系，一旦系统收到Action返回的某个逻辑视图名，系统就会把对应的物理视图资源呈现给浏览者。

**3.1    配置处理结果：**

Struts2的Action处理用户请求结束后，返回一个普通字符串－逻辑视图名，必须在struts.xml文件中完成逻辑视图和物理视图资源的映射，才可让系统转到实际的视图资源。

Struts2通过在struts.xml文件中使用<result …/>元素来配置结果。Struts2提供了两种结果。

局部结果：将<result …/>作为<action …>元素的子元素配置。

全局结果：将<result …/>作为<global-results …>元素的子元素配置。

在package元素中配置<global-results>子元素：

全局结果可满足一个包中多个Action共享一个结果:

<global-results>
            <result name="fruitPage" type="dispatcher" >/fruit.jsp</result>
        </global-results>

**3.2.    处理结果类型：**

Struts2提供了对不同种类返回结果的支持，常见的有JSP，FreeMarker，Velocity等。

Struts2支持的不同类型的返回结果为：**(加粗为常用)**

<table> 
 <tbody> 
  <tr> 
   <td style="vertical-align:top;">名字</td> 
   <td style="vertical-align:top;">说明</td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;">chain</td> 
   <td style="vertical-align:top;">用来处理Action链</td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;"><strong>dispatcher</strong></td> 
   <td style="vertical-align:top;"><strong>用来转向页面，通常处理JSP</strong><strong>，这是默认的结果类型</strong></td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;">freeMarker</td> 
   <td style="vertical-align:top;">处理FreeMarker模板</td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;">httpHeader</td> 
   <td style="vertical-align:top;">用来控制特殊的Http行为</td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;"><strong>redirect</strong></td> 
   <td style="vertical-align:top;"><strong>重定向到一个URL</strong></td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;"><strong>redirect-action</strong></td> 
   <td style="vertical-align:top;"><strong>重定向到一个Action</strong></td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;">stream</td> 
   <td style="vertical-align:top;">向浏览器发送InputSream对象，通常用来处理文件下载</td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;">velocity</td> 
   <td style="vertical-align:top;">处理Velocity模板</td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;">xslt</td> 
   <td style="vertical-align:top;">处理XML/XLST模板</td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;">plaintext</td> 
   <td style="vertical-align:top;">显示原始文件内容，例如文件源代码</td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;">tiles</td> 
   <td style="vertical-align:top;">结合Tile使用</td> 
  </tr> 
 </tbody> 
</table>

另外第三方的Result类型还包括JasperReports Plugin，专门用来处理JasperReport类型的报表输出；Jfreechart Plugin；JSF Plugin。

**　　常用示列：**

**1.struts.xml**

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" "struts-2.1.dtd" >
    <struts>
        <package name="struts2" extends="struts-default">
        
            
            <default-action-ref name="defaultAction"></default-action-ref>
            
            
        
            <action name="defaultAction">
                <result>/error.jsp</result>
             </action>
            
            <action name="*Action" class="com.struts.ComputeAction" method="{1}" >
                
                
                
                
                
                
                
                
                
                
                
                <result name="fruitPage" type="redirectAction" >
                    <param name="actionName">skipAction</param>
                    <param name="method">add</param>
                    <param name="num1">${num1}</param>
                    <param name="num2">${num2}</param>
                </result>
            </action>
            
            <action name="skipAction" class="com.struts.SkipAction" >
                <result name="success" type="dispatcher" >/fruit.jsp</result>
            </action>
        </package>
    </struts>

** 2.再创建一个SkipAction 控制器的类**

package com.struts;
    /**
     * 测试与dispatcherAction之间的传值
     * @author asus
     *
     */
    public class SkipAction {
    
        /** 接收computeAction实例传过来属性 */
        private int num1;
        private int num2;
        private int result;//结果返回给页面
        
        public String execute(){
            System.out.println("当指定要走的方法时不会走此方法");
            return "success";
        }
        
        /**添加的方法 */
        public String add(){
            result=num1+num2;
            System.out.println("走add方法！");
            return "success";
        }
    
        /** Get,Set方法 */
        public int getNum1() {
            return num1;
        }
    
        public void setNum1(int num1) {
            this.num1 = num1;
        }
    
        public int getNum2() {
            return num2;
        }
    
        public void setNum2(int num2) {
            this.num2 = num2;
        }
    
        public int getResult() {
            return result;
        }
    
        public void setResult(int result) {
            this.result = result;
        }
        
    }