Struts 2的基本配置

参考文章：http://book.51cto.com/art/201108/279915.htm

 

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

因为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

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
>

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
>

下面是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：
先看一个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
>

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