struts2中struts.xml配置文件详解
Posted Jansens
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了struts2中struts.xml配置文件详解相关的知识,希望对你有一定的参考价值。
struts.xml的常用配置
<?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> <!-- 所有匹配*.action的请求都由struts2处理 --> <constant name="struts.action.extension" value="action" /> <!-- 是否启用开发模式 --> <constant name="struts.devMode" value="true" /> <!-- struts配置文件改动后,是否重新加载 --> <constant name="struts.configuration.xml.reload" value="true" /> <!-- 设置浏览器是否缓存静态内容 --> <constant name="struts.serve.static.browserCache" value="false" /> <!-- 请求参数的编码方式 --> <constant name="struts.i18n.encoding" value="utf-8" /> <!-- 每次HTTP请求系统都重新加载资源文件,有助于开发 --> <constant name="struts.i18n.reload" value="true" /> <!-- 文件上传最大值 --> <constant name="struts.multipart.maxSize" value="104857600" /> <!-- 让struts2支持动态方法调用 --> <constant name="struts.enable.DynamicMethodInvocation" value="true" /> <!-- Action名称中是否还是用斜线 --> <constant name="struts.enable.SlashesInActionNames" value="false" /> <!-- 允许标签中使用表达式语法 --> <constant name="struts.tag.altSyntax" value="true" /> <!-- 对于WebLogic,Orion,OC4J此属性应该设置成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节点是struts2中组件化的方式 可以将每个功能模块独立到一个xml配置文件中 然后用include节点引用 --> <include file="struts-default.xml"></include> <!-- package提供了将多个Action组织为一个模块的方式 package的名字必须是唯一的 package可以扩展 当一个package扩展自 另一个package时该package会在本身配置的基础上加入扩展的package 的配置 父package必须在子package前配置 name:package名称 extends:继承的父package名称 abstract:设置package的属性为抽象的 抽象的package不能定义action 值true:false namespace:定义package命名空间 该命名空间影响到url的地址,例如此命名空间为/test那么访问是的地址为http://localhost:8080/struts2/test/XX.action --> <package name="com.kay.struts2" extends="struts-default" namespace="/test"> <interceptors> <!-- 定义拦截器 name:拦截器名称 class:拦截器类路径 --> <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> <!-- 定义默认的拦截器 每个Action都会自动引用 如果Action中引用了其它的拦截器 默认的拦截器将无效 --> <default-interceptor-ref name="mystack"></default-interceptor-ref> <!-- 全局results配置 --> <global-results> <result name="input">/error.jsp</result> </global-results> <!-- Action配置 一个Action可以被多次映射(只要action配置中的name不同) name:action名称 class: 对应的类的路径 method: 调用Action中的方法名 --> <action name="hello" class="com.kay.struts2.Action.LoginAction"> <!-- 引用拦截器 name:拦截器名称或拦截器栈名称 --> <interceptor-ref name="timer"></interceptor-ref> <!-- 节点配置 name : result名称 和Action中返回的值相同 type : result类型 不写则选用superpackage的type struts-default.xml中的默认为dispatcher --> <result name="success" type="dispatcher">/talk.jsp</result> <!-- 参数设置 name:对应Action中的get/set方法 --> <param name="url">http://www.sina.com</param> </action> </package> </struts>
一个Action内包含多个请求处理方法的处理
Struts1提供了DispatchAction,从而允许一个Action内包含多个请求处理方法。Struts2也提供了类似的功能。
处理方式主要有以下三种方式:
1. 1 动态方法调用:
<!-- 动态方法调用html标签与Struts2标签 --> <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。
<struts> <!-- //禁用动态方法调用,默认为true启用,false禁用 constant:name="struts.enable.DynamicMethodInvocation" --> <constant name="struts.enable.DynamicMethodInvocation" value="true" /> </struts>
示列:简单的一个加法和减法例子。
1. index.jsp用户在页面输入两个数字,选择相加,或者相减
当用户点击加或减需要走同一个Action但处理请求方法不同,这里使用了js动态选择。
<body> <!-- 动态方法调用 使用:Struts2标签也可以使用HTML标签 --> <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> <!-- js --> <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> <!-- //禁用动态方法调用,默认为true启用,false禁用 constant:name="struts.enable.DynamicMethodInvocation" --> <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响应结果的页面
<body> <!-- 结果页面 --> 计算结果:<s:property value="fruit" /> </body>
1.2Action配置method属性(示列与以上代码大多一致,只修改有变更的):
将Action类中的每一个处理方法都定义成一个逻辑Action方法。
1. index.jsp页面
<body> <!-- Action配置method属性 使用:Struts2标签也可以使用HTML标签 --> <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> <!-- js --> <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属性查找方法有两种途径:
使用动态方法调用和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> <!-- 使用通配符映射(wildcard mappings)方式 使用:Struts2标签也可以使用HTML标签 --> <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> <!-- js --> <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> <!-- <result name="fruitPage" >/{1}.jsp</result>表达式也可以写在这里 --> </action> </package> </struts>
实际上这一点从原理上来讲可以理解,default-action-ref这个配置的意思是当用户在点击了没有定义的action时,如果struts没有找到用户定义的action名称,则会自动跳转到该默认定义的action中。
个人觉得地址栏中项目后不写名称和名称不存在是两个概念。
示列:
1. struts.xml 就在通配符例子中配置上默认Action
<?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 --> <default-action-ref name="defaultAction"></default-action-ref> <action name="defaultAction"> <result>/error.jsp</result> </action> <!-- 通配符映射(wildcard mappings) --> <action name="*Action" class="com.struts.ComputeAction" method="{1}" > <result name="fruitPage" >/fruit.jsp</result> <!-- <result name="fruitPage" >/{1}.jsp</result>表达式也可以写在这里 --> </action> </package> </struts>
2. index.jsp页面 这里我们把提交的url :Action地址链接,写错打断,当提交时找不到对应的Action,则会进入默认Action,进入error.jsp页面
<body> <!-- 使用通配符映射(wildcard mappings)方式 使用:Struts2标签也可以使用HTML标签 --> <s:form name="form" theme="simple" > num1:<s:textfield name="num1" /> num2:<s:textfield name="num2" /> <!-- 测试默认Action,当提交的Action地址错误。则会走默认Action --> <s:submit type="button" value="加" onclick="computeMethod(\'ssss\')" /><!-- 把动态url地址乱写 --> <s:submit type="button" value="减" onclick="computeMethod(\'subtractActios\')" /><!-- 或在url地址中多加字符 --> </s:form> <!-- js --> <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返回的某个逻辑视图名,系统就会把对应的物理视图资源呈现给浏览者。
<!-- 全局结果可满足一个包中多个Action共享一个结果,也就是说,当多个Action中都有一个重复的result时就可以使用全局结果,也就是说公共的result --> <global-results> <result name="fruitPage" type="dispatcher" >/fruit.jsp</result> </global-results>
名字 | 说明 |
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
<?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 --> <default-action-ref name="defaultAction"></default-action-ref> <!-- 全局结果可满足一个包中多个Action共享一个结果,也就是说,当多个Action中都有一个重复的result时就可以使用全局结果,也就是说公共的result <global-results> <result name="fruitPage" type="dispatcher" >/fruit.jsp</result> </global-results> --> <action name="defaultAction"> <result>/error.jsp</result> </action> <!-- 通配符映射(wildcard mappings) --> <action name="*Action" class="com.struts.ComputeAction" method="{1}" > <!--1 表达式{1}也可以写在url连接中,class,name中都可以写,也可以写多少,索引从1开始 <result name="fruitPage" >/{1}.jsp</result> --> <!--2 默认dispatcher转发跳转 <result name="fruitPage" type="dispatcher" >/fruit.jsp</result> --> <!--3 重定向跳转 <result name="fruitPage" type="redirect" >/fruit.jsp</result> --> <!--4 redirectAction: Action实例 与另一个Action实例互相跳转 <result name="fruitPage" type="redirectAction" >skipAction</result> --> <!--4.1 使用感叹号指定跳转方法,xml会显示报错,但可以用。 使用?&不能在Action实例中带参数 <result name="fruitPage" type="redirectAction" >skipAction!add</result> --> <!--4.2 跳转Action带参数的方式: actionName:跳转Action的名称 method:跳转Action实例中的哪个方法 num:带的参数,可写固定,可使用${属性名}取上一个Action实例中的属性,实现动态传值。 --> <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; } }
以上是关于struts2中struts.xml配置文件详解的主要内容,如果未能解决你的问题,请参考以下文章