---
title: "Structs中基本配置入门"
author: "fanjava"
date: "2005-08-05T07:46:00Z"
tags: []
slug: "structs"
draft: false
lastmod: "2005-08-05T07:46:00Z"
id: 601698
url: "https://fanjava.iteye.com/blog/601698"
---

第一章Structs的基本配置  
1.为Structs应用配置Web.xml文件  
第一步:配置ActionServlet  
&lt;servlet&gt;  
&lt;servlet-name&gt;action&lt;/servlet-name&gt;  
&lt;servlet-class&gt;org.appache.structs.ActionServlet&lt;/servlet-class&gt;  
&lt;/servlet&gt;

&lt;servlet-mapping&gt;  
&lt;servlet-name&gt;action&lt;/servlet-name&gt;  
&lt;uri-pattern&gt;\*.do&lt;/url-pattern&gt;  
&lt;/servlet-mapping&gt;  
注意:不管应用中包含多少个子应用,都只需配置一个ActionServlet,因为ActionServlet支持多线程,目前的Structs框架只允许在应用中配置一个ActionServlet。  
第二步：初始化参数对Servlet的运行环境进行初始化配置。  
&lt;servlet&gt;  
&lt;servlet-name&gt;action&lt;/servlet-name&gt;  
&lt;servlet-class&gt;org.appache.structs.ActionServlet&lt;/servlet-class&gt;  
&lt;init-param&gt;  
&lt;param-name&gt;config&lt;/param-name&gt;  
&lt;param-value&gt;/WEB-INF/structs-config.xml&lt;/param-value&gt;  
&lt;/init-param&gt;  
&lt;/servlet&gt;  
表2-1.Struts1.1中用到的初始化参数  
参数名含义/默认值  
config以相对路径的方式指明Struts应用程序的配置文件位置。如不设置，则默认值为/WEB-INF/struts-config.xml。  
config/sub1以相对路径的方式指明子应用程序的配置文件位置，一般来说，很少用到子应用程序，在此不多描述。  
debug设置Servlet的debug级别，控制日志记录的详细程度。默认为0，记录相对最少的日志信息。  
detail设置Digester的debug级别，Digester是Struts框架所使用的用来解析xml配置文件的一个框架，通过该设置，可以查看不同详细等级的解析日志。默认为0，记录相对最少的日志信息。

第三步：配置欢迎清单  
当客户访问Web应用时，如果仅仅给出Web应用的RootURL，没用指定具体的文件名，Web容器会自动调用Web应用的欢迎文件。  
&lt;welcome-file-list&gt;  
&lt;welcome-file&gt;welcome.jsp&lt;/welcome-file&gt;  
&lt;welcome-file&gt;index.jsp&lt;/welcome-file&gt;  
&lt;/welcome-fiel-list&gt;  
说明：&lt;welcome-file-list&gt;可以包含多个&lt;welcome-file&gt;子元素，首先查找第一个&lt;welcome-file&gt;文件。  
由于&lt;welcome-file-list&gt;元素中不能配置Servlet映射，因此不能直接把Structs的Action作为欢迎文件，可以采用一种变通的方法来实现在欢迎文件中调用StructsAction。首先，在Structs配置文件中为被调用的Action创建一个全局的转发项，例如：  
&lt;global-forwards&gt;  
&lt;forwardname=”welcome”path=”HelloWord.do”/&gt;  
&lt;/global-forwords&gt;  
创建一个welcome.jsp的文件  
最后在web.xml文件中把welcome.jsp文件配置为欢迎文件，代码如下：  
&lt;welcome-file-list&gt;  
&lt;welcome-file&gt;welcome.jsp&lt;/welcome-file&gt;  
&lt;/welcome-file-list&gt;  
第四步：配置错误处理

