Struts-config.xml配置文件讲解

官方配置文件说明：贴个Struts 1.1版本的online地址（比较久远了）与本文内容无关

http://struts.apache.org/1.1/userGuide/configuration.html

 

Struts的核心是struts-config.xml配置文件，在这个文件里描述了所有的Struts组件。 
在这里包括配置主要的组件及次要的组件，下面是struts-config.xml包含主要元素的内容： 

一、    struts-config.xml的主要元素：
 
<? xml version=”1.0” encoding=”ISO-8859-1” ?>  
<! DOCTYPE struts-config PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 1.1//EN" 
"http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd" >  
< struts-config >  
    < data-sources >  
        < data-source >  
        </ data-source >  
    </ data-sources >  
    < form-beans >  
        < form-bean  /  >  
    </ form-beans >  
    < global-forwards >  
        < forward  /  >  
    </ global-forwards >  
    < action-mappings >  
        < action  /  >  
    </ action-mappings >    
< controller  /  >  
    < message-resources  /  >  
    < plug-in  />  
</ struts-config >  

    注意：以上各元素的顺序是非常重要的，你的struts-config.xml配置文件必须按照这个顺序进行配置，否 

则在你的容器启动的时候就会出错。 

二、    struts-config.xml的子元素： 
1． < icon  /  > 子元素 
   它包含 < small-icon  /  > 及 < large-icon  /  > ，它的作用是图形化其父元素， 
< small-icon /> 的内容是一个16x16的图像文件，而 < large-icon /> 的内容是一个32x32的图像文件。如下例子： 
    < icon >  
      < small-icon >  
         /images/smalllogo.gif 
      </ small-icon >  
      < large-icon >  
        /images/largelogo.gif 
      </ large-icon >  
</ icon >  
2． < display-name  /  > 子元素 
   它提供对父元素的短文字（short textual）描述信息，如下： 
    < display-name >  
           short textual discription of its parent element 
    </ display-name >  
3． < description  /  > 子元素 
   它提供对父元素的完全（full-length textual）的描述信息，如下： 
   < description >  
    full-length textual discription of its parent element 
   </ description >  
4． < set-property  /  > 子元素 
       它用来设置它的父元素中设定的JavaBean的属性值，它一般用在指定的GenericDataSource 属性， 
扩展的ActionMappings以及扩展的 global forwards。如下： 
        < set-property  property ="name of bean property"  value ="value of bean property"   />  
         例如： 
         < set-property  property ="driverClass"  value ="org.gjt.mm.mysql.Driver"   />  
         < set-property  property ="user"  value ="admin" />  
         < set-property  property ="maxCount"  value ="4" />  
         < set-property  property ="minCount"  value ="2" />   
         < set-property  property ="password"  value ="" />   
         < set-property  property ="url"  value ="jdbc:mysql://localhost:3306/struts" />  

三、    配置JDBC数据源 

其配置形式如下：
 
< data-sources >  
< data-source >  
< set-property  property ="driverClass"  value ="fully qualified path of JDBC driver" />  
< set-property  property ="url"  value ="data source URL" />  
< set-property  property =”mincount”  value ="the minimum number of connections to open" />  
< set-property  property ="password"  value ="the password used to create connections" />  
< set-property  property ="user"  value ="the username used to create connections" />  
</ data-source >  
</ data-sources >  

< data-source > 的属性及其描述信息如下： 
属  性              描 述 信 息 
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。(可选的) 


举例说明： 

< data-sources >  
< data-source >  
< set-property  property =”key”  value =”  value ="WILEY_DATA_SOURCE"   />  
< set-property  property ="driverClass"  value ="org.gjt.mm.mysql.Driver"   />  
< set-property  property ="url"  value ="jdbc:mysql://localhost/wileyusers"   />  
< set-property  property ="maxCount"  value ="5" />  
< set-property  property ="minCount"  value ="1" />  
< set-property  property ="user"  value ="sa" />  
< set-property  property ="password"  value ="yourpassword" />  
</ data-source >  
</ data-sources >  

