Struts.xml文件详解
Posted 专注改变人生。
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Struts.xml文件详解相关的知识，希望对你有一定的参考价值。
一、Struts.xml文件
- Struts.xml文件构成
如图，《Struts》标签内共有5个子标签。
1.1 struts-default.xml
- 查看Struts的内容可知，Struts的默认包“default”是继承于"Struts-dafault"包的，struts-default包是在struts-default.xml中定义，struts-default.xml也是Struts2默认配置文件，所以Struts2每次都会自动加载 struts-default.xml文件。
-
struts-default.xml 里定义了一大堆的常量和bean，要使用这些只需要继承这个包就行了。
- struts-default.xml路径：struts2-core-2.3.32.jar/struts-default.xml
1.2 子标签之bean （暂时无须理会）
1.3 子标签之constant
A、 Struts所有常量定义在：
B、 常用常量：
struts.i18n.encoding=UTF-8 //设置请求的编码
struts.enable.DynamicMethodInvocation = true //是否支持动态方法的调用
struts.configuration.xml.reload = true //是否支持XML的自动加载
struts.devMode = false //开发模式
struts.ui.theme=xhtml //UI模板的设置
struts.ognl.allowStaticMethodAccess=false //是否允许在ONGL表达式中调用静态方法
struts.action.extension=action,, //STruts请求的扩展名。
C、常量定义位置
- 常量可以定义在4个位置：
A、第一个就是defalut.properties里，但是我们一般都不会在这个文件里定义常量。
B、第二个就是struts.xml中，
<struts>
<constant name="struts.enable.DynamicMethodInvocation" value="false" />
<constant name="struts.devMode" value="true" />
<package name="default" namespace="/" extends="struts-default">
<action name="xx" class="com.ActionFirst">
<result name="index">/index.jsp</result>
</action>
</package>
</struts>
C、第三个就是
- 这个文件需手工建立，也是放在src目录下，一般用于WebWork工程
D、第四个就是在web.xml中
<filter>
<filter-name>struts2</filter-name>
<filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
<init-param>
<param-name>struts.devMode</param-name>
<param-value>true</param-value>
</init-param>
</filter>
- struts读取常量的顺序：后面的会覆盖前面的配置。就是说web.xml中配置的struts.devMode的值会覆盖掉前面ABC配置的值。
1.4 子标签之include
- 包含其他配置文件，一般用于团队合作。
struts中多模块的设置，模块化文件。
<include file="xxxx.xml"/>
公用的Action放在struts.xml中，模板的配置放到模板的配置文件中。
1.5 子标签之package
1.5.1 属性
属性A、 name="default" 包名，随便取，不能重复。
属性B、 namespace="/" 命名空间。
命名空间：
struts请求的访问路径：
http://IP地址：端口号/工程名/命名空间/Action的名称。
struts会根据命名空间逐层进行匹配。
<a href="<%=path%>/aa/bb/cc/dd/nameSpaceAction">命名空间示例</a>
-
- 示例：
A. 编写index.html
1 <%@ page language="java" contentType="text/html; charset=UTF-8" 2 pageEncoding="UTF-8"%> 3 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 4 <html> 5 <% 6 String path = request.getContextPath(); 7 String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/"; 8 %> 9 <head> 10 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 11 <title>Insert title here</title> 12 </head> 13 <body> 14 <a href="<%=path%>/aa/bb/exam"> 命名空间示例</a> 15 </body> 16 </html>
- a标签跳转到“工程名/aa/bb/exam”URL，
B、编写action类
1 package com; 2 3 public class ActionFirst { 4 /** 5 * 必须要有String的execute方法 6 * @return 7 */ 8 public String execute(){ 9 10 return "index"; 11 } 12 }
C、配置struts.xml文件
1 <struts> 2 <constant name="struts.enable.DynamicMethodInvocation" value="false" /> 3 <constant name="struts.devMode" value="true" /> 4 5 <package name="default" namespace="/" extends="struts-default"> 6 <action name="xx" class="com.ActionFirst"> 7 <result name="index">/index.jsp</result> 8 </action> 9 </package> 10 11 <package name="aa" namespace="/aa" extends="struts-default"> 12 <action name="exam" class="com.ActionFirst"> 13 <result name="index">/index_2.jsp</result> 14 </action> 15 </package> 16 17 18 </struts>
D、编写跳转后的index_2.jsp页面
1 <%@ page language="java" contentType="text/html; charset=UTF-8" 2 pageEncoding="UTF-8"%> 3 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 4 <html> 5 <head> 6 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 7 <title>Insert title here</title> 8 </head> 9 <body> 10 我是跳转后的jsp页面 11 12 </body> 13 </html>
结果：
点击a标签跳转到：
查看地址栏“http://localhost:8080/struts_project_1/aa/bb/exam” 说明跳转成功，但是在struts.xml文件如下配置，并没有“/aa/bb”这个命名空间，正常来说，地址栏的URL 为“http://localhost:8080/struts_project_1/aa/exam” 才能跳转成功，但是还是跳转成功了，|struts的匹配规则为： struts会根据命名空间逐层进行匹配。
以本例来说，当URL为“/aa/bb”找不到action=exam时，就会到上一层命名空间“/aa”里找action=exam ，就这样一层一层往上找。
<package name="aa" namespace="/aa" extends="struts-default"> <action name="exam" class="com.ActionFirst"> <result name="index">/index_2.jsp</result> </action> </package>
属性C、 extends="struts-default" 包之间的继承。就可以父包配置的选项
默认所有的package都继承struts-default.xml
属性D、 abstract="true|false" 是否抽象包。抽象包中不能定义action。
1.5.2 package的子标签
1.5.2.1 package子标签之action标签
<action name="" class="" method="">
示范： <action name="methodAction" class="com.action.MethodAction" method="test"></action>
解析：访问methodAction路径，默认执行execute方法。通过method属性的配置，可以执行其他的方法。示例中就是执行test方法。
值得注意到是 method里的方法只能是public访问修饰符，而不能是其它修饰符，可以在这个public方法里调用其他非public的方法。
1.5.2.2 action标签的子标签《param》
- action中的param
设置或者获取Action中定义的成员变量的值。要求成员变量要有SET与GET方法。本文中只示范设置成员变量，而获取在后续章节再详细讲解。
示例（设置Action中定义的成员变量的值）：
index.jsp:
<body>
<a href="<%=path%>/aa/exam"> action中param标签使用示例</a>
</body>
ActionFirst.java:
package com; public class ActionFirst { /** * 使用action中的param标签前提是action的成员变量必须有get和set方法。 * */ private String userName; public String getUserName() { return userName; } public void setUserName(String userName) { this.userName = userName; } public String execute(){ System.out.println(this.userName); //在控制台输出Action成员变量的值 return "index_2"; } }
struts.xml:
<package name="aa" namespace="/aa" extends="struts-default"> <action name="exam" class="com.ActionFirst"> <param name="userName">用户名</param> <result name="index_2">/index_2.jsp</result> </action> </package>
结果：
点击标签之后：
1.5.2.2 action标签的子标签《result》
-
action中的result
属性A、 name：result的名称
属性B、type：result的类型，
chain： 请求转发到Action
dispatcher： 请求转发到JSP面，默认
redirect： 重定向到JSP页面
redirectAction： 重定向到Action
stream： 流方式，用于下载
freemarker freemarker模版引擎 （了解即可）
示例： 以上题为例：
<package name="aa" namespace="/aa" extends="struts-default"> <action name="exam" class="com.ActionFirst"> <param name="userName">用户名</param> <result name="index_2">/index_2.jsp</result> </action> </package>
- struts.xml中<result name="index_2">/index_2.jsp</result> ，当访问URL"工程名/aa/exam"时，ActionFirst 这个 Action 的execute方法的返回值为index_2时，将跳转到index_2.jsp这个jsp。
type类型如果没有写，默认是dispatcher ，即<result name="index_2" type="dispatcher">/index_2.jsp</result>
- type="chain" 使用示例：
<package name="aa" namespace="/aa" extends="struts-default"> <action name="exam" class="com.ActionFirst"> <result name="index_2" type="chain"> <param name="namespace">/bb</param> <param name="ActionName">ChainAction</param> </result> </action> </package> <package name="bb" namespace="/bb" extends="struts-default"> <action name="ChainAction" class="com.ChainAction"> </action> </package>
解析： 当我们访问url"工程名/aa/exam" 的时候，会调用com.ActionFirst 这个类的execute方法，然后返回一个String值"index_2" ,由于这个result是chain类型的（请求转发到Action）， 所以会找到<param name="namespace">/bb</param> 命名空间为"/bb"中的 <param name="ActionName">ChainAction</param> Action名叫“ChainAction”的类并执行，调用那个的execute方法，并返回String值。 注意： name="namespace"和name="ActionName" 值不能写错，但是不区分大小写，ActionName与actionname是一样的。
- type="redirect" 使用示例
<package name="aa" namespace="/aa" extends="struts-default"> <action name="exam" class="com.ActionFirst"> <result name="redict_index_2" type="redirect">/index_2.jsp</result> </action> </package>
- type="redirectAction" 重定向到Action 用法与type="chain" 相同
- type="freemarker" 使用示例：
<package name="aa" namespace="/aa" extends="struts-default"> <action name="exam" class="com.ActionFirst"> <param name="userName">admin</param> <result name="freemarker_index_2" type="freemarker">/cc.ftl</result> </action> </package>
解析： 当地址栏为"工程名/aa/exam"时， 调用com.ActionFirst ,然后调用execute方法，给这个类的成员变量赋值（<param name="userName">admin</param>）， 最后execute方法返回String值=freemarker_index_2， 跳转到/cc.ftl 里。
cc.ftl：
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
${userName}
</body>
</html>
${} 这是ftl文件的表达式，用于获取值。
结果：
如图可见，在Struts.xml设置的userName=admin成功在cc.ftl文件里获取。
1.5.3 package子标签之《default-action-ref》标签
- 配置默认的action。
当链接到一个命名空间时，没有指定action的路径，那么就会执行默认的action。
http://localhost:8080/Struts2_Project_1/test1/
<package name="test" namespace="/test1" extends="struts-default">
<default-action-ref name="index" />
<action name="index">
<result>/main.jsp</result>
</action>
</package>
示例：
struts.xml
<struts> <package name="default" namespace="/" extends="struts-default"> <default-action-ref name="xx"></default-action-ref> <action name="xx" class="com.ActionFirst"> <result name="index_2">/index_2.jsp</result> </action> </package> </struts>
index_2.jsp
<body>
我是重定向后的页面
</body>
注意： 1. 请把（项目名/index.jsp）中的index.jsp这个文件去掉，否则web服务器会自动跳转到index.jsp页面。
2. <default-action-ref name="xx"></default-action-ref> 这个标签请放在《package》标签中的第一行，否则报错。
结果：
解析： 当url为“项目名/”/为命名空间，此时在地址栏里没有输入任何action的名，所以无法执行Action，默认执行<default-action-ref name="xx"></default-action-ref> 中的名叫“xx”的action。 于是出现上图。
1.5.4 package子标签之《global-results》标签
- 是Package下面所有的action都可以调用global中定义的result.
- global-results与results的区别：
global-result：是Package下面所有的action都可以调用global中定义的result.
result：是action中私用的。
其它的package想要调用另一个package中定义的global-result时，直接将包做
继承关系即可。通过extend来继承。
<package name="aa" namespace="/aa" extends="default">
- 《global-results》标签适用于错误页面、版权页面等通用的页面。
示例：
Struts.xml
<package name="aa" namespace="/aa" extends="struts-default"> <global-results > <result name="error">/page_error.jsp</result> </global-results> <action name="exam" class="com.ActionFirst"> <result name="index_2">/index_2.jsp</result> </action> </package>
ActionFirst.java
package com; public class ActionFirst { /** * 使用action中的param标签前提是action的成员变量必须有get和set方法。 * */ private String userName; public String getUserName() { return userName; } public void setUserName(String userName) { this.userName = userName; } public String execute(){ String a=null; if(a!=null && !a.equals("")) return "index_2"; else return "error"; } }
解析：当地址栏为“项目名/aa/exam”时，执行ActionFirst的execute方法，返回String=“error” ，然后名叫exam的这个action中并没有名叫error的result，但是仍旧可以使用，因为这个errror定义在<global-results > 里，本包中的所有action都可以使用，而不必在《result》中定义。
以上是关于Struts.xml文件详解的主要内容，如果未能解决你的问题，请参考以下文章