struts-config.xml的详细配置
?
以下是一份完整的struts-config.xml文件,配置元素的说明详见注释.
?
?
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE struts-config PUBLIC"-//Apache Software Foundation//DTD Struts Configuration 1.1//EN""http://jakarta.apache.org/struts/dtds/struts-config.dtd"><!-- struts-config.xml中的元素必须按照上述doc指令中的dtd文档定义顺序书写，本例即遵从了dtd定义顺序 --><!-- struts-config是整个xml的根元素，其他元素必须被包含其内 --><struts-config><!--名称:data-sources描述：data-sources元素定义了web App所需要使用的数据源数量：最多一个子元素:data-source--><data-sources><!--名称：data-source描述：data-source元素定义了具体的数据源数量：任意多个属性：@key：当需要配置多个数据源时，相当于数据源的名称，用来数据源彼此间进行区别@type：可以使用的数据源实现的类，一般来自如下四个库Poolman，开放源代码软件Expresso，JcorporateJDBC Pool，开放源代码软件DBCP，Jakarta--><data-source key="firstOne" type="org.apache.commons.dbcp.BasicDataSource"><!--名称：set-property描述：用来设定数据源的属性属性：@autoCommit:是否自动提交 可选值：true/false@description:数据源描述@driverClass:数据源使用的类@maxCount:最大数据源连接数@minCount:最小数据源连接数@user:数据库用户@password:数据库密码@url:数据库url--><set-property property="autoCommit" value="true"/><set-property property="description" value="Hello!"/><set-property property="driverClass" value="com.mysql.jdbc.Driver"/><set-property property="maxCount" value="10"/><set-property property="minCount" value="2"/><set-property property="user" value="root"/><set-property property="password" value=""/><set-property property="url" value="jdbc:mysql://localhost:3306/helloAdmin"/></data-source></data-sources><!--名称：form-beans描述：用来配置多个ActionForm Bean数量：最多一个子元素：form-bean--><form-beans><!--名称：form-bean描述：用来配置ActionForm Bean数量：任意多个子元素：form-property属性：@className：指定与form-bean元素相对应的配置类，一般默认使用org.apaceh.struts.config.FormBeanConfig，如果自定义，则必须继承 FormBeanConfig@name：必备属性！为当前form-bean制定一个全局唯一的标识符，使得在整个Struts框架内，可以通过该标识符来引用这个ActionForm Bean。@type：必备属性！指明实现当前ActionForm Bean的完整类名。--><form-bean name="Hello" type="myPack.Hello"><!--名称：form-property描述：用来设定ActionForm Bean的属性数量：根据实际需求而定，例如，ActionForm Bean对应的一个登陆Form中有两个文本框，name和password，ActionForm Bean中也有这两个字段，则此处编写两个form-property来设定属性属性：@className：指定与form-property相对应的配置类，默认是org.apache.struts.config.FormPropertyConfig，如果自定义，则必须继承FormPropertyConfig类@name：所要设定的ActionForm Bean的属性名称@type：所要设定的ActionForm Bean的属性值的类@initial：当前属性的初值--><form-property name="name" type="java.lang.String"/><form-property name="number" type="java.lang.Iteger" initial="18"/></form-bean></form-beans><!--名称：global-exceptions描述：处理异常数量：最多一个子元素：exception--><global-exceptions><!--名称：exception描述：具体定义一个异常及其处理数量：任意多个属性：@className:指定对应exception的配置类，默认为org.apache.struts.config.ExceptionConfig@handler:指定异常处理类，默认为org.apache.struts.action.ExceptionHandler@key:指定在Resource Bundle种描述该异常的消息key@path:指定当发生异常时，进行转发的路径@scope:指定ActionMessage实例存放的范围，默认为request，另外一个可选值是session@type:必须要有！指定所需要处理异常类的名字。@bundle:指定资源绑定--><exceptionkey=""hello.errorpath="/error.jsp"scope="session"type="hello.HandleError"/></global-exceptions><!--名称：global-forwards描述：定义全局转发数量：最多一个子元素：forward--><global-forwards><!--名称：forward描述：定义一个具体的转发数量：任意多个属性：@className:指定和forward元素对应的配置类，默认为org.apache.struts.action.ActionForward@contextRelative:如果为true，则指明使用当前上下文，路径以“/”开头，默认为false@name:必须配有！指明转发路径的唯一标识符@path:必须配有！指明转发或者重定向的URI。必须以"/"开头。具体配置要与contextRelative相应。@redirect:为true时，执行重定向操作，否则执行请求转发。默认为false--><forward name="A" path="/a.jsp"/><forward name="B" path="/hello/b.do"/></global-forwards><!--名称：action-mappings描述：定义action集合数量：最多一个子元素：action--><action-mappings><!--名称：action描述：定义了从特定的请求路径到相应的Action类的映射数量：任意多个子元素：exception,forward（二者均为局部量）属性：@attribute:制定与当前Action相关联的ActionForm Bean在request和session范围内的名称（key）@className:与Action元素对应的配置类。默认为org.apache.struts.action.ActionMapping@forward:指名转发的URL路径@include:指名包含的URL路径@input:指名包含输入表单的URL路径，表单验证失败时，请求会被转发到该URL中@name:指定和当前Acion关联的ActionForm Bean的名字。该名称必须在form-bean元素中定义过。@path:指定访问Action的路径，以"/"开头，没有扩展名@parameter:为当前的Action配置参数，可以在Action的execute()方法中，通过调用ActionMapping的getParameter()方法来获取参数@roles:指定允许调用该Aciton的安全角色。多个角色之间用逗号分割。处理请求时，RequestProcessor会根据该配置项来决定用户是否有调用该Action的权限@scope:指定ActionForm Bean的存在范围，可选值为request和session。默认为session@type:指定Action类的完整类名@unknown:值为true时，表示可以处理用户发出的所有无效的Action URL。默认为false@validate:指定是否要先调用ActionForm Bean的validate()方法。默认为true注意：如上属性中，forward/include/type三者相斥，即三者在同一Action配置中只能存在一个。--><action path="/search"type="addressbook.actions.SearchAction"name="searchForm"scope="request"validate="true"input="/search.jsp"><forward name="success" path="/display.jsp"/></action></action-mappings><!--名称：controller描述：用于配置ActionServlet数量：最多一个属性：@bufferSize:指定上传文件的输入缓冲的大小.默认为4096@className:指定当前控制器的配置类.默认为org.apache.struts.config.ControllerConfig@contentType:指定相应结果的内容类型和字符编码@locale:指定是否把Locale对象保存到当前用户的session中,默认为false@processorClass:指定负责处理请求的Java类的完整类名.默认org.apache.struts.action.RequestProcessor@tempDir:指定文件上传时的临时工作目录.如果没有设置,将才用Servlet容器为web应用分配的临时工作目录.@nochache:true时,在相应结果中加入特定的头参数:Pragma ,Cache-Control,Expires防止页面被存储在可数浏览器的缓存中,默认为false--><controllercontentType="text/html;charset=UTF-8"locale="true"processorClass="CustomRequestProcessor"></controller><!--名称:message-resources描述:配置Resource Bundle.数量:任意多个属性:@className:指定和message-resources对应的配置类.默认为org.apache.struts.config.MessageResourcesConfig@factory:指定资源的工厂类,默认为org.apache.struts.util.PropertyMessageResourcesFactory@key:@null:@parameter:--><message-resourcesnull="false"parameter="defaultResource"/><message-resourceskey="images"null="false"parameter="ImageResources"/><!--名称:plug-in描述:用于配置Struts的插件数量:任意多个子元素:set-property属性:@className:指定Struts插件类.此类必须实现org.apache.struts.action.PlugIn接口--><plug-inclassName="org.apache.struts.validator.ValidatorPlugIn"><!--名称:set-property描述:配置插件的属性数量:任意多个属性:@property:插件的属性名称@value:该名称所配置的值--><set-propertyproperty="pathnames"value="/WEB-INF/validator-rules.xml,/WEB-INF/vlaidation.xml"/></plug-in></struts-config>
