Struts2配置文件

Struts2配置文件

简介:

与Struts2相关的配置文件有好几个,常用的有 struts.properties , web.xml, struts.xml等。web.xml中配置Struts2的分发器Filter。struts.properties里配置Struts2的一些属性。struts.xml里配置了Struts2的Action。Struts2的下载地址:http://struts.apache.org/

目录:

  1. struts.proerties
  2. web.xml
  3. struts.xml
  4. struts常数的配置与搜索
  5. struts最小依赖包

struts.properties

struts.properties配置了Struts2的一些参数。每个可配的参数都有一个默认值。该文件不是必须的,如果无需改变任何参数值,可以不用添加该文件。

常用的需要在struts.properties里重新配置的属性有:

//指定默认编码集,对于请求参数带有中文的情况应该设置陈GBK或GB2312.默认值UTF-8
struts.i18n.encoding=GB2312
//是否每次HTTP请求到达时,都重新加载国际化资源文件。默认值false
struts.i18n.reload=true
//但struts.xml改动后,是否重新加载该文件。在开发阶段建议将此属性设置为“true”,提高开发效率。默认值false
struts.configuration.xml.reload=true
//是否使用Struts2的开发模式,可以获得更多报错信息,便于调试。在开发阶段设置为true。默认值false
struts.devMode = true
//设置浏览器是否缓存静态页面。开发阶段设置为false,以获得服务器的最新响应。默认值true
struts.serve.static.browserCache=true
//指定后缀为.action形式的请求可被Struts2处理。可配置多个请求后缀,比如.do、.struts2等,配置时多个后缀名用逗号隔开
struts.action.extension=action,do,struts2,
//配置服务器运行时的端口号。一般情况下该属性不修改,如果端口号占用则重新分配端口号。默认值80
struts.url.http.port = 8080

注:Struts2的默认属性位于struts2-core-2.0.11.1.jar包org/apache/struts2下面的default.properties里,用户可以在项目的WEB-INF/class下添加struts.properties覆盖默认的配置。

web.xml

任何MVC框架都需要与Web应用整合,这就不得不借助于web.xml文件,只有配置在web.xml文件中的Servlet才会被加载。通常所有MVC框架都需要Web应用加载一个核心控制器,对于Struts2框架而言,需要加载StrutsPrepareAndExecuteFiter,该Filter将会加载应用的Struts2框架。

除此之外,还可以在Web.xml中配置Struts2常量(struts.properties文件专门用于配置常量)。

配置StrutsPrepareAndExecuteFiter的代码如下:

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

注:以上代码段存在于struts2-blank\WEB-INF中的web.xml

struts.xml

struts.xml是Struts2的核心配置文件,里面配置Action, JSP, Exception, Intercepter等。另外,struts.properties里的配置也可以配置在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> <!-- http://localhost:8081/hotelsys/test/demo.do 1. StrutsPrepareAndExecuteFilter根据struts.xml配置文件的信息,确定凡是*.do结尾的请求,均归struts处理。
2. 一旦发现.do结尾请求出现,直接拦截,做以下操作:
a. http://localhost:8081/hotelsys/test/demo (去除识别标志)
b. /test/demo (获得真正访问资源地址信息)
c. /test获得目录,去匹配对应的包的namespace
d. demo 获得action的名字,去对应包中查找,如果找到,则创建该action的实例,调用其execute方法一次。 --> <!-- 设置为开发模式,系统运行速度将降低,但是提供的出错提示更加直观,一般用于系统调试的时候使用 -->
<constant name="struts.devMode" value="true" />
<constant name="struts.action.extension" value="do"/> <!--所有以*.do结尾的请求全部归struts处理 ,如果没有显式指定action识别后缀,默认就是action, 比如toInput.action-->
<constant name="struts.ui.theme" value="simple"></constant> <!-- struts2将自动帮程序员生成网页,提供了多种生成模版 -->
<constant name="struts.i18n.encoding" value="utf-8"></constant> <!--
package是若干个拥有相关功能的action的群组
-->
<package name="demoPak" namespace="/test" extends="struts-default">
<action name="demo" class="edu.fjnu.hotelsys.action.DemoAction">
</action>
</package> <package name="hotelsys-default" namespace="/" extends="struts-default"> <interceptors> <interceptor name="authentication" class="edu.fjnu.hotelsys.interceptor.AuthenticationInterceptor"></interceptor> <!-- 普通需要权限的用户操作 普通的,需要身份验证才可以使用的action,将使用user拦截器stack-->
<interceptor-stack name="user">
<interceptor-ref name="authentication" />
<interceptor-ref name="defaultStack" />
</interceptor-stack> <!-- 普通需要权限的用户表单提交 需要身份验证才可以使用的action,同时该action中拥有表达提交操作,将使用user-submit拦截器 stack -->
<interceptor-stack name="user-submit">
<interceptor-ref name="user" />
</interceptor-stack> <!-- 需要身份验证才可以使用的action,同时该action中拥有表达提交操作,同时该表单具备文件提交功能,将使用user-file-submit拦截器
stack -->
<interceptor-stack name="user-file-submit">
<interceptor-ref name="fileUpload">
<param name="allowedTypes">image/bmp,image/pjpeg,image/png</param>
<param name="maximumSize">200000</param>
</interceptor-ref>
<interceptor-ref name="user"/>
</interceptor-stack> <!-- 非权限信息访问 没有任何身份需求,都可以访问的action,将使用guest拦截器stack-->
<interceptor-stack name="guest">
<interceptor-ref name="defaultStack" />
</interceptor-stack> </interceptors> <!-- 没有特殊指明拦截器的action,默认使用user拦截器stack -->
<default-interceptor-ref name="user"/> <global-results>
<result name="gotoLoginAction" type="redirectAction">
<param name="actionName">gotoLogin</param>
<param name="namespace">/security</param>
</result>
<result name="error" type="redirect">/error.jsp</result>
</global-results> </package> <include file="security-module.xml"/>
<include file="room-module.xml"/>
<include file="hotel-module.xml"/>
<include file="user-module.xml"/> </struts>

注:struts.xml配置文件的默认位置在struts2-blank包下/WEB-INF/calsses/struts.xml。可以struts.xml放到MyEclipse项目的src文件夹下。并且,log4j2.xml也在此目录下。

Struts2常数的配置与搜索

配置Struts2常数有3中方式:

1.在struts.properties文件中配置常量。

2.在web.xml文件中配置核心Filter时通过初始化参数来配置常数。

3.在struts.xml文件中使用<constant.../>元素来配置常量。

通常,Struts2框架按如下搜索顺序来加载Struts2常量:

1.struts-default.xml: 该文件保存在 struts2-core-2.3.1.2.jar 文件中。

2.struts-plugin.xml: 该文件保存在 struts2-xxx-2.3.1.2.jar文件中。

3.struts.xml: 该文件是Web应用自己的struts2配置文件。

4.struts.properties: 该文件是Web应用默认的Struts2配置文件。

5.web.xml: 该文件是Web应用的配置文件。

注:上面指定了Struts2框架搜索Struts2常量的顺序,但是如果在多个文件中配置了同一个Struts2常量,则后面一个文件中配置的常量值会覆盖前面文件中配置的常量值。

struts最小依赖包

以struts-2.3.24.1版本为例,struts的最小依赖包的位于:struts-2.3.24.1\apps\struts2-blank\WEB-INF\lib

上一篇:web magic 小结


下一篇:Java编程思想笔记(第二章)