文档库

最新最全的文档下载
当前位置:文档库 > struts-config.xml配置详解

struts-config.xml配置详解

Struts-config.xml配置文件讲解

〖作者:不详〗〖大小:1k 〗〖发布日期:2005-08-22 〗〖浏览:1388 〗

Struts的核心是struts-config.xml配置文件,在这个文件里描述了所有的Struts组件。

在这里包括配置主要的组件及次要的组件,下面是struts-config.xml包含主要元素的内容:

一、 struts-config.xml的主要元素:

"http://www.wendangku.net/doc/cfa2d184ec3a87c24028c4b4.html/struts/dtds/struts-config_1_1.dtd">

struts-config.xml配置详解

struts-config.xml配置详解

注意:以上各元素的顺序是非常重要的,你的struts-config.xml配置文件必须按照这个顺序进行配置,否则在你的容器启动的时候就会出错。

二、 struts-config.xml的子元素:

1.子元素

它包含,它的作用是图形化其父元素,

的内容是一个16x16的图像文件,而的内容是一个32x32的图像文件。如下例子:

/images/smalllogo.gif

/images/largelogo.gif

2.子元素

它提供对父元素的短文字(short textual)描述信息,如下:

short textual discription of its parent element

3.子元素

它提供对父元素的完全(full-length textual)的描述信息,如下:

full-length textual discription of its parent element

4.子元素

它用来设置它的父元素中设定的JavaBean的属性值,它一般用在指定的GenericDataSource 属性,

扩展的ActionMappings以及扩展的 global forwards。如下:

例如:

三、配置JDBC数据源

其配置形式如下:

的属性及其描述信息如下:

属性描述信息

Key 绑定在ServletContext上的DataSource实例的索引键,

若不设定则缺省为Action.DATA_SOURCE_KEY,如果在应用程序中有多于一个的DataSource,

则必须设置Key的值。

DriverClass 所用的JDBC驱动类(必须的)如:com.microsoft.jdbc.sqlserver.SQLServerDriver

url 所用的JDBC的URL(必须的)如:jdbc:microsoft:sqlserver://xg088:1433

MaxCount 同时打开的最大连结数,缺省值为2(可选的)

MinCount 同时打开的最小连结数,缺省值为1(可选的)

User 连结到数据库的用户名(必须的)

Password 连结到数据库的密码(必须的)

Description 关于DataSource的描述信息(可选的)

ReadOnly 如果设为true,则表示该连结是只读的,缺省为false。(可选的)

LoginTimeout 创建连结的最大允许时间,以秒为单位。(可选的)

AutoCommit 如果为true,则每次execute之后会强制回滚。缺省为true。(可选的)

举例说明:

四、配置FormBean

用来定义将要绑定到Action的FormBean的实例。语法如下:

type=”fully qualified class name of FormBean"/>

例:

五、配置全局转发

全局转发可以定义几个子元素,struts首先会在元素中找对应的,若找不到,则到全局转发配置中找。语法如下:

除了name及path属性之外,还有一个redirect属性,如果redirect设为true的时候,则用

HttpServletResponse.sendRedirect()方法,否则用RequestDispatcher.forward()方法,缺省为false。

注:如果为true,则用HttpServletResponse.sendRedirect()方法,此时存储在原来的HttpServletRequest中

的值将会丢失。

例子:

六、配置

它可以定义几个子元素,它主要是定义Action实例到ActionServlet类中,语法如下:

type="fully qualified class name of the Action class"

name="the name of the form bean bound to this Action">

属性及其描述信息如下:

属性描述信息

Path 在浏览器的URL中输入的字符(必须的)

Type 连结到本映射的Action的全称(可选的)

Name 与本操作关联的Action Bean在中定义name名(可选的)

Scope 指定ActionForm Bean的作用域(session和request),缺省为session。(可选的)

Input 当Bean发生t误时返回的控制。(可选的)

ClassName 指定一个调用这个Action类的ActionMapping类的全名。缺省用

org.apache.struts.action.ActionMapping,(可选的)

Forward 指定处理相应请求所对应的JSP页面。(可选的)

Include 如果没有forward的时候,它起forward的作用。(可选的)

Validate 若为true,则会调用ActionForm的validate()方法,否则不调用,缺省为true。(可选的)

例子:

scope="request"

validate="true"

input="/index.jsp">

七、配置RequestProcessor

在struts-config.xml文件中用子元素来定义RequestProcessor,其语法格式如下:

元素属性及其描述信息如下:

属性描述

processorClass 指定自定义的RequestProcessor类的全名

BufferSize 指定用来下载所用的缓存大小。缺省是4096字节。

contentType 定义response文本类型,缺省是text/html

Debug 定义当前系统的除错级别,缺省是0

Locale 如果是true,则在用户的session中存放Locale对象,缺省为true

maxFileSize 指定下载文件最大的大小。缺省是250M

multipartClass 指定去代替org.apache.struts.upload.DiskMultipartRequestHandler类的类的全名。Nocache 如果是true,则会关闭每个response的缓存功能。缺省是false

TempDir 指定上载文件所用的临时目录。缺省值由容器决定

例子:

contentType="text/html;charset=UTF-8"

debug="3"

locale="true"

nocache="true"

processorClass="org.apache.struts.action.RequestProcessor"/>

八、配置Message Resources

在struts-config.xml文件中用元素来定义消息资源。其语法如下:

元素属性及其描述信息如下:

属性描述

Parameter 给定资源文件全名

ClassName 定义处理消息资源的类名的全名,缺省是org.apache.struts.config.MessageResourcesConfig Factory 定义MessageResourcesFactory类的全名,缺省是

org.apache.struts.util.property.MessageResourcesFacotry

Key 定义绑定在这个资源包中的ServletContext的属性主键,缺省值是Action.MESSAGES_KEY.

Null 如果为true,则找不到消息key时,则返回null,缺省是true.

例子:

parameter="StorefrontMessageResources"

null="false"/>

key="IMAGE_RESOURCE_KEY"

parameter="StorefrontImageResources"

null="false"/>

注意:设定key的目的如下:

pageKey="navbar.home.image" width="125" height="15" border="0"/>

这里说明要到StorefrontImageResources.properties资源文件中找主键值是”navbar.home.image”所对应的

值。

这里StorefrontImageResources.properties的内容如下:

……

navbar.home.image=/images/home.gif

navbar.home.image.alt=Home

……

此处navbar.home.image.alt说明的和”Home”……/一样。

九、配置Plug-in

配置Plug-in如下:

也可如下: