3.3.2
输入字段类型支持
Struts为所有以下类型的输入字段定义了标记，带有与其相应的参考信息的超联接。
checkboxes
hidden 字段
password 输入字段
radio 按钮
reset 按钮
select 列表和嵌入的
options
submit 按钮
text 输入字段
textareas
在所有情况下，一个字段标记都必须嵌套在一个 form
标记中，这样字段才知道使用哪个bean来初始化显示的值。
3.3.3 其它有用的表示标记
在Struts的标记库中有几个其它的标记对于建立用户界面是有帮助的：
enumerate
为一个指定集合的每个元素重复一次标记体（可以是一个Enumeration，一个Hashtable，一个Vector或一个对象数组）。
getProperty 从指定的bean中得到指定的属性，并且在本页面的其余部分作为一个page范围的bean存在。这是访问一个被
enumerate 使用的集合的方便的方法。
ifAttributeExists
只有在一个指定的属性存在于一个指定的范围中时才对标记体求值。
ifAttributeMissing
只有在一个指定的属性不存在于一个指定的范围中时才对标记体求值。
ifParameterEquals
只有在一个指定的请求参数具有一个指定的值时才对标记体求值。
ifParameterNotEquals
只有在一个指定的请求参数不具有一个指定的值或者不存在时才对标记体求值。
ifParameterNotNull
只有在一个指定的请求参数包含在这个请求中并且长度大于0时才对标记体求值。
ifParameterNull
只有在一个指定的请求参数不包含在这个请求中或者长度等于0时才对标记体求值。
iterate
为一个指定集合中的每个元素重复一次标记体（可以是一个Collection，一个Iterator，一个Map，或者一个对象数组）。这个标记在Java2环境中代替了
enumerate 标记。
link 生成一个超联接，当没有cookie支持时自动应用URL编程来维护session状态。
parameter 处理指定请求参数的值，适当地过滤HTML中有特殊含义的字符。
property 显示一个表单中命名的bean属性 --
在属性应该是只读时使用这个标记而不是 text
标记。
3.3.4 自动表单验证
除了上面描述的表单和bean的交互外，如果你的bean知道怎样验证它接收的输入字段，Struts还提供一种附加的机制。为了利用这个特性，使你的bean类实现
ValidatingActionForm 接口，而不是 ActionForm 接口。一个
ValidatingActionForm 增加了一个附加的方法签名：
public String[] validate()
对于一个被controller servlet在bean属性已经组装但是在相应的行为类的
perform() 方法被调用之前调用的方法，validate()
方法有以下可选项：
执行适当的验证发现没有错误 -- 返回 null
或者一个非0长度字符串数组，并且controller servlet将继续调用适当的
Action 类的 perform() 方法。
执行适当的验证发现有错误 --
返回一个内容为应该被显示的出错消息关键字（进入应用程序的MessageResources
包）的字符串数组。controller servlet将作为适合于
标记使用的请求属性保存这个数组，并且将控制重定向回输入表单（由这个
ActionMapping 的 inputForm 属性标识）。
正如以前提到的，这个特性完全是可选的。如果你的form
bean 仅仅实现了 ActionForm 接口，controller servlet将假设任何请求的验证由action类完成。
3.4 其它的表示技术
尽管你的应用程序的外表和感觉可以完全基于标准的JSP能力和Struts的定制标记库构建，你也应该考虑展开其它改进组件重用、减少管理负担或者减少出错的技术。在下面的部分讨论几个可选的技术。
3.4.1 特定于应用程序的定制标记
在使用Struts库提供的定制标记之外，很容易建立特定于你创建的应用程序的标记来帮助建立用户界面。Struts包括的例子程序用建立以下仅用于实现这个应用程序的标记演示了这个原则：
checkLogon -
检查一个特殊的会话对象的存在，如果不存在将控制重定向到注册页面。这是用来捕捉这样的情况，用户在你的应用程序执行的中间把一个页面做成书签并且试图跳过注册，或者用户的会话超时。
linkSubscription -
为一个详细的定单页面生成一个超联接，它将需要的主关键字值作为一个请求属性传递。这在列出与一个用户相关的定单并提供编辑或删除定单的联接时使用。
linkUser -
为一个用户的一个具体的页面生成一个超联接，它将它将需要的主关键字值作为一个请求属性传递。
这些标记的源代码在 src/example 目录中，在包
org.apache.struts.example
里，还带有一些其它的用在这个应用程序中的Java类。
3.4.2 有包含文件的页面组件
在一个JSP文件（包含定制标记和beans用来访问请求的动态数据）中创建完整的表示是一种非常普通的设计方法，在Struts包括的例子程序中被采用。然而很多应用程序要求在单独一个页面中显示你的应用程序的多个逻辑上独立的部分。
举例来说，一个入口应用程序可以在入口的主页面上有一些或者全部以下的功能：
访问这个入口的一个搜索引擎。
一个或更多的“提供新闻”的显示，含有按照用户的注册信息定制的感兴趣的标题。
访问与这个入口相关的讨论的主题。
如果你的入口提供免费邮件帐号，还要有一个“邮件等待”的提示。
如果你能够将工作划分开，分配不同的开发者去做不同的片段，那么这个站点不同片段的开发就会更加简单。然后，你可以使用JSP技术的
include
能力来将这些片段组合进一个单独的页面。有两种
include
可用，依赖于你希望输出的组合发生在什么时间：
include 指令 （<%@ include file="xxxxx" %>
）在JSP页面被编译时处理。它用于包括不需要在请求时改变的HTML代码。它把包括进来的文本当作静态文本，很象C或C++中的
#include 指令。
include 行为 （
）在请求时处理，并且是由服务器透明处理。这意味着你可以通过把它嵌套在一个类似ifParameterEquals的标记中有条件地执行include
。
3.4.3 图片处理组件
一些应用程序要求动态生成图片，就象一个股市报告站点的价格图一样。通常使用两种不同的方法来实现这个需求：
处理一个执行一个servlet请求的URL的超联接。这个servlet将使用一个图象库来生成图片，设置适当的content类型（例如
image/gif），并且将图片的字节流发送回浏览器。浏览器就会象从一个静态文件中接收到的一样显示图片。
处理HTML代码需要下载一个创建请求的图象的Java
applet。你可以通过为在处理的代码中的这个applet设置适当的初始化参数配置这个图象，或者你可以让这个applet与服务器建立自己联接来接收这些参数。
4. 创建Controller组件
4.1 概述
现在我们理解了怎样构造你的应用程序的Model和View组件，现在是集中到
Controller 组件的时候了。Struts包括一个实现映射一个请求URI到一个行为类的主要功能的servlet。因此你的与Controller有关的主要责任是：
为每一个可能接收的逻辑请求写一个 Action
类（也就是，一个 Action 接口的实现）
写一个定义类名和与每个可能的映射相关的其它信息的
ActionMapping 类（也就是，一个 ActionMapping
接口的实现）
写行为映射配置文件（用XML）用来配置controller
servlet。
为你的应用程序更新web应用程序展开描述符文件（用XML）用来包括必需的Struts组件。
给你的应用程序添加适当的Struts组件。
4.2 Action类
Action 接口定义一个单一的必须由一个 Action
类实现的方法，就象下面这样：
public ActionForward perform(ActionServlet servlet,
ActionMapping mapping,
ActionForm form,
HttpServletRequest request,
HttpServletResponse response)
throws IOException, ServletException;
|
一个 Action
类的目标是处理这个请求，然后返回一个标识JSP页面的
ActionForward 对象，控制应该重定向这个JSP页面以生成相应的响应。在
Model 2 设计模式中，一个典型的 Action 类将在它的
perform() 方法中实现下面的逻辑：
验证用户session的当前状态（例如，检查用户已经成功地注册）。如果
Action
类发现没有注册存在，请求应该重定向到显示用户名和口令用于注册的JSP页面。应该这样做是因为用户可能试图从“中间”（也就是，从一个书签）进入你的应用程序，或者因为session已经超时并且servlet容器创建了一个新的session。
如果验证还没有发生（由于使用一个实现
ValidatingActionForm 接口的form bean），验证这个 form bean
的属性是必须的。如果发现一个问题，当作一个请求属性保存合适的出错信息关键字，然后将控制重定向回输入表单这样错误可以被纠正。
执行要求的处理来处理这个请求（例如在数据库里保存一行）。这可以用嵌入
Action
类本身的代码来完成，但是通常应该调用一个商业逻辑bean的一个合适的方法来执行。
更新将用来创建下一个用户界面页面的服务器端对象（典型情况下是request范围或session范围beans，定义你需要在多长时间内保持这些项目可获得）。
返回一个标识生成响应的JSP页面的适当的 ActionForward
对象，基于新近更新的beans。典型情况下，你将通过在你接收到的
ActionMapping
对象（如果你使用一个局部于与这个映射上的逻辑名）或者在controller
servlet
本身（如果你使用一个全局于应用程序的逻辑名）上调用
findForward() 得到一个对这样一个对象的引用。
当为 Action
类编程时要记住的设计要点包括以下这些：
controller servlet仅仅创建一个你的 Action
类的实例，用于所有的请求。这样你需要编写你的
Action
类使其能够在一个多线程环境中正确运行，就象你必须安全地编写一个servlet的
service() 方法一样。
帮助线程安全编程的最重要的原则就是在你的 Action
类中仅仅使用局部变量而不是实例变量。局部变量创建于一个分配给（由你的JVM）每个请求线程的栈中，所以没有必要担心会共享它们。
尽管不应该，代表你的系统中Model部分的的beans仍有可能抛出违例。你应该在你的
perform()
方法的逻辑中捕捉所有这样的违例，并且通过执行以下语句将它们记录在应用程序的日志文件中（包括相应的栈跟踪信息）：
servlet.log("Error message text", exception);
|
作为一个通用的规则，分配很少的资源并在来自同一个用户（在用户的session中）的请求间保持它们会导致可伸缩性的问题。你应该在将控制重定向到适当的View组件前努力释放这样的资源（例如数据库联接）
-- 甚至在你调用的一个bean抛出了一个违例时。
另外，你将会想要防止出现非常大的 Action
类。最简单的实现途径是将你的功能逻辑嵌入到
Action 类本身，而不是将其写在独立的商业逻辑beans中。除了使
Action
类难于理解和维护外，这种方法也使得难于重用这些商业逻辑代码，因为代码被嵌入到一个组件（Action
类）中并被捆绑运行于web应用程序环境中。
包括在Struts中的例子程序某种程度上延伸了这个设计原则，因为商业逻辑本身是嵌入到
Action
类中的。这应该被看作是在这个样本应用程序设计中的一个bug，而不是一个Struts体系结构中的固有特性，或者是一个值得仿效的方法。
4.3 ActionMapping实现
为了成功地运行，Struts的controller servlet需要知道关于每个URI该怎样映射到一个适当的
Action 类的几件事。需要了解的知识封装在一个叫做
ActionMapping 的Java接口中，它有以下属性：
actionClass - 用于这个映射的 Action 类完整的Java类名。第一次一个特定的映射被使用，一个这个类的实例将被创建并为以后重用而保存。
formAttribute - session范围的bean的名字，当前的这个映射的
ActionForm 被保存在这个bean之下。如果这个属性没有被定义，没有
ActionForm 被使用。
formClass - 用于这个映射的 ActionForm 类完整的Java类名。如果你在使用对form
beans的支持，这个类的一个实例将被创建并保存（在当前的用户会话中）
path - 匹配选择这个映射的请求的URI路径。看下面如何匹配的例子。
Struts在一个叫做 ActionMappingBase 的类中包括了一个
ActionMapping
接口的方便的实现。如果你不需要为你自己的映射定义任何附加的属性，尽管把这个类作为你的
ActionMapping
类好了，就向下面部分描述的那样配置。然而，定义一个
ActionMapping 实现（多半是扩展 ActionMappingBase
类）来包含附加的属性也是可能的。controller servlet知道怎样自动配置这些定制属性，因为它使用Struts的Digester模块来读配置文件。
包括在Struts的例子程序中，这个特性用来定义两个附加的属性：
failure - 如果Action类检测到它接收的输入字段的一些问题，控制应该被重定向到的上下文相关的URI。典型情况下是请求发向的JSP页面名，它将引起表单被重新显示（包含Action类设置的出错消息和大部分最近的来自ActionForm
bean的输入值）。
success - 如果Action类成功执行请求的功能，控制应该被重定向到的上下文相关的URI。典型情况下是准备这个应用程序的会话流的下一个页面的JSP页面名。
使用这两个额外的属性，例子程序中的 Action
类几乎完全独立于页面设计者使用的实际的JSP页面名。这个页面可以在重新设计时被重命名，然而几乎不会影响到
Action 类本身。如果“下一个”JSP页面的名字被硬编码到
Action 类中，所有的这些类也需要被修改。
4.4 Action映射配置文件
controller servlet怎样知道你想要得到的映射？写一个简单地初始化新的
ActionMapping 实例并且调用所有适当的set方法的小的Java类是可能的（但是很麻烦）。为了使这个处理简单些，Struts包括一个Digester模块能够处理一个想得到的映射的基于XML的描述，同时创建适当的对象。看
API 文档 以获得关于Digester更多的信息。
开发者的责任是创建一个叫做
action.xml 的XML文件，并且把它放在你的应用程序的WEB-INF目录中。（注意这个文件并不需要
DTD，因为实际使用的属性对于不同的用户可以是不同的）最外面的XML元素必须是
，在这个元素之中是嵌入的0个或更多的
元素 -- 每一个对应于你希望定义的一个映射。
来自例子程序的 action.xml 文件包括“注册”功能的以下映射条目，我们用来说明这个需求：
<action-mappings>
<forward name="logon" path="/logon.jsp"/>
<action path="/logon"
actionClass="org.apache.struts.example.LogonAction"
formAttribute="logonForm"
formClass="org.apache.struts.example.LogonForm"
inputForm="/logon.jsp">
<forward name="success" path="/mainMenu.jsp"/>
</action>
</action-mappings>
|
就象你所看到的，这个映射匹配路径 /logon
（实际上，因为例子程序使用扩展匹配，你在一个JSP页面指定的请求的URI结束于/logon.do）。当接收到一个匹配这个路径的请求时，一个
LogonAction
类的实例将被创建（仅仅在第一次）并被使用。controller
servlet将在关键字 logonForm 下查找一个session范围的bean，如果需要就为指定的类创建并保存一个bean。
这个 action 元素也定义了一个逻辑名“success”，它在
LogonAction
类中被用来标识当一个用户成功注册时使用的页面。象这样使用一个逻辑名允许将
action
类隔离于任何由于重新设计位置而可能发生的页面名改变。
这是第二个在任何 action 之外宣告的 forward
元素，这样它就可以被所有的action全局地获得。在这个情况下，它为注册页面定义了一个逻辑名。当你调用
mapping.findForward() 时在你的 action 代码中，Struts首先查找这个action本地定义的逻辑名。如果没有找到，Struts会自动为你查找全局定义的逻辑名。
4.5 Web应用程序展开描述符
设置应用程序最后的步骤是配置应用程序展开描述符（保存在文件WEB-INF/web.xml中）以包括所有必需的Struts组件。作为一个指南使用例子程序的展开描述符，我们看到下面的条目需要被创建或修改。
4.5.1 配置Action Servlet实例
添加一个条目定义action servlet本身，同时包括适当的初始化参数。这样一个条目看起来象是这样：
<servlet>
<servlet-name>action</servlet-name>
<servlet-class>org.apache.struts.action.ActionServlet</servlet-class>
<init-p
aram>
<param-name>application</param-name>
<param-value>org.apache.struts.example.ApplicationResources</param-value>
</init-param>
<init-param>
<param-name>config</param-name>
<param-value>/WEB-INF/action.xml</param-value>
</init-param>
<init-param>
<param-name>debug</param-name>
<param-value>2</param-value>
</init-param>
<init-param>
<param-name>mapping</param-name>
<param-value>org.apache.struts.example.ApplicationMapping</param-value>
</init-param>
<load-on-startup>2</load-on-startup>
</servlet>
|
controller servlet支持的初始化参数在下面描述，拷贝自
ActionServlet 类的 Javadocs
。方括号描述如果你没有为那个初始化参数提供一个值时假设的缺省值。
application - 应用程序资源包基类的Java类名。[NONE].
config - 包含配置信息的XML资源的上下文相关的路径。[/WEB-INF/action.xml]
debug - 这个servlet的调试级别，它控制记录多少信息到日志中。[0]
digester - 我们在 initMapping() 中利用的Digester的调试级别，它记录到System.out而不是servlet的日志中。[0]
forward - 使用的ActionForward实现的Java类名。[org.apache.struts.action.ActionForward]
mapping - 使用的ActionMapping实现的Java类名。[org.apache.struts.action.ActionMappingBase]
nocache - 如果设置为 true，增加HTTP头信息到所有响应中使浏览器对于生成或重定向到的任何响应不做缓冲。[false]
null - 如果设置为 true，设置应用程序资源使得如果未知的消息关键字被使用则返回
null。否则，一个包括不欢迎的消息关键字的出错消息将被返回。[true]
4.5.2 配置Action Servlet映射
有两种通常的方法来定义将被controller servlet处理的URL
--
前缀匹配和扩展匹配。每种方法的一个适当的映射条目将在下面被描述。
前缀匹配意思是你想让所有以一个特殊值开头（在上下文路径部分之后）的URL传递给这个servlet。这样一个条目看起来可以象是这样：
<servlet-mapping>
<servlet-name>action</servlet-name>
<url-pattern>/execute/*</url-pattern>
</servlet-mapping>
|
它意味着一个匹配前面描述的 /logon 路径的请求的URL看起来象是这样：
http://www.mycompany.com/myapplication/execute/logon
|
这里 /myapplicationis
是你的应用程序展开所在的上下文路径。
另一方面，扩展映射基于URL以一个跟着定义的一组字符的句点结束的事实而将URL匹配到action
servlet 。例如，JSP处理servlet映射到 *.jsp
模式这样它在每个JSP页面请求时被调用。为了使用
*.do 扩展（它意味着“做某件事”）映射条目看起来应该象是这样：
<servlet-mapping>
<servlet-name>action</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>
|
并且一个匹配以前描述的 /logon 路径的请求的URI可以看起来象是这样：
http://www.mycompany.com/myapplication/logon.do
|
4.5.3 配置Struts标记库
下一步，你必须添加一个定义Struts标记库的条目。这个条目看起来应该象是这样：
<taglib>
<taglib-uri>/WEB-INF/struts.tld</taglib-uri>
<taglib-location>/WEB-INF/struts.tld</taglib-location>
</taglib>
|
它告诉JSP系统到哪里去找这个库的标记库描述符（在你的应用程序的WEB-INF目录，而不是在外部互联网上的某个地方）。
4.5.4 添加Struts组件到你的应用程序中
为了在你的应用程序运行时使用Struts，你必须将
struts.tld 文件拷贝到你的 WEB-INF 目录，将 struts.jar
文件拷贝到你的 WEB-INF/lib 。
|