Structs2中配置文件详解-不仅要会用更要理解

 

Structs2中配置文件详解-不仅要会用更要理解

分类： Java 2012-04-15 20:39 1251人阅读 评论(0) 收藏 举报

struts action encoding extension class login

 

Struct2-配置文件：

整个配置我们可以分为两大块，一个是在web.xml文件中的配置，另一块是Struts2框架中的配置。框架中的配置又有执行环境的配置和Struts2组件配置。


web.xml配置
框架执行环境配置(全局配置选项):struts.properties文件
组件配置文件:struts-default. xml, struts-plugin.xml, strtus.xml


1.web.xml配置：
FilterDispatcher是一个过滤器。注意，在Struts2.0.X的时候，使用的是
org.apache.struts2.dispatcher.FilterDispatcher作为核心控制器,而Struts2.1 中改成了 org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter。它是 整个web应用的配置项，需要在web.xml中进行配置.

 

<filter>
<filter-name>struts2</filter-name>
<filter-class>
org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter
</filter-class>
</filter>
<filter-mapping>
<filter-name>struts2</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

如果是一个基本的web应用，这样就足够了，剩下的就是配置web应用的一些执行环境配置（全局配置）和web应用中使用到的组件的配置，如action配置，拦截器的配置。
web应用的执行环境主要是通过struts.properties来完成。应用中的组件配置主要是通过strtus.xml来完成。

2. struts.properties 文件
这个文件提供了一种更改框架默认行为方式的机制。在一般情况下，如果不是打算让调试更加方便的话，我们没有必要更改这个文件。哪么这些默认的属性在哪里存放呢？
在项目的src目录中可以自己编写一个名称为struts.properties文件，编译以后就放到了/WEB-INF/classes 中，Struts2框架在启动的时候，会自动读取这个文件，但是在读取这个文件之前，会先到struts2-core-xxx.jar包中加载名为 default.properties文件，这个文件中定义了默认的配置，所以我们可以在strtus.properties中定义一些配置覆盖 default.properties中的配置，如果没有struts.properties文件，则采用默认配置。
打开default.properties文件我们会看到如下部分类容：
打开该文件，可以看到一些全局的配置选项，在这些选项中，我们发现了有一些这样的配置，其中struts.action.extension 配置的就是Struts默认的请求后缀名。关于更多的配置的含义，后面用到了再讲解，现在暂时不必理会这些配置的含义.

 

### Used by the DefaultActionMapper
### You may provide a comma separated list, e.g. struts.action.extension=action,jnlp,do
### The blank extension allows you to match directory listings as well as pure action names
### without interfering with static resources.
struts.action.extension=action,,
### This can be used to set your default locale and encoding scheme
# struts.locale=en_US
struts.i18n.encoding=UTF-8

更改默认设置：

 

### Used by the DefaultActionMapper
### You may provide a comma separated list, e.g. struts.action.extension=action,jnlp,do
### The blank extension allows you to match directory listings as well as pure action names
### without interfering with static resources.
struts.action.extension=action,,
### This can be used to set your default locale and encoding scheme
# struts.locale=en_US
struts.i18n.encoding=UTF-8

### Used by the DefaultActionMapper
### You may provide a comma separated list, e.g. struts.action.extension=action,jnlp,do
### The blank extension allows you to match directory listings as well as pure action names
### without interfering with static resources.
struts.action.extension=action,,
### This can be used to set your default locale and encoding scheme
# struts.locale=en_US
struts.i18n.encoding=UTF-8

因为default.properties文件是存放在jar包中的，struts2启动的时候自动会寻找到。我们不能直接修改这个文件，但是我们可以使用struts.properties文件来覆盖default.properties文件中的内容。
在web项目的src的根目录中新建一个struts.properties,然后将想要修改的属性添加到该文件中，就可以覆盖掉原来的配置.注意:这个文件存放在src的根目录中（编译之后放到了/WEB-INF/classes根目录中）：

 

##激活重新载入国际化文件的功能
struts.i18n.reload=true
##修改请求后缀为action或者do
struts.action.extension=action,do
##打开开发者模式，打开之后，我们修改配置文件之后不用重新启动服务器
struts.devMode =true

##激活重新载入国际化文件的功能
struts.i18n.reload=true
##修改请求后缀为action或者do
struts.action.extension=action,do
##打开开发者模式，打开之后，我们修改配置文件之后不用重新启动服务器
struts.devMode =true

