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

<servlet-mapping>
??? <servlet-name>action</servlet-name>
??? <uri-pattern>*.do</url-pattern>
</servlet-mapping>
注意:不管应用中包含多少个子应用,都只需配置一个ActionServlet,因为ActionServlet支持多线程,目前的Structs框架只允许在应用中配置一个ActionServlet。
第二步：初始化参数对Servlet的运行环境进行初始化配置。
<servlet>
??? <servlet-name>?action</servlet-name>
??? <servlet-class>?org.appache.structs.ActionServlet?</servlet-class>
??? <init-param>
<param-name>config</param-name>
<param-value>/WEB-INF/structs-config.xml</param-value>
</init-param>
? </servlet>
表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应用的Root?URL，没用指定具体的文件名，Web容器会自动调用Web应用的欢迎文件。
?? <welcome-file-list>
??????????? <welcome-file>welcome.jsp</welcome-file>
??????????? <welcome-file>index.jsp</welcome-file>?
? </welcome-fiel-list>
说明：<welcome-file-list>可以包含多个<welcome-file>子元素，首先查找第一个<welcome-file>文件。
??? 由于<welcome-file-list>元素中不能配置Servlet映射，因此不能直接把Structs的Action作为欢迎文件，可以采用一种变通的方法来实现在欢迎文件中调用Structs?Action。首先，在Structs配置文件中为被调用的Action创建一个全局的转发项，例如：
?? <global-forwards>
???????? <forward?name=”welcome”?path=”HelloWord.do”/>
</global-forwords>
创建一个welcome.jsp的文件
最后在web.xml文件中把welcome.jsp文件配置为欢迎文件，代码如下：
????? <welcome-file-list>
?????????? <welcome-file>welcome.jsp</welcome-file>
????? </welcome-file-list>
第四步：配置错误处理
????
<error-page>
???? <error-code>404</error-code>
???? <location>/commom/404.jsp</location>
</error-page>
<error-page>
???? <error-code>505</error-code>
???? <location>/commom/505.jsp</location>
</error-page>
??? 也可以为Web容器捕获的Java异常配置<error-page>,需要设置<exception-type>子元素，它用于指定Java异常类。Web容器可能捕获如下异常：
?? RuntimeException或Error???ServletException或它的子类??IOException或它的子类
<error-page>
???? <exception-type>java.io.IOException</exception-type>
???? <location>/common/system_ioerror.jsp</location>
</error-page>
第五步：配置Structs标签库
???? 使用客户化的标签库，要配置它们
??? <taglib>
??????? <tag-uri>/WEB-INF/structs-html.tld<tag-uri>
??????? <taglib-location>/WEB-INF/structs-html.tld</taglib-location>
??? </taglib>
<tag-uri>用于指定标签库的相对或者绝对URI地址，Web应用根据这一URI来访问标签库。
<taglib-location>指定标签描述文件在文件资源系统中的物理位置。
2?Structs配置文件
????? Structs框架在启动时会读入其配置文件，根据它来创建和配置各种Structs组件。
1<Structs-config>元素
????? <structs-config>元素是Structs配置文件的根元素，<structs-cofig>元素有8个子元素。它的DTD定义如下：
? <!ELEMENT?structs-config(data-sources?,formbean?,global-exeception?,global-forward?,action-mapping,controller?,message-resources*,plug-in*)>
? 在Struts配置中，必须按照以上的DTD指定的先后顺序来配置<Structs-config>元素的各个子元素，如果颠倒了这些元素的配置文件中的位置，在Structs应用启动时会生成错误。
<data-sources>元素
???????????????????????????????????????????????????????????????????????????????????????




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




<global-forwards>
??????? <forward?name="forward1"?path="/Action1.do"/>
<forward?name="forward1"?path="/Action2.do"/>
? </global-forwards>
如果jsp1.jsp把请求转发给Action1,可以使用以下代码：
<html:link?forward=”forward1”>
?? 或者<logic:forward?name=”forward1”>
如果Action1的execute（）方法把请求转发给JSP2.jsp，可以使用一下代码：
return(mapping.findForward(“forward2”))
5<action-mapping>元素
??? <action-mapping>元素包含零个或者多个<action>元素。<action>元素描述了从特定的请求路径到相应的Action类的映射。
6<controller>元素
?? <controller>元素用于配置ActionServlet。
7<?message-resources>元素
<message-resources>元素用于配置Resource?Bundle，Resource?Budle用于存放本地化消息文件。
Structs标签
HTML标签
标签名????描述
base????包装HTML的base元素
button????包装HTML的?button类型的input元素
cancel????包装HTML?cancel?按钮
checkbox????包装HTML?checkbox?类型的输入域
errors????有条件地显示一些error消息，显示ActionErrors信息
file????包装HTML文件上传输入域
form????定义HTML?form?元素
frame????包装HTML?frame?元素
hidden????包装HTML?hidden?输入域
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控件定义一个公共属性。
(Struts?1.0?要求每个属性都要mutator?和accessor?。Struts?1.1?则没有如此严格)
ActionForm还可能要符合一些可选的要求:
如果你要求ActionForm?在传递属性到Action之前校验它们，你就必须实现validate
方法；
如果想在组装前初始化属性，必须实现reset?,?它在ActionForm?组装前被调用；
动态ActionForm
ActionForm?作为类型转换器
ActionForm的一个强制点是应该使用String?和boolean属性。实际上，这意味着属性
必须得从一种转换到另一种类型。大部分应用也需要一些属性，比如电话号码或者数量，以
一种格式化的方式出现。核心Java?包提供一些工具来做这种事情，但是要清楚地将他们集
成到应用中仍然是一个挑战。
Struts?开发人员经常在ActionForm中包含helper方法，来进行类型转换。helper?方法
可以有很多种实现方式，这我们在5.6种叙述。
5.2.6?ActionForm?作为防火墙
当请求提交时，ActionServlet?使用一个自动组装机制来从请求参数中设置请求的
ActionForm属性。这让你可以通过控制哪个ActionForm?属性被暴露来控制哪个请求参数
是可接受的。这也意味着如果你的ActionForm?的粗心设计你可能失去控制哪个参数可以接
受的能力。ActionForm?一定不能包含看起来像是一个JavaBean?属性，但不能从HTTP?请
求设置的属性方法。
5.3.4?ActionForm?可以嵌套其它bean
因为Struts?标签扩展和自动组装机制都支持点号语法来从ActionForm访问其它
bean。这是一个方便的方式，可以通过ActionForm来组装存在的bean。在JSP?页面,?你可
以象这样引用一个嵌套的bean：
<html:text
propety="values.telephoneText"
size="14"
maxlength="14"/>
5.7.2?分发（Dispatch?）
Struts?开发人员通常使用同一个Action处理相关的操作。一个通常做法来选择操作是在
HTML表单中使用隐藏属性。BaseForm?的dispatch?属性也可用作这个目的：
public?void?setDispatch(String?dispatch);
public?String?getDispatch();
Struts?配置提供连个级别嵌套的ActionForward:
?? Global?（全局）?ActionForward对整个应用中的所有Action?对象均有效；
?? Local?（局部）?ActionForward?则在ActionMapping?元素中定义。仅对那些在这个
ActionMapping中调用的Action对象有效。
从Action?对象内部来看，forward?通常像这样来选择：
ActionForward?forward?=?mapping.findForward("continue");