四、    配置FormBean 
< form-bean  /  > 用来定义将要绑定到Action的FormBean的实例。语法如下： 
  < form-beans >  
     < form-bean  name ="name used to uniquely identify a FormBean"  
            type =”fully  qualified class name of FormBean" />  
  </ form-beans >  
例： 
< form-beans >  
     < form-bean  name ="lookupForm"  type ="wiley.LookupForm"   />  
</ form-beans >  

五、    配置全局转发 
   全局转发可以定义几个 < forward /> 子元素，struts首先会在 < action-mappings > 元素中找对应的 < forward > ， 

若找不到，则到全局转发配置中找。语法如下： 
< global-forwards >  
   < forward  name ="unique target identifier"  path ="context-relative path to targetted resource " />  
</ global-forwards >  
   除了name及path属性之外，还有一个redirect属性，如果redirect设为true的时候，则用 

HttpServletResponse.sendRedirect()方法，否则用RequestDispatcher.forward()方法，缺省为false。 
注：如果为true，则用HttpServletResponse.sendRedirect()方法，此时存储在原来的HttpServletRequest中 

的值将会丢失。 
例子： 
< global-forwards >  
< forward  name ="success"  path ="/welcome.jsp" />  
< forward  name ="failure"  path ="/index.jsp" />  
</ global-forwards >  
六、    配置 < action-mappings >  
   它可以定义几个 < action  /  > 子元素，它主要是定义Action实例到ActionServlet类中，语法如下： 
< action-mappings >  
  < action  path ="context-relative path mapping action to a request"  
   type ="fully qualified class name of the Action class"  
   name ="the name of the form bean bound to this Action" >  
    < forward  name ="forwardname1"  path ="context-relative path" />  
    < forward  name ="forwardname2"  path ="context-relative path" />  
  </ action >  
</ action-mappings >  
< action /> 属性及其描述信息如下： 
属  性    描 述 信 息 
Path    在浏览器的URL中输入的字符(必须的) 
Type    连结到本映射的Action的全称(可选的) 
Name    与本操作关联的Action Bean在 < form-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。（可选的） 
例子： 
< action-mappings >  
< action  path ="/lookupAction"  type ="wiley.LookupAction"  name ="LookupForm"  
  scope ="request"  
  validate ="true"  
  input ="/index.jsp" >  
< forward  name ="success"  path ="/quote.jsp" />  
< forward  name ="faliue"  path ="/index.jsp" />  
</ action >  
</ action-mappings >  

七、    配置RequestProcessor 
    在struts-config.xml文件中用 < controller /> 子元素来定义RequestProcessor，其语法格式如下： 
< controller  processorClass ="fully qualified class name"   />  
< controller  /> 元素属性及其描述信息如下： 
属  性    描  述 
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    指定上载文件所用的临时目录。缺省值由容器决定 
例子： 
①  < controller  processorClass ="wiley.WileyRequestProcessor"   />  
②  < controller 
     contentType ="text/html;charset=UTF-8"  
    debug ="3"  
    locale ="true"  
    nocache ="true"  
    processorClass ="org.apache.struts.action.RequestProcessor" />  

八、    配置Message Resources 
    在struts-config.xml文件中用 < message-resources  /> 元素来定义消息资源。其语法如下： 
        < message-resources   parameter ="wiley.ApplicationResources" />  
< message-resources  /> 元素属性及其描述信息如下： 
属  性    描  述 
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. 
例子： 
①  < message-resources  parameter ="wiley.ApplicationResources" />  
②  < message-resources 
     parameter ="StorefrontMessageResources"  
    null ="false" />  
< message-resources 
     key ="IMAGE_RESOURCE_KEY"  
    parameter ="StorefrontImageResources"  
    null ="false" />  
注意：设定key的目的如下： 
< html:img  altKey ="navbar.home.image.alt"  bundle ="IMAGE_RESOURCE_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说明的和 < img  alt =”Home”……/>一样。 

九、    配置Plug-in 
配置Plug-in如下： 
<plug-in className ="wiley.WileyPlugin" />  
也可如下： 
< plug-in  className ="com.oreilly.struts.storefront.service.memory.StorefrontMemoryDatabasePlugIn" >  
   < set-property  property ="pathname"  value ="/WEB-INF/database.xml" />  
</ plug-in >