将 Struts、Tiles 和 JavaServer Faces (JSF) 一起使用,开发人员可以实现易于管理和重用的、健壮的、界面清晰的 Web 应用程序。
Struts 框架推出已经有一段时间了,它已经成为在开发 J2EE Web 应用程序时开发人员所采用的事实上的标准。Tiles 框架是在 Struts 之后不久出现的,它通过为开发人员提供用组件组装展示页面的能力开拓了自己的生存环境。JSF 是 Web 应用程序框架中最新的成员,它提供了验证用户输入和处理用户事件的机制,最重要的是,这是一种以协议无关的方式呈现用户界面组件的方法(有关这些 技术的概况,参见本文相关页面“The major players”)。
尽管 Struts 和 JSF 中有一些功能是重叠的,但是它们在其他方面起到了互为补充的作用。这三种技术的结合可以为开发 Web 应用程序、组织其展示和以协议无关的方式呈现定制的用户界面(UI)组件提供一种高效的途径。
为了运行本文中的示例代码,需要 Struts 1.1、Tiles、JavaServer Faces Reference Implementation (JSF-RI) Early Access Release 4.0 以及 Struts-Faces 0.4。Jakarta 项目提供的 Struts 1.1 发行版本将 Struts 和 Tiles 捆绑发布。还可以从 Jakarta 项目上下载 Struts-Faces 集成库。JSF-RI 是 Sun 的 Web 开发工具包(Web Services Developer Pack)的一部分(在参考资料中有这些下载和示例代码的链接)。
现在回到集成三种技术的细节上。首先有个坏消息:在本文发表的时候,这三种技术是不能直接互操作的。好消息是:在本文中,我们展示了集成 Struts、Tiles 和 JSF 的方法。我们假设您已经了解 Struts 和 Tiles。对 JSF 有一些了解会有帮助(参阅 参考资料中提供的 developerWorks 上的 JSF 教程的链接),但是不了解也不妨碍对本文的理解。
JSF 简介
JSF 应用程序是使用 JSF 框架的普通 J2EE Web 应用程序,JSF 框架提供了丰富的 GUI 组件模型,这些模型体现了真正的 GUI 框架内涵。您可能听人们说过,尽管某种技术不错,但是它的外观仍然需要改进。是的,用 HTML 组件构建平淡无奇的页面的日子已经过去了,如果使用 JSF 的话,具有更高级 GUI 外观的日子就在眼前。您会问,怎么做呢?树形组件、菜单组件和图形是已经存在的 UI 组件,这些 JSF 一定要提供。更进一步,JSF 通过提供容易使用的 API 鼓励创建自定义组件。
注: 这里所提到的 UI 组件是 Sun 提供的示例的一部分。像所有规范一样,实际的实现由不同的提供商完成。
在传统的使用模型-视图-控制器(MVC)的 Web 应用程序中,GUI 组件是由处理展示和业务逻辑的自定义标记所表示的。这样就出现了必须“编写与客户机设备打交道的代码”的问题,这会产生重复的代码。使用 JSF 就不会有这个问题。
JSF 结构将展示逻辑 (“什么”)与 UI 组件的业务逻辑 (“为什么”和“如何”)分离。通过在 JSP 页面中使用 JSF 标记,就可以将 renderer 与 UI 组件关联在一起。一个 UI 组件可以用不同的 renderer 从而以不同的方式呈现。特定于 UI 组件的代码在服务器上运行,并且响应用户操作所产生的事件。
JSF-RI 提供了一个 render kit,它带有一个自定义标记库,用以从 UI 组件呈现 HTML。它还提供了根据需要定制这些组件外观的能力。如果需要特殊的组件,那么可以为特定的客户机设备构造定制的标记并让它与一个子 UI 组件和定制的 renderer 相关联。对于不同的设备,您所需要做的就是指定不同的 renderer。
JSF 和 UI 组件
您可能已经用 Java AWT 或者 Swing API 创建过 Java GUI 应用程序,所以您应该熟悉 JSF 的 UIComponent (它与 AWT 或者 Swing 组件很相像)。它储存其子组件的树(如果有的话)并为客户端发生的动作生成标准事件,例如单击一个按钮以提交表单。这些事件缓存在 FacesContext 中。您可以用自定义标记关联每一个这种事件的处理程序。例如,用一个自定义的 ActionListener 处理用户单击或者表单提交。
JSF UIComponent、Renderer 和标记总是共同工作的。所有 JSP 自定义标记都是通过继承 UIComponentTag 创建的。doStart 和 doEnd 方法总是在 UIComponentTag 类中实现。您只需在这些标记类中提供其他的功能。
自定义标记、UI 组件和 renderer 之间的关系。客户机浏览器访问用 JSF 标记(jsf:myTag)表示 UI 组件(MyComponent)的 JSP 页面。这个 UI 组件运行在服务器上,并用适当的 renderer (MyRenderer)以 HTML 的形式呈现给客户。这个 JSP 页面表现了在 JSF-RI 中使用带自定义标记的用户界面组件而不是在 HTML 中对它们进行编码。
展示了 h:panel:group 标记的使用。这个标记用于将一个父组件下面的各个组件组织到一起。如果与像 panel_grid 和 panel_data 这样的其他面板标记共同使用,那么它会在运行时生成 HTML 表中的列的标记。JSF-RI-提供的 html_basic 标记库用于表示像文本字段、按钮这样的 HTML 组件
JSF 生命周期
JSF 生命周期包括六个阶段:一个传入的请求可能会经历全部阶段,也可能不经历任何阶段,这取决于请求的类型、在生命周期中发生的验证和转换错误以及响应的类型。JSF 框架处理由 JSP 页生成的 Faces 请求,并返回 faces 或者 non-faces 响应。
在提交一个 JSF 表单,或者当用户单击指向在 URL 中具有 /faces 前缀的 URL 的链接时,就会出现 faces 响应。所有 faces 请求都由一个 FacesServlet 处理 -- 这是 JSF 中的控制器。
发送给一个 servlet 或者一个没有 JSF 组件的 JSP 页面的请求称为 non-faces 请求。如果结果页中有 JSF 标记,那么它就称为 faces 响应,如果没有 JSF 标记,就是 non-faces 响应。
JSF 生命周期有六个阶段:
重建请求树
应用请求值
进行验证
更新模型值
调用应用程序
呈现响应
根据 JSF 规范,每一阶段表示请求处理生命周期的一个逻辑概念。不过在 JSF-RI 中,这些阶段是由具有对应名字的实际类表示的。下面一节描述了每一阶段是如何对请求进行处理并生成响应的。您将首先看到的是处理一个 faces 请求所涉及的阶段,然后是处理 faces 响应所涉及的阶段。
处理 faces 请求
为了理解 JSF 请求处理,请看 FlightSearch.jsp,这是清单 1中的一个简单的 JSF 表单。一个 JSF 页面基本上就是这个样子的。这个 JSF 表单有输入文本字段 from 和 to cities、departure 和 return dates,还有提交和重设表单的按钮(我们会在稍后分析清单1中每一个标记的意义)。现在,假设提交这个表单产生了一个 faces 请求。
这个请求被 FacesServlet 所接收、并在向客户发回响应之前通过不同的阶段。图 2展示了如何对 JSF 请求进行处理。让我们看一看这是如何进行的。
1. 接收请求
FacesServlet 接收请求并从 FacesContextFactory 得到 FacesContext 的一个实例。
2. 委托生命周期处理
FacesServlet 通过对在 faces 上下文中传递的 Lifecycle 实现调用 execute 方法将生命周期处理委托给 Lifecycle 接口。
3. Lifecycle 执行每一阶段
Lifecycle 实现执行从重建组件树阶段开始的每一阶段。
4. 创建的组件树
在重建组件树阶段,用 travelForm 中的组件创建一个组件树。这个树以 UIForm 作为根,用不同的文本字段和按钮作为其子组件。
fromCity 字段有一个验证规则,它规定其不能为空,如 validate_required 标记所示。这个标记将 fromCity 文本字段与一个 JSF Validator 链接起来。
JSF 有几个内建的验证器。相应的 Validator 是在这个阶段初始化的。这个组件树缓存在 FacesContext 中、并且这个上下文会在后面用于访问树及调用任何一个事件处理程序。同时 UIForm 状态会自动保存。所以,当刷新这一页时,就会显示表单的原始内容。
5. 从树中提取值
在应用请求值阶段,JSF 实现遍历组件树并用 decode 方法从请求中提取值,并在本地设置每一个组件。如果在这个过程中出现了任何错误,那么它们就在 FacesContext 中排队并在呈现响应阶段显示给用户。
同时,在这个阶段排队的所有由像单击按钮这样的用户操作产生的事件,都广播给注册的侦听器。单击 reset 按钮会将文本字段中的值重新设置为它们原来的值。
6. 处理验证
在处理验证阶段,对在应用请求值阶段设置的本地值进行所有与各组件相关的验证。当 JSF 实现对每一个注册的验证器调用 validate 方法时就会进入此阶段。
如果任何一项验证失败,那么生命周期就会进入呈现响应阶段,在那里呈现带有错误信息的同一页面。在这里,所有在这一阶段排队的事件同样都会广播给注册的侦听器。
JSF 实现处理源字段上的验证器。如果数据是无效的,那么控制就交给呈现响应阶段,在这个阶段重新显示 FlightSearch.jsp 并带有相关组件的验证错误。通过在 JSP 页面中声明 output_errors,页面中的所有错误都会显示在页面的底部。
7. 设置模型对象值
在更新模型值阶段,成功处理了所有验证后,JSF 实现就通过对每一组件调用 updateModel 方法用有效值设置模型对象值。如果在将本地数据转换为由模型对象属性所指定的类型时出现任何错误,那么生命周期就进入呈现响应阶段,并将错误显示出来。来自表单字段属性的值会填充为模型对象的属性值。
8. 可以调用 ActionListener
可以将一个 ActionListener 与一个用户操作,如单击提交按钮相关联,如清单 1所示。在调用应用程序阶段,对 FlightSea