struts-config.xml文件

Struts-config.xml学习笔记
作者: ∣来源:JavaResearch∣原文地址∣2005-5-19

1.    Struts-config.xml的每个部分的配置规范主要由该xml文件所使用的DTD文件决定。所使用的DTD版本在文件头部分,所以看DTD是了解该配置文件的最好起点。如:

不同的版本所定义的元素和属性不同。
2.    Struts-config.xml文件中的参数是次序相关的,所以需要将子元素按正确的顺序放置。不过系统会根据DTD文件生成一个按序排列的模板。
3.    一般主要包括以下几个部分:
(1)    data-sources
(2)    form-bean
(3)    global-forwards
(4)    action-mapping
(5)    message-resource

4.    Struts-config.xml文件DTD的一部分
global-exceptions?,global-forwards?,
action-mappings?,controller?,
messages-resources,plug-in)>
    实际上,DTD只有两种项:  ELEMENT和ATTLIST. ELEMENT是用来描述XML文件的总体语法(元素的名字是什么、它的内部可以包含哪些标记),而ATTLIST值定义了标记可包括的属性。
,subtags是其他ELEMENT项的引用。
Subtag后跟一个“?”表示父标记中可以包括一个或者零个这样的标记。如果在标记名后面跟一个星号,表示父标记中可以包括多个或零个这样的标记。没有跟符号,表示有且仅有一个标记可以放到父标记中,此外,标记的顺序是非常重要的,标记出现的次序必须符合他们在列表中的定义。
    属性ATTLIST可以以任意次序出现。他有四个参数:标记名;属性名;属性的类型;默认值。字符串“IMPLED”意味着属性值不是必须的。“REQUIRED”意味着基于该DTD的XML无论在何种情况下都应该提供这个属性。
5.    表单Bean(form-bean)
form-beans和form-bean标记被用来告知struts,ActionForn类与哪个唯一标识相关联,他还可以用来定义动态form-DynaForm.
例;Form-bean DTD
<!ELEMENT form-beans (form-bean*)>

<!ELEMENT form-bean (icon?, display-name?, description?,
set-property*, form-property*)>
   
   
   
   
   

    <!ELEMENT form-property (set-property*)>
   

   
   


   

form-beans子句:

   
   
   
   
    ……


   

6.Action映射(action-mappings)
    Struts使用action标记来将表单、aciton以及转发连接在一起。他们被捆绑在action-mappings之内。

Action-mapping的DTD如:
   



















Action标记:
   
       
       
                        type=”stocktrack.struts.action.newAccountAction”
name=”blankForm”  /*Bean Name
scope=”request”
input=”/home.jsp” >  /*ReuestPath
            path=”/newUserName.jsp” /> /*ReauestPath
       

                            type=” stocktrack.struts.action.LoginAction”
name=”loginForm”
scope=”request”
input=”/home.jsp” />

    属性path被用于同action的请求相匹配,action的路径应该没有任何后缀。如,在表单中指定action=”/my/regist.do”,他将匹配path为/my/regist;
    属性forward和include可以用来将控制权直接传递到新路径,而不是直接处理action。通过指定他的路径,属性input允许将action属性重定向回用以输入表单值的表单;
    属性name用于指定FormBean的名字;
    属性forward,exception和set-property标记可以在action的内部局部使用;他们归属与所定义的action。Set-property标记对于“向action传递信息”非常有用。例如,如果一个单独的action类可被用来处理若干不同的表单,可以使用set-property标记来告诉action要处理的是哪一个表单
7.    Struts-config.xml与struts其它元素的相互连接
可以从jsp页面的角度开始考虑。当页面使用带有action属性的标记时,
使用该属性从config文件中找到相应的标记。这个标记接下来定义了表单类,他允许jsp页面使用以及其他表单输入标记和表单bean相关联;还有action类,用来处理验证之后的结果。

Struts标记
Struts标记是一组定制的jsp自定义标记,由struts的作者开发,能够简化jsp开发者的工作。
(一)    struts html标记 页面构造和表单处理
这些标记被用来在jsp文件中产生html元素、协调表单处理、并将jsp页面(view组建)链接到strut框架的其他部分。

使用struts html标记渲染html基本元素:
--渲染HTML元素
--渲染HTML元素
用来帮助浏览器正确的组成路径;
--渲染HTML锚点标记元素
可以在URL中传递参数,或当用户的cookies被禁止时,用来维护会话的状态。
--仅渲染标记中的URL部分

--渲染HTML元素

 

-------------------------------------------------------------------------------------------------------------------------------------

 

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

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

"http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd">

   
   
       
       

   


   
       
   


   
       
   


   
       
   


   

   

   


注意:以上各元素的顺序是非常重要的,你的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。如下:
                  property="name of bean property"       
value="value of bean property" />
         例如:
         
        
        




三、    配置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首先会在元素中找对应的,若找不到,则到全局转发配置中找。语法如下:

path="context-relative path to targetted resource "/>

除了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">

你可能感兴趣的:(Java)