3. struts-default.xml
这个文件用来加载默认启动的组件。它存放在struts2-core-xxx.jar包的根目录下，系统启动的时候会加载这个文件。这个文件中配置的组件有类型转换组件，拦截器组件还有结果类型组件等等，关于这些组件的概念后面将会讲到，这里只需要了解。
4. struts-plugin.xml
可以在struts2中使用插件，Struts2在启动的时候，会自动搜索classpath中的jar包中的struts-plugin.xml文件来加载插件。关于插件的应用，将会在后面讲到。
5. struts.xml
struts.xml文件中包含的是我们开发的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>
<!-- 配置常量，覆盖default.properties中的配置 -->
<constant name="struts.action.extension" value="do" />
<!-- struts2的Action必须放在指定的包空间下 -->
<package name="com.wq" extends="struts-default">
<!-- 定义action -->
<action name="login" class="com.wq.web.action.LoginAction">
<!-- 定义处理结果和资源之间的映射关系 -->
<result name="success">/welcome.jsp</result>
<result name="error">/error.jsp</result>
</action>
</package>
</structs>

<?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>
<!-- 配置常量，覆盖default.properties中的配置 -->
<constant name="struts.action.extension" value="do" />
<!-- struts2的Action必须放在指定的包空间下 -->
<package name="com.wq" extends="struts-default">
<!-- 定义action -->
<action name="login" class="com.wq.web.action.LoginAction">
<!-- 定义处理结果和资源之间的映射关系 -->
<result name="success">/welcome.jsp</result>
<result name="error">/error.jsp</result>
</action>
</package>
</structs>

5.1在struts.xml中覆盖default.properties中的全局配置
我们修改全局配置的时候，使用struts.properties文件来覆盖default.properties文件中的内容。实际上我们可以不用创建 struts.properties文件也可以做到覆盖default.properties文件中的配置，就是直接在strtuts.xml文件中使 用<constant>配置:见上面的例子中

5.2将struts.xml拆分成多个配置文件
可以想象，在web应用中还会不断的有action需要定义，这样struts.xml的配置会越来越多，文件会越来越大。
为了避免struts.xml文件过于庞大，臃肿，提高strtus.xml文件的可读性，我们可以将一个struts.xml文件分解成多个配置文件， 然后在strtus.xml文件中包含其它配置文件.这样struts2就可以使用模块化的方式来管理struts.xml配置文件了。
我们可以在配置中使用<include> 来包含另外一个配置文件.下面我们新建一个struts-hello.xml文件，然后在struts.xml文件中包含该文件

在structs2中配置文件中
Structs标签中：<include file="struts-hello.xml" />   来引入structs-hello.xml文件实现模块化管理。


6. 配置文件加载顺序
配置文件的加载顺序从上到下依次是:我们可以打开struts的源代码，设置断点来跟踪启动顺序。通过分析源代码，得到如下结论：
1.default.properties：
该文件存放在strtus2-core-XXX.jar中的org.apache.struts2包中，默认全局配置
2.struts-default.xml
该文件存放在strtus2-core-XXX.jar中的根目录下，加载默认的组件，这些组件包括一系列的拦截器和转换器等
3.struts-plugin.xml
如果为应用配置了插件，则插件的jar文件中会存在这个文件，它会被自动加载
4.struts.xml
自己创建的配置文件，不能改名，用于存放自定义的组件如Action或者拦截器等。这个文件中也可以覆盖default.properties文件中的默认配置
5.struts.properties
自己创建的配置文件,不能改名，用于修改全局配置，一般我们将要修改的全局配置放到了struts.xml文件中，所以不需要配置这个文件.如果在struts.xml和struts.properteis中同时配置，则以strtus.properties中的为准

7. struts.xml—包配置：
在strtuts2中，核心组件就是Action,拦截器等，struts2 框架使用包来管理Action和拦截器等。每个包就是多个Action，多个拦截器等的集合.package中有下面几个属性：
 name：这是一个必填属性，该属性指定该包的名字，该名字是该包被其它包引用的key
 extends:可选属性。指定该包继承其它包。继承其它包，可以继承其它包中的Action定义。
 abstract：可选属性。指定该包是不是一个抽象包。抽象包中不能包含Action定义。

在前面的配置中：继承了stuts2的默认包struts-default,那么这个默认包在哪里定义的呢？我们可以查看struts2-core-XXX.jar包中有一个struts-default.xml文件

