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-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>

<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>

<servlet-mapping>
<servlet-name>action</servlet-name>
<url-pattern>/execute/*</url-pattern>
</servlet-mapping>

http://www.mycompany.com/myapplication/execute/logon

<servlet-mapping>
<servlet-name>action</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>

http://www.mycompany.com/myapplication/logon.do

<taglib>
<taglib-uri>/WEB-INF/struts.tld</taglib-uri>
<taglib-location>/WEB-INF/struts.tld</taglib-location>
</taglib>