DOJO

1. 用户可以基于名字搜索一个产品类型
2. 当用户选择了一个产品，将显示一个带有分隔面板（split pane）的新窗口。该分隔面板左侧以树的形式（就像你在Windows Explorer所看到的那样）显示所有属于该产品类型的产品子类型。可能每个产品子类型还有它自己的子类型。分隔面板右侧显示还有如下标签的标签面板 （tabbed pane）：
   • Products（产品） —— 这个标签页显示属于所选子类型的产品列表
   • Add Product Subtype（增加产品子类型） —— 这个标签页显示一个表单，用来接受给所选产品子类型增加新产品子类输入值
   • 在分隔面板的底部，有一个back按钮以便回到搜索产品类型页。
3. 当某个子类型关联的产品列表显示在分隔面板右侧时，每一页应该只显示10个产品。这意味着应该能够对屏幕上的结果进行分页和排序。
4. 显示在分隔面板左侧的树应该可以展开/折叠（expandable/collapsable）而且不应导致页面刷新，这样会增强用户体验。
5. 鼠标右键点击树上任何一个节点（代表一个产品子类型）应该给用户显示弹出菜单，带有给所选子类增加新产品子类子节点、删除所选产品子类型、用数据库的最新数据刷新所选产品子类的孩子产品子类列表等选项。
6. 当一个新的产品子类被增加到所选产品子类上后，无需刷新页面，新产品子类应该立刻显示在树上。

1显示了当用户选择一个产品类型/子类型时，屏幕上的期望效果。

图 1. 产品子类详细信息窗口

 

DOJO

创建跨浏览器兼容的树结构、标签面板、分隔面板、弹出菜单等等是耗时的工作，同时这些工作最好是由有经验的Javascript/DHTML程序员 来完成。有许多工具包支持这些UI部件并且是跨浏览器兼容的，但是支持丰富事件处理模型的工具包却不多。以下罗列了一些例子应用需要响应以满足用户需求的 用户动作：

用户动作	应用程序响应
选择树节点	显示属于该节点的产品子类列表
右键点击树节点	显示带有增加孩子产品子类、删除所选产品子类等功能的弹出菜单
选择标签面板上的‘增加产品子类型 ’标签	显示输入新产品子类型信息的表单
当用户点击[+]号展开树并察看子节点时	从数据库中装载孩子节点信息并显示在树上

DOJO工具包是一个Javascript/DHTML工具包，它提供了一套丰富UI部件（包括但不止限于树、标签面板、弹出菜单），该套UI部件带有一个非常适合用于本例子应用的丰富事件处理模型。

DWR

DWR ( Direct Web Remoting ) 是一个简化构建用Java编写的AJAX应用的AJAX框架。DWR提供了许多特性，包括（但不只限于此）：

• 由Java类（开发者创建用来处理AJAX请求）创建Javascript
• 允许JSF管理bean作为处理AJAX请求的Java类
• 用转换器（converter）对Javascript关联数组（associative array）和Java bean进行双向转换
• 用转换器对Javascript数组和Java集合进行双向转换

转换器在DWR中扮演一个十分重要的角色，并提供了一个更整洁的编程模型。例如，如果用户输入新产品子类信息，并需要应用程序保存它，那么在Web层有两种方法获得其信息：

• 用 HttpServletRequest 的 getParameter 方法获得所有关于新产品子类的信息。
• 创建一个DTO（数据传输对象） ProductSubtype，其所有产品子类属性都有getter和setter。在dwr.xml文件中配置一个转换器将ProductSubtype指定为一个bean 转 换器。在Javascript中，简单地创建一个关联数组（associative array）并把它传递给Java类（由它来处理AJAX请求）中以ProductSubtype作为参数的方法。在本例中DWR将做由 Javascript关联数组到ProductSubtype的转换，因为ProductSubtype在DWR中被声明用于bean 转换器。

后一种选择提供了一个更整洁的编程模型，你不必处理获取请求参数及创建一个在Java程序中被使用的DTO。

当AJAX请求被处理时，大多数时候需要在Javascript回调方法中接收状态编码、消息或一些的数据，以决定给用户显示什么、不显示什么。Bean转换器在这种情景下非常方便。

