struts-config.xml配置文件 学习

 

• Struts的核心是struts-config.xml配置文件，本文详细描述了所有的Struts组件。
• 首先研讨一下org.apache.struts.config包,在struts应用启动的时候会把Struts配置文件信息读取到内存中,并把它们存 放在config包中相关的JavaBean类的实例中.包中的每一个类都和struts配置文件中特定的配置元素对应,ModuleConfig在 Struts框架中扮演了十分重要的角色,它是整个config包的核心,在Struts运行时来存放整个应用的配置信息.如果有多个子应用都会有一个 ModuleConfig对象,它和Struts文件根元素的<struts-config>对应.根元素中包含<form- bean><action><forward>等元素.
• 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-exceptions>
  •           <exception/>
    
  •     </global-exceptions>
  •    <global-forwards>
  •           <forward />
  •    </global-forwards>
  •    <action-mappings>
  •          <action />
  •    </action-mappings>
  •    <controller />
  •    <message-resources />
  •    <plug-in />
  • </struts-config>
• 
  
• • 注意，上面宏观结构中各个元素的顺序是非常重要的，每个struts.config.xml配置文件必须依照上面的结构顺序进行配置，否则在启动容器的时候就会报错。
  • 下面就struts.config.xml配置文件中的各个元素进行学习。