&lt;error-page&gt;  
&lt;error-code&gt;404&lt;/error-code&gt;  
&lt;location&gt;/commom/404.jsp&lt;/location&gt;  
&lt;/error-page&gt;  
&lt;error-page&gt;  
&lt;error-code&gt;505&lt;/error-code&gt;  
&lt;location&gt;/commom/505.jsp&lt;/location&gt;  
&lt;/error-page&gt;  
也可以为Web容器捕获的Java异常配置&lt;error-page&gt;,需要设置&lt;exception-type&gt;子元素，它用于指定Java异常类。Web容器可能捕获如下异常：  
RuntimeException或ErrorServletException或它的子类IOException或它的子类  
&lt;error-page&gt;  
&lt;exception-type&gt;java.io.IOException&lt;/exception-type&gt;  
&lt;location&gt;/common/system\_ioerror.jsp&lt;/location&gt;  
&lt;/error-page&gt;  
第五步：配置Structs标签库  
使用客户化的标签库，要配置它们  
&lt;taglib&gt;  
&lt;tag-uri&gt;/WEB-INF/structs-html.tld&lt;tag-uri&gt;  
&lt;taglib-location&gt;/WEB-INF/structs-html.tld&lt;/taglib-location&gt;  
&lt;/taglib&gt;  
&lt;tag-uri&gt;用于指定标签库的相对或者绝对URI地址，Web应用根据这一URI来访问标签库。  
&lt;taglib-location&gt;指定标签描述文件在文件资源系统中的物理位置。  
2Structs配置文件  
Structs框架在启动时会读入其配置文件，根据它来创建和配置各种Structs组件。  
1&lt;Structs-config&gt;元素  
&lt;structs-config&gt;元素是Structs配置文件的根元素，&lt;structs-cofig&gt;元素有8个子元素。它的DTD定义如下：  
&lt;!ELEMENTstructs-config(data-sources?,formbean?,global-exeception?,global-forward?,action-mapping,controller?,message-resources\*,plug-in\*)&gt;  
在Struts配置中，必须按照以上的DTD指定的先后顺序来配置&lt;Structs-config&gt;元素的各个子元素，如果颠倒了这些元素的配置文件中的位置，在Structs应用启动时会生成错误。  
&lt;data-sources&gt;元素

&lt;data-sources&gt;元素包含零个、一个或者多个&lt;data-sources&gt;子元素，&lt;data-sources&gt;用于配置特定的数据源，它可以包含多个&lt;set-property&gt;子元素，用于设置数据源的各种属性。  
。。。  
配置了数据源后，就可以在Action类中访问数据源，在org.apache.structs.action.Action类中定义了getDataSource(HttpRequrst)方法，它用于获取数据源对象的引用。  
DataSourcedataSource;  
Connectionconnection;  
dataSource=getDataSource(request);  
connection=dataSource.getConnection();  
也可以在配置文件中声明多个数据源，此时需要为每一个数据源分配唯一的key值，通过改值来标识特定的数据源。  
2&lt;form-beans&gt;元素  
&lt;form-beans&gt;元素用来配置多个ActionFormBean，&lt;form-beans&gt;包含多个&lt;forom-bean&gt;子元素，,每个&lt;from-bean&gt;包含多个属性，ClassName,name,type  
&lt;form-beans&gt;  
&lt;form-beanname="HelloForm"type="hello.HelloForm"/&gt;  
&lt;/form-beans&gt;  
注意：配置动态ActionFormBean，还必须配置&lt;form-bean&gt;元素的&lt;form-property&gt;元素。  
&lt;form-beans&gt;  
&lt;form-beanname="HelloForm"type="hello.HelloForm"/&gt;  
&lt;form-beanname="userForm"type="org.apache.structs.action.DynaAction"&gt;  
&lt;from-propertyname="firstname"type="java.lang.String"/&gt;  
&lt;form-propertyname="secondname"type="java.lang.String"&gt;  
&lt;form-propertyname="age"type="java.Integer"initial="18"&gt;  
&lt;/form-beans&gt;  
3&lt;global-exception&gt;元素  
&lt;global-exception&gt;用于配置异常处理，&lt;global-exception&gt;元素可以包含零个或者多个&lt;exception&gt;元素。  
&lt;exception&gt;元素用来设置java异常和异常处理类org.apache.structs.action,ExceptionHander之间的映射。  
4&lt;gloable-forwards&gt;元素  
&lt;global-forwards&gt;元素用来声明全局的转发关系，&lt;global-forwards&gt;有零个或多个&lt;forward&gt;元素组成。&lt;forward&gt;元素用于把一个逻辑映射到特定的URL  
属性描述  
className和&lt;forward&gt;元素对应的配置类，默认为org.apache.structs.action.ActionForWard  
name转发路径的逻辑名，此项时必须的  
path指定或者重定向的URI。此项时必须的，必须以”/”开头  
redirect此项是true，表示是执行重定向的操作，此项是false时，表示请求转发。

