004--struts.xml配置详解
struts.xml配置详解
1、引入配置文件
标签： <include>
利用include标签，可以将一个struts.xml配置文件分割成多个配置文件，然后在struts.xml中使用<include>标签引入其他配置文件。
比如一个网上购物程序，可以把用户配置、商品配置、订单配置分别放在3个配置文件user.xml、goods.xml和order.xml中，然后在struts.xml中将这3个配置文件引入：
struts.xml：
<?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="user.xml"/>
<include file="goods.xml"/>
<include file="order.xml"/>
</struts>
user.xml：
<?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>
<package name="wwfy" extends="struts-default">
<action name="login" class="wwfy.user.LoginAction">
<!--省略Action其他配置-->
</action>
<action name="logout" class="wwfy.user.LogoutAction">
<!--省略Action其他配置-->
</action>
</package>
</struts>
2、参数配置
标签：<constant>
所有在struts.properties文件中定义的属性，都可以配置在struts.xml文件中。而在struts.xml中，是通过<constant>标签来进行配置的：
<?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>
<!--设置开发模式-->...
<constant name="struts.devMode" value="true"/>
<!--设置编码形式为GB2312-->
<constant name="struts.i18n.encoding" value="GB2312"/>
<!--省略其他配置信息-->
</struts>
3、<package>
3.1、包属性介绍
在Struts2框架中是通过包来管理action、result、interceptor、interceptor-stack等配置信息的。包属性如下：
|
属性 |
是否必需 |
描述 |
| name | 是 | 包名，作为其它包应用本包的标记 |
| extends | 否 | 设置本包继承其它包 |
| namespace | 否 | 设置包的命名空间 |
| abstact | 否 | 设置为抽象包 |
3.2、extends属性的详解
- 当一个包通过配置extends属性继承了另一个包的时候，该包将会继承父包中所有的配置，包括action、result、interceptor等。
- 由于包信息的获取是按照配置文件的先后顺序进行的，所以父包必须在子包之前被定义。
- 通常我们配置struts.xml的时候，都继承一个名为“struts-default.xml”的包，这是struts2中内置的包。
3.3、namespace的详解
namespace主要是针对大型项目中Action的管理，更重要的是解决Action重名问题，因为不在同一个命名空间的Action可以使用相同的Action名的。
1）如果使用命名空间则URL将改变
比如我们有一下配置文件
<package name="wwfy" extends="struts-default">
<action name="login" class="wwfy.action.LoginAction">
<result>/success.jsp</result>
</action>
</package>
则此配置下的Action的URL为http://localhost:8080/login.action
假如为这个包指定了命名空间
<package name="wwfy" extends="struts-default" namespace="/user">
<action name="login" class="wwfy.action.LoginAction">
<result>/success.jsp</result>
</action>
</package>
则此配置下的Action的URL为http://localhost:8080/user/login.action
2)默认命名空间
Struts2中如果没有为某个包指定命名空间,该包使用默认的命名空间,默认的命名空间总是""。
3）指定根命名空间
当设置了命名空间为“/”，即指定了包的命名空间为根命名空间时，此时所有根路径下的Action请求都会去这个包中查找对应的资源信息。
假若前例中路径为http://localhost:8080/login.action则所有http://localhost:8080/*.action都会到设置为根命名空间的包中寻找资源。
4、<action>与<result>
4.1、<action>属性介绍
|
属性名称 |
是否必须 |
功能描述 |
| name | 是 | 请求的Action名称 |
| class | 否 | Action处理类对应具体路径 |
| method | 否 | 指定Action中的方法名 |
| converter | 否 | 指定Action使用的类型转换器 |
如果没有指定method则默认执行Action中的execute方法。
4.2、<result>属性介绍
|
属性名称 |
是否必须 |
功能描述 |
| name | 否 | 对应Action返回逻辑视图名称，默认为success |
| type | 否 | 返回结果类型，默认为dispatcher |
结果集类型：
4.2.1 JSP响应
dispatcher:以请求转发方式调用JSP响应
redirect:以请求重定向方式调用JSP响应
方式1：
<result type="dispatcher">JSP的URL</result>
方式2：
<result type="dispatcher">
<param name="location">JSP的URL</param>
</result>
4.2.2 Action响应
redirectAction:以请求重定向方式调用一个Action
chain:以请求转发方式调用一个Action
如果下一个Action需要获取前面请求的数据,需要使用chain;不需要则使用redirectAction
调用同一个package中的另一个Action
<result type="redirectAction">
action的name名
</result>
调用不同package,不同namespace下的Action
<result type="redirectAction">
<param name="actionName">
action的name名
</param>
<param name="namespace">
package的namespace值
</param>
</result>
4.2.3 stream响应
stream:将Action某个InputStream属性为客户端输出
<result type="stream"> <param name="inputName">action属性</param> </result>
4.2.4 json响应
json:将Action属性以JSON格式输出
需要：导包：struts2-json-plugin-2.1.8.1.jar，当前package继承json-default
单个属性：
<result name="success" type="json"> <param name="root">action属性名</param> </result>
注意： name="root"是固定用法；
如指定的属性是boolean类型，那么Result会把这个属性做成字符串"true";
如指定的属性是JavaBean，那么Result会把这个属性做成字符串{"code":"12"}
输出多个属性：
<result name="success" type="json">
<param name="includeProperties">
属性名1,属性名2,...
</param>
</result>
注意：Result会将这一组属性做成一个json输出，如Action中有属性code="aaa",name="zs"，可以将这2个属性做成一个json：{"code":"aaa","name":"zs"}
输出Action中的所有属性：
<result name="success" type="json"> </result>
注意：Result会将Action中所有的属性做成一个json输出{"":"","":"","":""}
4.3、通配符的使用
随着result的增加，struts.xml文件也会随之变得越来越复杂。那么就可以使用通配符来简化配置：
例如下面这个案例：
Action为Test.java
public class Test {
public String test1(){
return "result1";
}
public String test2(){
return "result2";
}
public String test3(){
return "result3";
}
}
struts.xml中配置为
<package name="wwfy" extends="struts-default">
<action name="test*" class="wwfy.action.test{1}">
<result name="result{1}">/result{1}.jsp</result>
</action>
</package>
其中{1}代表前面出现的第一个*
4.4、访问Action方法的另一种实现方式
在Struts2中如果要访问Action中的指定方法，还可以通过改变URL请求来实现，将原本的“Action名称.action”改为“Action名称！方法名称.action”在struts.xml中就不需要指定方法名了。
5、异常处理
标签：<exception-mapping>、<global-exception-mapping>
这两个标签都是用来配置发生异常时对应的视图信息的,只不过一个是Action范围的,一个是包范围的,当同一类型异常在两个范围都被配置时,Action范围的优先级要高于包范围的优先级.这两个标签包含的属性也是一样的:
|
属性名称 |
是否必须 |
功能描述 |
| name | 否 | 用来表示该异常配置信息 |
| result | 是 | 指定发生异常时显示的视图信息,这里要配置为逻辑视图 |
| exception | 是 | 指定异常类型 |
两个标签的示例代码为:
<package name="wow" extends="struts-default">
<global-results> <result name="sql">/internal_Error.jsp</result> <result name="invalidinput">/invalid_Input.jsp</result> <result name="naming">/internal_Error.jsp</result> </global-results>
<global-exception-mappings> <exception-mapping result="sql" exception="java.sql.SQLException"></exception-mapping> <exception-mapping result="invalidinput" exception="cn.codeplus.exception.InvalidInputException"></exception-mapping> <exception-mapping result="naming" exception="javax.naming.NamingException"></exception-mapping> </global-exception-mappings>
<action name="*_*" class="cn.codeplus.action.{2}Action" method="{1}"> <result name="success">/{1}_{2}_success.jsp</result> <result name="error">/{1}_{2}_error.jsp</result> <exception-mapping result="sql" exception="java.sql.SQLException"></exception-mapping> </action> </package>
其中：
1、action中的exception-mapping会优先在当前action找结果集。
2、错误页面获取信息：<s:property value="exception.message"/>
6、默认class
标签：<default-class-ref>
当我们在配置Action的时候，如果没有为某个Action指定具体的class值时，系统将自动引用<default-class-ref>标签中所指定的类。在Struts2框架中，系统默认的class为ActionSupport，该配置我们可以在xwork的核心包下的xwork-default.xml文件中找到。
有特殊需要时，可以手动指定默认的class
package wwfy.action;
public class DefaultClassRef {
public void execute(){
System.out.println("默认class开始执行……");
}
}
在struts.xml中配置
<?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>
<package name="wwfy" extends="struts-default">
<!-- 指定默认class为Test -->
<default-class-ref class="wwfy.action.DefaultClassRef"/>
<action name="test1">
<result>/index.jsp</result>
</action>
</package>
</struts>
7、默认action
标签：<default-action-ref>
如果在请求一个没有定义过的Action资源时，系统就会抛出404错误。这种错误不可避免，但这样的页面并不友好。我们可以使用<default-action-ref>来指定一个默认的Action，如果系统没有找到指定的Action，就会指定来调用这个默认的Action。
<?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>
<package name="wwfy" extends="struts-default">
<default-action-ref name="acctionError"></default-action-ref>
<action name="acctionError">
<result>/jsp/actionError.jsp</result>
</action>
</package>
</struts>
8、拦截器
标签：<default-interceptor-ref>
该标签用来设置整个包范围内所有Action所要应用的默认拦截器信息。事实上我们的包继承了struts-default包以后，使用的是Struts的默认设置。
在实际开发过程中，如果我们有特殊的需求是可以改变默认拦截器配置的。当时一旦更改这个配置，“defaultStack”将不再被引用，需要手动最加。
所以一般我们配置：
<default-interceptor-ref name="拦截栈名"/>
然后在拦截栈中配置：
<interceptor-ref name="defaultStack"/>
标签：<interceptors>
通过该标签可以向Struts2框架中注册拦截器或者拦截器栈，一般多用于自定义拦截器或拦截器栈的注册。该标签使用方法如下：
<interceptors>
<!--声明一个拦截器-->
<interceptor name="名称" class="实现类">
<!--声明一个拦截器栈-->
<interceptor-stack name="拦截器栈名">
<interceptor-ref name="拦截器1"/>
<interceptor-ref name="拦截器2"/>
</interceptor-stack>
</interceptors>
拦截器组件实现类必须实现Interceptor接口,实现interceptor方法：
public String intercept(ActionInvocation invocation) throws Exception {
System.out.println("拦截器前期处理");
//登录检查
Map<String,Object> session =
ActionContext.getContext().getSession();
if(session.get("user") == null){
//未登录,定位到login.jsp
return "login";
}
// 调用下一个拦截器或者Action-->Result的业务方法
String result = invocation.invoke();
System.out.println("拦截器后期处理");
return result;
}
标签：<interceptor-ref>
通过该标签可以为其所在的Action添加拦截器功能。
<action name="" class="">
<interceptor-ref name="拦截器名或栈名"/>
<result></result>
</action>
当为某个Action单独添加拦截器功能后，<default-interceptor-ref>中所指定的拦截器将不再对这个Action起作用。
9、公共结果集
标签：<global-results>
该标签用于设置包范围内的全局结果集。在多个Action返回相同逻辑视图的情况下，可以通过<global-results>标签统一配置这些物理视图所对应的逻辑视图。
<?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>
<package name="wwfy" extends="struts-default">
<global-results>
<result name="test">/index.jsp</result>
</global-results>
</package>
</struts>
10、自定义结果集
标签：<result-types>
<result-types>
<result-type name="my"
class="com.cft.core.common.util.MyResult" />
</result-types>
实现class必须实现接口：com.opensymphony.xwork2.Result，在execute方法中编写处理逻辑。
调用：result的type="my"即可调用
浙公网安备 33010602011771号