• • 1.      配置JDBC数据源
  • <data.sources>元素:用来配置应用所需要的数据源,数据源负责创建和特定的数据库的连接.许多数据源采用连接池的机制实现.以便提高数据库访问的性能。JAVA语言提供了javax.sql.DataSource接口，所有的数据源都必须实现这个接口。许多应用服务器和Web服务器都提供了数据源组件。很多数据库厂商也提供了数据源的实现.<data.sources>元素包含多个<data.source>子元素永远配置特定的数据源.他们可以包含多个<set-property>子元素用于设置数据源的各种属性.配置了数据源以后,就可以在Action类中访问数据源,在Action中定义了getDataSource(HttpRequest)方法,用于获取数据源对象的引用.然后可以利用DataSource对象调用getConnection获取一个连接对象对数据库进行操作.在配置文件中声明多个数据源的时候需要为每一个数据源分配唯一的Key值,通过这个来表示特定的数据源.获取特定的数据源的时候可以用dataSource = getDataSource(reqeust,”A”);
  • 其配置形式如下：
  • <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-sources>
  •     <data-source>
  •         <set-property property=”key” value=” value="WILEY_DATA_SOURCE" />          //Key    绑定在ServletContext上的DataSource实例的索引键，若不设定则缺省为Action.DATA_SOURCE_KEY，如果在应用程序中有多于一个的DataSource，则必须设置Key的值
  •         <set-property property="driverClass" value="org.gjt.mm.mysql.Driver" />       //DriverClass    所用的JDBC驱动类(必须的)如：com.microsoft.jdbc.sqlserver.SQLServerDriver
  •         <set-property property="url" value="jdbc:mysql://localhost/wileyusers" />            //url    所用的JDBC的URL(必须的)如：jdbc:microsoft:sqlserver://xg088:1433
  •         <set-property property="maxCount" value="5"/>              //MaxCount    同时打开的最大连结数，缺省值为2(可选的)
  •         <set-property property="minCount" value="1"/>                                 //MinCount    同时打开的最小连结数，缺省值为1(可选的)
  •         <set-property property="user" value="sa"/>                     //User    连结到数据库的用户名(必须的)
  •         <set-property property="password" value="yourpassword"/>                   //Password    连结到数据库的密码(必须的)
  •     </data-source>
  • </data-sources>
  • 还有：Description    关于DataSource的描述信息(可选的)
  • ReadOnly    如果设为true，则表示该连结是只读的，缺省为false。(可选的)
  • LoginTimeout    创建连结的最大允许时间，以秒为单位。(可选的)
  • AutoCommit    如果为true，则每次execute之后会强制回滚。缺省为true。(可选的)
  • 2.      配置FormBean
  • 
    
  • <form-beans>元素:用来配置多个ActionForm,包含一个或者N个<form-bean>子元素.每个 <form-bean>元素都包含多个属性.className指定和<form-bean>匹配的类.name指定该 ActionForm的唯一标识符,这个属性是必须的以后作为引用使用.type指定ActionForm类的完整类名,这个属性也是必须的.注意包名也要加上.<form-property>是指定动态的Form的元素,以后会深入了解.
  • <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>
  • 3.配置异常处理
  • <global-exception>元素:用于配置异常处理,元素可以包含一个或者多个<exception>元素,用来设置 JAVA异常和异常处理类ExceptionHandler之间的映射.className指定和元素对应的配置类,默认的不用动.handler指定异 常处理类默认是ExceptionHandler.key指定在本地资源文件中异常的消息Key,path指定当前异常发生的时候转发的路径.scope 指定ActionMessages实例存放的范围.type指定需要处理异常类的名字,必须的.bundle指定Resource Bundle.
  •     <global-exceptions>
  •           <exception/>
  •     </global-exceptions>
  • 例子：
  •    <global-exceptions>
                        <exception key="errors.general" type="java.lang.Exception" path="/page/common/Error.jsp"/>
                </global-exceptions>
  • 4.      配置全局转发
  • <global-forwards>元素:用来声明全局转发,元素可以有一个或者N个<forward>元素组成,用于把一个逻 辑名映射到特定的URL,通过这种方法Action类或者JSP页面无需指定URL,只要指定逻辑名称就可以实现请求转发或者重定向.这样可以减少控制组 件和视图的聚合.易于维护.className对应的配置类.contextRelative如果为true表示当path属性以/开头的时候,给出的是 对应的上下文URL默认是false.name转发路径的逻辑名,必须写.path转发或者重定向的URL,必须写必须是以/开头.redirect设置 为true的时候表示执行重定向操作,此项为false的时候,表示执行请求转发操作.重定向与请求转发的区别以后就是重定向是把请求生成应答给客户端然 后在重新发送给定向的URL,浏览器地址栏会有显示.而转发就是直接把请求转发给本应用的另一个文件,不生成应答所以客户端IE没显示.
  • 全局转发可以定义几个<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>
  • 5.       配置<action-mappings>
  • <action-mapping>元素:包含一个或者N个<action>元素,描述了从特定的请求路径到响应的Action的映射.在<action>元素中可以包含多个<exception>和<forward>子元素,他们分别配置局部异常处理和局部转发.attribute设置Action关联的ActionForm在request或者session范围内的key.就是在 request或者session共享内的名称.className对应配置元素的类.默认的是ActionMapping.forward指定转发 URL路径include指定包含URL路径.input指定包含表单的URL,当表单验证失败的时候发送的URL.name,指定和该Action关联 的Form名字.该名字必须是在form-bean中定义过的,可写可不写.path必须/开头的方位Action的路径.parameter指定 Action配置参数.在Action的execute()方法中可以调用ActionMapping的getParameter()方法来读取匹配的参 数.roles指定允许调用该Action的安全角色,多个角色之间逗号格开.scope指定Form的存在范围.默认是session.tyep指定 Action的完整类名.unknown如果是true表示可以处理用户发出的所有的无效的ActionURL默认是false.validate指定是 否调用ActionForm的validate方法.
  • <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-mappings>
  • <action path="/lookupAction"                          //Path    在浏览器的URL中输入的字符(必须的)
  • type="wiley.LookupAction"              //Type    连结到本映射的Action的全称(可选的)
  • name="LookupForm"                      //Name    与本操作关联的Action Bean在<form-bean/>中定义name名(可选的)
  • scope="request"                             //Scope    指定ActionForm Bean的作用域(session和request)，缺省为session。(可选的)
  • validate="true"                                //Validate    若为true，则会调用ActionForm的validate()方法，否则不调用，缺省为true。（可选的）
  • input="/index.jsp">                          //Input    当Bean发生错误时返回的控制。(可选的)
  • <forward name="success" path="/quote.jsp"/>             //Forward    指定处理相应请求所对应的JSP页面。(可选的)
  • <forward name="faliue" path="/index.jsp"/>
  • </action>
  • </action-mappings>