【转】struts2中struts.xml配置文件详解
struts.xml的常用配置
1 <?xml version="1.0" encoding="UTF-8"?> 2 <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN" "http://struts.apache.org/dtds/struts-2.3.dtd"> 3 <struts> 4 <!-- 所有匹配*.action的请求都由struts2处理 --> 5 <constant name="struts.action.extension" value="action" /> 6 <!-- 是否启用开发模式 --> 7 <constant name="struts.devMode" value="true" /> 8 <!-- struts配置文件改动后，是否重新加载 --> 9 <constant name="struts.configuration.xml.reload" value="true" /> 10 <!-- 设置浏览器是否缓存静态内容 --> 11 <constant name="struts.serve.static.browserCache" value="false" /> 12 <!-- 请求参数的编码方式 --> 13 <constant name="struts.i18n.encoding" value="utf-8" /> 14 <!-- 每次HTTP请求系统都重新加载资源文件，有助于开发 --> 15 <constant name="struts.i18n.reload" value="true" /> 16 <!-- 文件上传最大值 --> 17 <constant name="struts.multipart.maxSize" value="104857600" /> 18 <!-- 让struts2支持动态方法调用 --> 19 <constant name="struts.enable.DynamicMethodInvocation" value="true" /> 20 <!-- Action名称中是否还是用斜线 --> 21 <constant name="struts.enable.SlashesInActionNames" value="false" /> 22 <!-- 允许标签中使用表达式语法 --> 23 <constant name="struts.tag.altSyntax" value="true" /> 24 <!-- 对于WebLogic,Orion,OC4J此属性应该设置成true --> 25 <constant name="struts.dispatcher.parametersWorkaround" value="false" /> 26 27 <package name="basePackage" extends="struts-default"> 28 29 30 </package> 31 32 </struts>
1 <?xml version="1.0" encoding="UTF-8"?> 2 <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd" > 3 <struts> 4 5 <!-- include节点是struts2中组件化的方式 可以将每个功能模块独立到一个xml配置文件中 然后用include节点引用 --> 6 <include file="struts-default.xml"></include> 7 8 9 <!-- package提供了将多个Action组织为一个模块的方式 10 package的名字必须是唯一的 package可以扩展 当一个package扩展自 11 另一个package时该package会在本身配置的基础上加入扩展的package 12 的配置 父package必须在子package前配置 13 name：package名称 14 extends:继承的父package名称 15 abstract:设置package的属性为抽象的 抽象的package不能定义action 值true:false 16 namespace:定义package命名空间 该命名空间影响到url的地址，例如此命名空间为/test那么访问是的地址为http://localhost:8080/struts2/test/XX.action 17 --> 18 <package name="com.kay.struts2" extends="struts-default" namespace="/test"> 19 <interceptors> 20 <!-- 定义拦截器 21 name:拦截器名称 22 class:拦截器类路径 23 --> 24 <interceptor name="timer" class="com.kay.timer"></interceptor> 25 <interceptor name="logger" class="com.kay.logger"></interceptor> 26 <!-- 定义拦截器栈 --> 27 <interceptor-stack name="mystack"> 28 <interceptor-ref name="timer"></interceptor-ref> 29 <interceptor-ref name="logger"></interceptor-ref> 30 </interceptor-stack> 31 </interceptors> 32 33 <!-- 定义默认的拦截器 每个Action都会自动引用 34 如果Action中引用了其它的拦截器 默认的拦截器将无效 --> 35 <default-interceptor-ref name="mystack"></default-interceptor-ref> 36 37 38 <!-- 全局results配置 --> 39 <global-results> 40 <result name="input">/error.jsp</result> 41 </global-results> 42 43 <!-- Action配置 一个Action可以被多次映射(只要action配置中的name不同) 44 name：action名称 45 class: 对应的类的路径 46 method: 调用Action中的方法名 47 --> 48 <action name="hello" class="com.kay.struts2.Action.LoginAction"> 49 <!-- 引用拦截器 50 name:拦截器名称或拦截器栈名称 51 --> 52 <interceptor-ref name="timer"></interceptor-ref> 53 54 <!-- 节点配置 55 name : result名称 和Action中返回的值相同 56 type : result类型 不写则选用superpackage的type struts-default.xml中的默认为dispatcher 57 --> 58 <result name="success" type="dispatcher">/talk.jsp</result> 59 <!-- 参数设置 60 name：对应Action中的get/set方法 61 --> 62 <param name="url">http://www.sina.com</param> 63 </action> 64 </package> 65 </struts>
一个Action内包含多个请求处理方法的处理
Struts1提供了DispatchAction，从而允许一个Action内包含多个请求处理方法。Struts2也提供了类似的功能。
处理方式主要有以下三种方式：
1. 1 动态方法调用：
DMI：Dynamic Method Invocation 动态方法调用。
动态方法调用是指：表单元素的action不直接等于某个Action的名字，而是以感叹号后加方法名来指定对应的动作名：
1 <!-- 动态方法调用HTML标签与Struts2标签 --> 2 <form action="computeAction!add.action" name="from" > 3 <s:form action="computeAction!add.action" name="form" theme="simple" >
则用户的请求将提交到名为”computeAction”的Action实例，Action实例将调用名为”add”方法来处理请求。
当指定调用某一方法来处理请求时，就不会走默认执行处理请求的execute()方法。
注意：要使用动态方法调用，必须设置Struts2允许动态方法调用，通过设置struts.enable.DynamicMethodInvocation常量来完成，该常量属性的默认值是true。
1 <struts> 2 <!-- 3 //禁用动态方法调用，默认为true启用，false禁用 4 constant:name="struts.enable.DynamicMethodInvocation" 5 --> 6 <constant name="struts.enable.DynamicMethodInvocation" value="true" /> 7 </struts>
示列：简单的一个加法和减法例子。
1. index.jsp用户在页面输入两个数字，选择相加，或者相减
当用户点击加或减需要走同一个Action但处理请求方法不同，这里使用了js动态选择。
1 <body> 2 <!-- 动态方法调用 使用：Struts2标签也可以使用HTML标签 --> 3 <s: name="form" theme="simple" > 4 5 num1:<s:textfield name="num1" /> 6 num2:<s:textfield name="num2" /> 7 <s:submit type="button" value="加" onclick="computeMethod('add')" /> 8 <s:submit type="button" value="减" onclick="computeMethod('subtract')" /> 9 </s:form> 10 11 12 13 <!-- js --> 14 <script type="text/javascript"> 15 function computeMethod(op){ 16 document.form.action="computeAction!"+op;//动态选择处理请求的方法 17 document.form.submit();//提交 18 } 19 </script> 20 21 </body>
2. struts.xml配置信息，启用动态方法调用（可选）
1 <?xml version="1.0" encoding="UTF-8"?> 2 <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" "struts-2.1.dtd" > 3 <struts> 4 <!-- 5 //禁用动态方法调用，默认为true启用，false禁用 6 constant:name="struts.enable.DynamicMethodInvocation" 7 --> 8 <constant name="struts.enable.DynamicMethodInvocation" value="true" /> 9 <package name="struts2" extends="struts-default"> 10 <action name="computeAction" class="com.struts.ComputeAction" > 11 <result name="fruitPage" >/fruit.jsp</result> 12 </action> 13 </package> 14 </struts>
3. ComputeAction控制器的类处理请求
1 package com.struts; 2 /** 3 * Struts2控制器的类 4 * @author asus 5 * 6 */ 7 public class ComputeAction { 8 9 /** 属性 */ 10 private int num1; 11 private int num2; 12 private int fruit;//结果 13 14 /** 若请求为指定操作方法默认执行execute()方法 */ 15 public String execute(){ 16 17 System.out.println("当调用其它方法就不会走这个方法！"); 18 return ""; 19 } 20 21 /** 执行处理加法 */ 22 public String add(){ 23 this.fruit=num1+num2;//加 24 return "fruitPage"; 25 } 26 27 /** 执行处理减法 */ 28 public String subtract(){ 29 this.fruit=num1-num2;//减 30 return "fruitPage"; 31 } 32 33 34 35 36 /** JavaBean */ 37 public int getNum1() { 38 return num1; 39 } 40 41 public void setNum1(int num1) { 42 this.num1 = num1; 43 } 44 45 public int getNum2() { 46 return num2; 47 } 48 49 public void setNum2(int num2) { 50 this.num2 = num2; 51 } 52 53 public int getFruit() { 54 return fruit; 55 } 56 57 public void setFruit(int fruit) { 58 this.fruit = fruit; 59 } 60 61 }
4. fruit.jsp响应结果的页面
1 <body> 2 <!-- 结果页面 --> 3 计算结果：<s:property value="fruit" /> 4 </body>
1.2Action配置method属性（示列与以上代码大多一致，只修改有变更的）：
将Action类中的每一个处理方法都定义成一个逻辑Action方法。
1. index.jsp页面
1 <body> 2 3 <!-- Action配置method属性 使用：Struts2标签也可以使用HTML标签 --> 4 <s:form name="form" theme="simple" > 5 6 num1:<s:textfield name="num1" /> 7 num2:<s:textfield name="num2" /> 8 <s:submit type="button" value="加" onclick="computeMethod('addAction')" /> 9 <s:submit type="button" value="减" onclick="computeMethod('subtractAction')" /> 10 </s:form> 11 12 13 14 <!-- js --> 15 <script type="text/javascript"> 16 function computeMethod(op){ 17 document.form.action=op;//动态选择处理请求的方法 18 document.form.submit();//提交 19 } 20 21 </script> 22 23 </body>
2. struts.xml配置信息
1 <?xml version="1.0" encoding="UTF-8"?> 2 <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" "struts-2.1.dtd" > 3 <struts> 4 <package name="struts2" extends="struts-default"> 5 <action name="addAction" class="com.struts.ComputeAction" method="add" > 6 <result name="fruitPage" >/fruit.jsp</result> 7 </action> 8 <action name="subtractAction" class="com.struts.ComputeAction" method="subtract" > 9 <result name="fruitPage" >/fruit.jsp</result> 10 </action> 11 </package> 12 </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部分。
1 <body> 2 3 <!-- 使用通配符映射(wildcard mappings)方式 使用：Struts2标签也可以使用HTML标签 --> 4 <s:form name="form" theme="simple" > 5 6 num1:<s:textfield name="num1" /> 7 num2:<s:textfield name="num2" /> 8 <s:submit type="button" value="加" onclick="computeMethod('addAction')" /> 9 <s:submit type="button" value="减" onclick="computeMethod('subtractAction')" /> 10 </s:form> 11 12 13 14 <!-- js --> 15 <script type="text/javascript"> 16 function computeMethod(op){ 17 document.form.action=op;//相比mothod属性改动只有这里 18 document.form.submit();//提交 19 } 20 21 </script> 22 23 </body>
2.struts.xml的配置信息
在使用method属性来实现同一个Action的不同方法处理不同的请求时，会发现，随着方法的增多，从而导致大量的Action配置，这时我们就需要通过使用通配符来解决Action配置过多的方法。
在配置<action.../>元素时，需要指定name、class、method属性。其中name属性可支持通配符，然后可以在class、method属性中使用表达式。通配符用星号 * 表示。
1 <?xml version="1.0" encoding="UTF-8"?> 2 <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" "struts-2.1.dtd" > 3 <struts> 4 <package name="struts2" extends="struts-default"> 5 6 <action name="*Action" class="com.struts.ComputeAction" method="{1}" > 7 <result name="fruitPage" >/fruit.jsp</result> 8 <!-- <result name="fruitPage" >/{1}.jsp</result>表达式也可以写在这里 --> 9 </action> 10 </package> 11 </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
1 <?xml version="1.0" encoding="UTF-8"?> 2 <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" "struts-2.1.dtd" > 3 <struts> 4 <package name="struts2" extends="struts-default"> 5 <!-- 配置默认Action --> 6 <default-action-ref name="defaultAction"></default-action-ref> 7 <action name="defaultAction"> 8 <result>/error.jsp</result> 9 </action> 10 11 <!-- 通配符映射（wildcard mappings） --> 12 <action name="*Action" class="com.struts.ComputeAction" method="{1}" > 13 <result name="fruitPage" >/fruit.jsp</result> 14 <!-- <result name="fruitPage" >/{1}.jsp</result>表达式也可以写在这里 --> 15 </action> 16 </package> 17 </struts>
2. index.jsp页面 这里我们把提交的url :Action地址链接，写错打断，当提交时找不到对应的Action，则会进入默认Action，进入error.jsp页面
1 <body> 2 3 <!-- 使用通配符映射(wildcard mappings)方式 使用：Struts2标签也可以使用HTML标签 --> 4 <s:form name="form" theme="simple" > 5 6 num1:<s:textfield name="num1" /> 7 num2:<s:textfield name="num2" /> <!-- 测试默认Action,当提交的Action地址错误。则会走默认Action --> 8 <s:submit type="button" value="加" onclick="computeMethod('ssss')" /><!-- 把动态url地址乱写 --> 9 <s:submit type="button" value="减" onclick="computeMethod('subtractActios')" /><!-- 或在url地址中多加字符 --> 10 </s:form> 11 12 13 14 <!-- js --> 15 <script type="text/javascript"> 16 function computeMethod(op){ 17 document.form.action=op;//改动只有这里 18 document.form.submit();//提交 19 } 20 21 </script> 22 23 </body>
3. error.jsp 创建此页面查看效果
1 <body> 2 错误页面。！ 3 未找到，Action实例时会默认走此页面！ 4 </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共享一个结果:
1 <!-- 全局结果可满足一个包中多个Action共享一个结果，也就是说，当多个Action中都有一个重复的result时就可以使用全局结果，也就是说公共的result --> 2 <global-results> 3 <result name="fruitPage" type="dispatcher" >/fruit.jsp</result> 4 </global-results>
3.2. 处理结果类型：
Struts2提供了对不同种类返回结果的支持，常见的有JSP，FreeMarker，Velocity等。
Struts2支持的不同类型的返回结果为：(加粗为常用)
| 名字 | 说明 |
| chain | 用来处理Action链 |
| dispatcher | 用来转向页面，通常处理JSP，这是默认的结果类型 |
| freeMarker | 处理FreeMarker模板 |
| httpHeader | 用来控制特殊的Http行为 |
| redirect | 重定向到一个URL |
| redirect-action | 重定向到一个Action |
| stream | 向浏览器发送InputSream对象，通常用来处理文件下载 |
| velocity | 处理Velocity模板 |
| xslt | 处理XML/XLST模板 |
| plaintext | 显示原始文件内容，例如文件源代码 |
| tiles | 结合Tile使用 |
另外第三方的Result类型还包括JasperReports Plugin，专门用来处理JasperReport类型的报表输出；Jfreechart Plugin；JSF Plugin。
常用示列：
1.struts.xml
1 <?xml version="1.0" encoding="UTF-8"?> 2 <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" "struts-2.1.dtd" > 3 <struts> 4 <package name="struts2" extends="struts-default"> 5 6 <!-- 默认Action --> 7 <default-action-ref name="defaultAction"></default-action-ref> 8 9 <!-- 全局结果可满足一个包中多个Action共享一个结果，也就是说，当多个Action中都有一个重复的result时就可以使用全局结果，也就是说公共的result 10 <global-results> 11 <result name="fruitPage" type="dispatcher" >/fruit.jsp</result> 12 </global-results> --> 13 14 <action name="defaultAction"> 15 <result>/error.jsp</result> 16 </action> 17 <!-- 通配符映射（wildcard mappings） --> 18 <action name="*Action" class="com.struts.ComputeAction" method="{1}" > 19 <!--1 20 表达式{1}也可以写在url连接中，class,name中都可以写，也可以写多少，索引从1开始 21 <result name="fruitPage" >/{1}.jsp</result> --> 22 23 <!--2 24 默认dispatcher转发跳转 25 <result name="fruitPage" type="dispatcher" >/fruit.jsp</result> --> 26 27 <!--3 28 重定向跳转 29 <result name="fruitPage" type="redirect" >/fruit.jsp</result> --> 30 31 <!--4 32 redirectAction: Action实例 与另一个Action实例互相跳转 33 <result name="fruitPage" type="redirectAction" >skipAction</result> --> 34 35 <!--4.1 36 使用感叹号指定跳转方法，xml会显示报错，但可以用。 使用?&不能在Action实例中带参数 37 <result name="fruitPage" type="redirectAction" >skipAction!add</result> --> 38 39 <!--4.2 40 跳转Action带参数的方式： 41 actionName:跳转Action的名称 42 method:跳转Action实例中的哪个方法 43 num:带的参数，可写固定，可使用${属性名}取上一个Action实例中的属性，实现动态传值。 44 --> 45 <result name="fruitPage" type="redirectAction" > 46 <param name="actionName">skipAction</param> 47 <param name="method">add</param> 48 <param name="num1">${num1}</param> 49 <param name="num2">${num2}</param> 50 </result> 51 </action> 52 53 <action name="skipAction" class="com.struts.SkipAction" > 54 <result name="success" type="dispatcher" >/fruit.jsp</result> 55 </action> 56 </package> 57 </struts>
2.再创建一个SkipAction 控制器的类
1 package com.struts; 2 /** 3 * 测试与dispatcherAction之间的传值 4 * @author asus 5 * 6 */ 7 public class SkipAction { 8 9 /** 接收computeAction实例传过来属性 */ 10 private int num1; 11 private int num2; 12 private int result;//结果返回给页面 13 14 public String execute(){ 15 System.out.println("当指定要走的方法时不会走此方法"); 16 return "success"; 17 } 18 19 /**添加的方法 */ 20 public String add(){ 21 result=num1+num2; 22 System.out.println("走add方法！"); 23 return "success"; 24 } 25 26 /** Get,Set方法 */ 27 public int getNum1() { 28 return num1; 29 } 30 31 public void setNum1(int num1) { 32 this.num1 = num1; 33 } 34 35 public int getNum2() { 36 return num2; 37 } 38 39 public void setNum2(int num2) { 40 this.num2 = num2; 41 } 42 43 public int getResult() { 44 return result; 45 } 46 47 public void setResult(int result) { 48 this.result = result; 49 } 50 51 }
来源网站：https://www.cnblogs.com/wkrbky/p/5889328.html