这个文件中配置了很多的<bean> 标签和一个<package>标签，<package>标签的name就是struts-default.这个默认的包空间中定 义了struts2内建的Result类型，拦截器等。Struts2 框架每次都会自动加载该文件。我们在strtus.xml文件中继承了默认的包空间，所以struts-default.xml文件一定比 strtus.xml文件先加载.
只有继承了正确的父Package，才能用到所需的预先配置好的特性。在大多数情况下，我们都应该继承“struts-default.xml”配置文件中的“strust-default”Package

8.struts.xml—Action配置：
Action只是一个控制器，它并不直接对请求者生成任何响应。因此，Action处理完用户请求后，Action需要将指定的视图资源呈现给用户。因此，配置Action的时候，应该配置逻辑视图和物理视图资源之间的映射。
配置逻辑视图和物理视图之间的映射关系是通过<result>来定义的，每个<result> 元素定义逻辑视图和物理视图之间的一次映射，如下面的配置:

<struts>
<constant name="struts.action.extension" value="do"></constant>
<package name="com.wq" extends="struts-default">
<action name="login" class="com.wq.web.action.LoginAction">
<result name="success">/welcome.jsp</result>
<result name="error">/error.jsp</result>
</action>
</package>
</struts>

<struts>
<constant name="struts.action.extension" value="do"></constant>
<package name="com.wq" extends="struts-default">
<action name="login" class="com.wq.web.action.LoginAction">
<result name="success">/welcome.jsp</result>
<result name="error">/error.jsp</result>
</action>
</package>
</struts>

下面是Action配置中属性的说明：
name:提供了执行Action所对应的URL地址，上面是“login.do” （我们已经将请求路径的后缀改成了*.do） ，默认是 login.action。
class: Action类的完整的类名

下面我们再看看<result>标记:
我们可以看到在result节点中多了“name”属性，实际上这个属性是一直都存在的，如果开发人员没有显式指定它的值，那么它的默认值就是“success”,所以上面的配置可以改成:

<action name="login" class="com.wq.web.action.LoginAction">
<result >/welcome.jsp</result>
<result name="error">/error.jsp</result>
</action>
</package>
</struts>

<action name="login" class="com.wq.web.action.LoginAction">
<result >/welcome.jsp</result>
<result name="error">/error.jsp</result>
</action>
</package>
</struts>

使用通配符匹配Action：
先看一个domo：

<?xml version="1.0"?>
<!DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN"
    "http://struts.apache.org/dtds/struts-2.1.7.dtd">
<struts>
     <constant name="s" value=""></constant>
    <!-- 设置开发模式 -->
    <constant name="struts.devMode" value="true" />
    <constant name="struts.action.extension" value="action,do" />
    <!-- 此三行为了解决不换行问题而加上的 -->
    <constant name="struts.ui.theme" value="simple" />
    <constant name="struts.ui.templateDir" value="template" />
    <constant name="struts.ui.templateSuffix" value="ftl" />


    <package name="cn.ouuo.action" extends="struts-default" >

         <action name="SearchUser_*" class="searchAction" method="{1}">
            <result name="listResult">/listResult.jsp</result>
            <result name="listData">/more.jsp</result>

            <result name="wordPre">/officePre.jsp</result>
             <result name="manager">/manager.jsp</result>
            <result name="success">/success.jsp</result>
        </action>

    </package>
</struts>

<?xml version="1.0"?>
<!DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN"
    "http://struts.apache.org/dtds/struts-2.1.7.dtd">
<struts>
     <constant name="s" value=""></constant>
    <!-- 设置开发模式 -->
    <constant name="struts.devMode" value="true" />
    <constant name="struts.action.extension" value="action,do" />
    <!-- 此三行为了解决不换行问题而加上的 -->
    <constant name="struts.ui.theme" value="simple" />
    <constant name="struts.ui.templateDir" value="template" />
    <constant name="struts.ui.templateSuffix" value="ftl" />


    <package name="cn.ouuo.action" extends="struts-default" >

         <action name="SearchUser_*" class="searchAction" method="{1}">
            <result name="listResult">/listResult.jsp</result>
            <result name="listData">/more.jsp</result>

            <result name="wordPre">/officePre.jsp</result>
             <result name="manager">/manager.jsp</result>
            <result name="success">/success.jsp</result>
        </action>

    </package>
</struts>

在这里我主要是想说一下自己以前比较迷惑的地方，主要就是在action配置的几个参数，其实name属性就是要访问的Url地址，method中的1就 是与 name里的* 进行匹配的，方法就是你在action中定义的各个方法，result里的name属性就是你action里返回的字符串，根据这个属性来确定跳转页面

比如要访问：http:localhost:8080/ouuo/SearchUser_Manager.action 

转载地址：http://spring-g.iteye.com/blog/1286153