&lt;global-forwards&gt;  
&lt;forwardname="forward1"path="/Action1.do"/&gt;  
&lt;forwardname="forward1"path="/Action2.do"/&gt;  
&lt;/global-forwards&gt;  
如果jsp1.jsp把请求转发给Action1,可以使用以下代码：  
&lt;html:linkforward=”forward1”&gt;  
或者&lt;logic:forwardname=”forward1”&gt;  
如果Action1的execute（）方法把请求转发给JSP2.jsp，可以使用一下代码：  
return(mapping.findForward(“forward2”))  
5&lt;action-mapping&gt;元素  
&lt;action-mapping&gt;元素包含零个或者多个&lt;action&gt;元素。&lt;action&gt;元素描述了从特定的请求路径到相应的Action类的映射。  
6&lt;controller&gt;元素  
&lt;controller&gt;元素用于配置ActionServlet。  
7&lt;message-resources&gt;元素  
&lt;message-resources&gt;元素用于配置ResourceBundle，ResourceBudle用于存放本地化消息文件。  
Structs标签  
HTML标签  
标签名描述  
base包装HTML的base元素  
button包装HTML的button类型的input元素  
cancel包装HTMLcancel按钮  
checkbox包装HTMLcheckbox类型的输入域  
errors有条件地显示一些error消息，显示ActionErrors信息  
file包装HTML文件上传输入域  
form定义HTMLform元素  
frame包装HTMLframe元素  
hidden包装HTMLhidden输入域  
html包装HTML中的html元素  
image包装"image"类型的输入域  
img包装HTML的img元素  
javascript包装根据ValidatorPlugIn提供的校验规则所提供的javascript校验脚本  
link包装超链接  
messages有条件地显示一些提示信息，显示ActionMessages信息  
multibox包装多选输入框  
option包装一个选择输入框  
options包装一批选择输入框  
optionsCollection包装一批选择输入框集  
password包装密文输入框  
radio包装单选输入框  
reset包装“重置”功能的按钮  
rewrite包装一个URL  
select包装一个选择输入框  
submit包装一个提交按钮  
text包装一个文本输入框  
textarea包装一个备注输入框

ActionForm  
ActionForm的要求  
创建一个ActionForm并不困难，但是你的类必须符合一些要求：  
ActionForm必须扩展自org.apache.struts.ActionForm。基类ActionForm是不能实  
例化的。  
ActionForm必须为每个应该从请求中收集的HTML控件定义一个公共属性。  
(Struts1.0要求每个属性都要mutator和accessor。Struts1.1则没有如此严格)  
ActionForm还可能要符合一些可选的要求:  
如果你要求ActionForm在传递属性到Action之前校验它们，你就必须实现validate  
方法；  
如果想在组装前初始化属性，必须实现reset,它在ActionForm组装前被调用；  
动态ActionForm  
ActionForm作为类型转换器  
ActionForm的一个强制点是应该使用String和boolean属性。实际上，这意味着属性  
必须得从一种转换到另一种类型。大部分应用也需要一些属性，比如电话号码或者数量，以  
一种格式化的方式出现。核心Java包提供一些工具来做这种事情，但是要清楚地将他们集  
成到应用中仍然是一个挑战。  
Struts开发人员经常在ActionForm中包含helper方法，来进行类型转换。helper方法  
可以有很多种实现方式，这我们在5.6种叙述。  
5.2.6ActionForm作为防火墙  
当请求提交时，ActionServlet使用一个自动组装机制来从请求参数中设置请求的  
ActionForm属性。这让你可以通过控制哪个ActionForm属性被暴露来控制哪个请求参数  
是可接受的。这也意味着如果你的ActionForm的粗心设计你可能失去控制哪个参数可以接  
受的能力。ActionForm一定不能包含看起来像是一个JavaBean属性，但不能从HTTP请  
求设置的属性方法。  
5.3.4ActionForm可以嵌套其它bean  
因为Struts标签扩展和自动组装机制都支持点号语法来从ActionForm访问其它  
bean。这是一个方便的方式，可以通过ActionForm来组装存在的bean。在JSP页面,你可  
以象这样引用一个嵌套的bean：  
&lt;html:text  
propety="values.telephoneText"  
size="14"  
maxlength="14"/&gt;  
5.7.2分发（Dispatch）  
Struts开发人员通常使用同一个Action处理相关的操作。一个通常做法来选择操作是在  
HTML表单中使用隐藏属性。BaseForm的dispatch属性也可用作这个目的：  
publicvoidsetDispatch(Stringdispatch);  
publicStringgetDispatch();  
Struts配置提供连个级别嵌套的ActionForward:  
Global（全局）ActionForward对整个应用中的所有Action对象均有效；  
Local（局部）ActionForward则在ActionMapping元素中定义。仅对那些在这个  
ActionMapping中调用的Action对象有效。  
从Action对象内部来看，forward通常像这样来选择：  
ActionForwardforward=mapping.findForward("continue");