DOJO的丰富事件模型结合DWR处理Java应用AJAX请求的整洁方法，提供了创建高交互性Web应用（类似于例子应用）的一种途径，应用中由DOJO组件产生的事件被传递给DWR去处理。

 

问题描述

1. 在一个Portal环境中，开发者不负责为用户界面产生HTML，界面通过解析符合Facelet的XHTML文件来产生。即使JSF管 理bean的属性包含HTML字符串作为其值，它并不是由Portal解析的，而是照原样在用户界面上显示给用户。如何产生可以被Web浏览器执行以创建 UI部件的DOJO特定HTML呢？
2. DOJO提供了丰富事件模型，而且可以在Javascript中截获这些事件。DWR框架可以用来在服务器端接收这些事件，但是服务器端会话状态需要维护在什么地方？
3. 当树上的节点超过几百个时，在IE或Mozilla中Javascript创建DOJO树节点需要花些时间。因此是否这意味着如果节点超过几百个，应用不能在浏览器使用DOJO的树部件？
4. 在Web应用中使用AJAX后，当窗口上发生用户事件时如何产生HTML或HTML片断？应该在Java代码中编码产生还是从一个外部文件获取？应用程序能否在AJAX请求的响应中显示复杂用户界面？
5. 当使用AJAX时，代码可能因使用HttpServletRequest的getParameter("fieldName")方法而变得混乱，难以维护。

解决方案

自定义JSF组件

自定义JSF组件用来为DOJO的树和分隔容器组件产生所需的HTML。JSF组件所产生的HTML总是由浏览器解析，而不是由Portal作为文本输出。下面是XHTML的部分内容，展示了如何自定义JSF组件用来产生DOJO的树和标签面板窗口部件。

<div xmlns="http://www.w3.org/1999/xhtml"
 	...
 	...
 	xmlns:dojo="http://dojotoolkit.org/"
 	xmlns:mytree="http://mytree.com/tree"
 	xmlns:mytab="http://mypane.com/tabPane">
 <ui:composition>
 <ui:define name="body">
 		<f:view>
 		<h:form styleClass="form" id="formId">
 		<div dojoType="SplitContainer" orientation="horizontal" sizerWidth="5" activeSizing="false" style="overflow:
              auto; whitespace: nowrap; height: 550px;  background: transparent; padding: 5px;" >
 		<div dojoType="ContentPane" sizeShare="20"
 		style="overflow: auto; whitespace: nowrap;">
 		<mytree:treeComponent backingBeanName="treeBackingBean"></mytree:treeComponent>
 		</div>
 		<div dojoType="ContentPane" sizeShare="80" style="overflow: auto; white-space nowrap;">
 		<mytab:tabPaneComponent/>
 		</div>
 </div>
 ...
 ...

如果树上的节点数很大（超过200），自定义JSF组件不应为多于200的节点产生代码。如果节点数超过了200，在装载页面时IE将花费大量时间 去创建这些窗口部件。本文例子应用的自定义JSF组件只创建100个树节点（在根一级上）并在最后显示‘Show more...’选项。当用户选择了‘Show More..’选项，则由DWR负责将剩余的节点信息从数据库中取来。该信息接着被传递给Javascript回调方法以便用程序创建TreeNode窗 口部件。

MyFaces也提供了能产生DOJO树的组件，但是MyFaces组件一次性创建所有节点，这不是好方法，因为当树上的节点数达到上千时Web应用中的组件将变得无法使用。

DWR 和 JSF

DWR要求你创建Java类并将其配置到dwr.xml配置文件中。DWR创建一个Javascritp文件（文件扩展名为.js），该文件的名字是在dwr.xml中配置的

如下dwr.xml配置信息展示了Java类是如何被配置的：

<create creator="jsf" javascript="AjaxBean" scope="request">
 	<param name="managedBeanName" value="ajaxBean" />
 	<param name="class"
 	value="com.somebean.AjaxBean" />
 </create>

 

creator="jsf"

这一句说明Java类被配置为JSF管理bean。该Java类包含所有将由Javascritp调用的AJAX方法。

<param name="managedBeanName" value="ajaxBean" />

