JSF简单教程JSF简单教程.doc

JSF自定义组件 原文：.tw/confluence/pages/viewpage.action?pageId=2630 繁简转换与修订：jnzgy@163.com 声明：为方便简体中文读者阅读，特将原文转换为简体，对一些习惯用语做了替换，同时对部分内容做了修订。版权归原文作者所有，未经许可，不得用于商业目的。 1. JSF生命周期与组件概述 2 1.1 JSF生命周期 2 1.2 概述自定义组件 3 2. 简单实例 4 2.1 编码、解码 4 2.2 组件标签 6 2.3 使用自定义组件 10 2.4 自定义Renderer 11 JSF 自定义组件 JSF 让您可以自定义组件，每个组件都是可替换的，这使得组件在搭配时更有弹性，但相对的却使开发组件的过程复杂的多，这里对自定义JSF 组件只是个入门砖，更多有关自定义组件的细节可得要专书来说明。  1. JSF生命周期与组件概述 要开发JSF组件，您需要更深入了解JSF的一些处理细节，包括了JSF生命周期以及JSF框架。 1.1 JSF生命周期 JSF的每个组件基本上都是可替换的，像是转换器（Converter）、验证器（Validator）、组件（Component）、绘制器（Renderer）等等，每个组件都可以替换让JSF在使用时更有弹性，但相对的所付出的就是组件组合时的复杂性，为此，最基本的，如果您打算自定义一些JSF组件，那么您对于JSF处理请求的每个阶段必须要有所了解。 下图是JSF处理请求时的每个阶段与简单说明，起始状态即使用者端发出请求时，终止状态则相当于绘制器发出响应时： 不包括事件处理，JSF总共必须经过六个阶段： ?? 重建视图（Restore View） 对于选择的页面如果是初次浏览则建立新的组件树。如果是会话阶段，会从客户端或服务器端的数据找寻数据以恢复每个组件的状态并重建组件树，如果不包括请求参数，则直接跳过接下来的阶段直接绘制响应。 ?? 套用请求值（Apply Request Values） 每个组件尝试从到来的请求中找寻自己的参数并更新组件值，在这里会触发ActionEvent，这个事件会被排入队列中，然后在调用应用程序阶段之后才会真正由事件处理者进行处理。 然而对于设定immeduate为true的命令（Commamnd）组件来说，会立即处理事件并跳过之后的阶段直接绘制响应，而对于设定immediate为true的输入（Input）组件，会马上进行转换验证并处理值变事件，之后跳过接下来的阶段，直接绘制响应。 ?? 执行验证（Process Validations） 进行转换与验证处理，如果验证错误，则会跳过之后的阶段，直接绘制响应，结果是重新调用同一页绘制结果。 ?? 更新模型值（Update Model Values） 更新每一个与组件绑定的backing bean或模型对象。 ?? 调用应用程序（Invoke Application） 处理动作事件，并进行后端应用程序逻辑。 ?? 绘制响应（Render Response） 使用绘制器绘制页面。 如果您只是要“使用”JSF，则您最基本的只需要知道“执行验证”、“更新模型值”、与“调用应用程序”这三个阶段及中间的事件触发，JSF参考实现将这三个阶段之外的其它阶段的复杂性隐藏起来了，您不需要知道这几个阶段的处理细节。 然而如果您要自定义组件，则您还必须知道“重建视图”、“套用请求值”与“绘制响应”这些阶段是如何处理的，这几个阶段相当复杂，所幸的是您可以使用JSF 所提供的框架来进行组件自定义，JSF提供的框架已经很大程度上降低了组件制作的复杂性。 当然，即使JSF框架降低了复杂性，但实际上要处理JSF自定义组件还是很复杂的一件事，在尝试开发自定义组件之前，您可以先搜寻一些网站，像是 Apache MyFaces（ /），看看是不是已经有相关类似的组件已经开发完成，省去您重新自定义组件的气力。 1.2 概述自定义组件 所谓的“自定义JSF组件”是一个概略的称呼，事实上，一个JSF组件包括了三个部份：Tag、Component 与Renderer。 Tag即之前一直在使用的JSF标签，类似于HTML标签，JSF标签主要是方便网页设计人员进行版面配置与数据呈现的一种方式，实际的处理中，JSF标签的目的在于设定Component属性、设定验证器、设定数据绑定、设定方法绑定等等。 Component的目的在于处理请求，当请求来到服务器端应用程序时，每一个Component都有机会根据自己的client id，从请求中取得属于自己的值，接着Component可以将这个值作处理，然后设定给绑定的bean。 当请求来到Web应用程序时，HTTP中的字符串内容可以转换为JSF组件所