这一句说明在faces-config.xml配置文件中管理bean的名字为ajaxBean。

<param name="class"
	value="com. somebean.AjaxBean" /> 

这一句说明所引用的实际Java类。

javascript="AjaxBean"

这一句说明在Javascript代码中以此名称使用Java类。

为了在Javascript中使用AjaxBean，需要用 <script> 标签引入该Javascript。

DWR Java类（DWR Java类就是普通Java类。这些类不用实现任何DWR特定接口或类。）每当收到一个AJAX请求时被实例化。这意味着如果应用程序必须在 AjaxBean类中维护状态，那么当新请求来临时它就被抹掉了。AjaxBean中的方法本质上被预期是无状态的，会话状态必须维护在其他地方。

AJAX请求不是一个PortletRequest，这意味着DWR Java类不用访问PortletSession对象。AJAX请求是简单的HTTP请求，因此，DWR Java类可以访问HttpSession对象。按照Portal规范，要求HttpSession和PortletSession对象应该同步，也就是 说，如果一个属性被增加进PortletSession对象那么它也应被增加进HttpSession对象（不必用相同的名字）。

以JBoss AS为例，当一个管理bean被命名为someManagedBean增加进PortalSession，那么可以通过HttpSession用属性名javax.portlet.p.<portletInstanceName>?someManagedBean 获得相同对象。

在本例子应用中，会话状态被维护在someManagedBean中。DWR Java类从HttpSession对象中获得someManagedBean实例并设置其属性以反映用户当前会话状态。

为了访问业务服务（比如说在Spring层），AjaxBean可以使用Service Locator模式与业务服务交互。

注意 ： JSF管理bean只有在接收到一个face request后才被实例化。因此确认你要用来存储会话状态的JSF管理bean已经收到了一个face request。该管理bean的作用范围应该是‘session’。

HTML模板

使用AJAX工作面临的一个问题是，基于用户动作创建复杂的HTML片段。这通常导致应用的维护成本高昂，经过一段时间，当应用需求精确了，修改用户界面有时甚至也是很困难的。HTML没有tile的概念，但是在本文例子应用了可以做一些类似tile的事情。

<table style="height: 80%; width: 100%; padding-bottom: 100px; visibility: {0};">
     <tr valign="top">
         <td>
             <table align="left" valign="top">
                   <tr>
 	       <td class="formLabel">Product Category:</td>
 	       <td class="formField">{1}</td>
 	  </tr>
 	  <tr>
 	        <td class="formLabel"><span class="required">*</span>Description:</td>
 	        <td class="formField"><textarea rows="2" id="desc_field" cols="80" 
                                  name="desc_field"></textarea></td>
 	   </tr>
 	<table>
 	  <tr>
 	        <td>{dataTable}</td>
 	   </tr>
 	   <tr>
 	        <td>{dataScroller}</td>
 	   </tr>
 	</table>
 	   <tr valign="bottom">
 	       <td align="right" style="padding-right: 50px;">
 	          <table>
 	 	<tr>
     <td><input type="button" class="inputButton" onclick="saveDetails('{2}');" value="Save"/></td>
 		</tr>
 	           </table>
 	      </td>
 	</tr>
 ...
 ...

上面HTML模板文件显示了两类占位符：

1. 数据占位符（Data placeholders）
2. HTML占位符

占位符 {0}、{1} 和 {2} 代表数据占位符，很容易由如下静态方法填充：

public static
 String getStringWithValues(String template, Object[] values) throws
 IncorrectNumberOfValues {
  	for
(int
 i = 0; i < values.length; i++) {
 	     int
 index = template.indexOf("{" + i + "}");
 	     if
(index == -1) {
 throw new
 IncorrectNumberOfValues("The number of values passed is : " + values.length + "
 which doens't match the number of placeholders in : " + template);
 	      } else
 {
 	            if
(values[i] != null
) {
 	                 template = StringUtils.replace(template, "{" + i + "}", values[i].toString());
 	             } else
 {
 	                 template = StringUtils.replace(template, "{" + i + "}", "");
 	             }
                        }
 	   }
           return
 template;
 }

这里， 模板 是需要被解析并用值数组中的值替换占位符的html模板。因此，数据占位符{0}被值数组中的第一个元素替换，数据占位符{1}被值数组中的第二个元素替换，以此类推。

占位符 {dataTable} 和 {dataScroller}代表HTML占位符，要求被一个HTML片段替换。{dataTable} 占位符应该被数据表格所替换，该数据表格显示对应于所属某产品分类的每一个产品记录。对应于 {dataTable} 的HTML是另一个HTML模板。有两种将HTML占位符替换为相应HTLM模板的方法：

1. 编程：在ajax bean内部，占位符可以被HTML替换。这种方法不需要创建任何类型的框架。
2. 在properties文件或XML文档中创建占位符和HTML模板之间的映射。例如，一个properties文件可能被创建包含如下 映射： {dataTable} = /WEB-INF/classes/templates/dataTableTemplate.html {dataScroller} = /WEB-INF/classes/templates/dataScroller.html

运行时这些占位符被相应模板替换。该方法要求创建一个小框架，从properties文件读取信息并解析HTML模板以使相应的HTML文件替换HTML占位符。

DWR bean 转换器

Web应用通常使用DTO从Web层往服务层传递信息。本文例子应用使用另一级别的DTO，从Javascript往Web层传递信息。例如，当搜 索产品时，用户可以输入如下信息：产品名称，产品编码、产品id已经相应的搜索类型（LIKE 或 EQUALS）。利用DTO，这些参数被传递到例子应用的Web层。Javascript中的关联数组（associative array —— 也称为命名数组）的概念被用来设置这些参数，接着DWR把这些关联数组转换到相应的DTO。关联数组中的名称必须与DTO中的属性名字匹配。

下面dwr.xml的配置信息展示了如何配置一个DTO：

<convert match="com.search.product.SearchCriteria" converter="bean"/>

使用这种方法使服务器端Java代码更整洁，因为你不必再显式地获取来自AJAX请求的每个请求参数值。

JSF的rendered 属性

所有JSF HTML标签都有一个rendered属性，该布尔值决定了HTML窗口部件是否将显示给用户。当使用HTML模板时，可以达成同样的功能。这将要求创建一个表达式框架来处理在HTML中的表达式并显示/隐藏一个HTML片段。

<exp:if value="someManagedBean.permissions.save">
       <td><input type="button" class="inputButton" onclick="removeProduct('{0}');" value="Remove" /></td>
 </exp:if>

用于导航的 FacesRequest 或 HttpServletRequest

当用户点击产品详细信息页面上的back按钮时，产品搜索页面需要被显示。如果点击back按钮使用AJAX来处理，那么应用程序没有利用到定义在 faces-config.xml文件中的导航规则。因此，在产品详细信息页面上使用JSF的HTML按钮组件，而不是使用发起 HttpServletRequest（或AJAX请求）给服务器用以导航至另一个页面的HTML按钮，是一个不错的主意。

值得考虑的备选方案

Ajax4jsf

Ajax4jsf 为JSF组件提供了使用AJAX的方法，但是对Portlet支持在1.1.1版中提供。在创建例子应用的时候ajax4jsf还不支持Portlet。

基于HTML和CSS的树

联合使用 <li> HTML元素和CSS创建一个树形结构是可行的。但是这种树结构缺乏任何类型的事件处理模型，因此不适合高交互性的树窗口部件的要求。

RichFaces

RichFaces提供了带有AJAX功能的、丰富的JSF组件。RichFaces利用Ajax4jsf完成其AJAX功能。

关于作者

Ashish Sarin在开发/设计基于Java的Web应用程序方面已经有8年的经验。

参考文献

Dojo
Dojo是一个用Javascript写的开源DHTML工具包。更多信息请参考http://www.dojotoolkit.org/about 。

DWR
DWR —— Direct Web Reporting 使得在Java应用中使用Ajax更容易。更多信息请参考http://getahead.org/dwr/documentation 。

RichFaces
http://labs.jboss.com/jbossrichfaces/ .

Ajax4jsf
http://labs.jboss.com/jbossajax4jsf/ .

Facelets
https://facelets.dev.java.net/ .