BlogJava-绿野仙棕-文章分类-jsf技术

JSF DataTable 学习（2）

土牛小屋 — Thu, 28 Sep 2006 04:12:00 GMT

h:dataTable标签用来生成表格，感觉就和struts的logic：iterator差不多，下面是一般的用法：

其中这个items可以是一个集合(其类型可以是array、java.util.List、java.sql.ResultSet、javax.servlet.jsp.jstl.sql.Result、javax.faces.model.DataModel，循环遍历所有的item），或者是其他任何非集合的元素（循环一次）。
注意1）h:dataTable里面只能包含h:column。2）在h:dataTable这种能render子元素的标签中，要显示原始文本的话，要用将文本包含起来（或者用h:outputText）。3）和可以制定表头和表尾。

h:dataTable有以下这些属性：

bgcolor
Background color for the table

border
Width of the table's border

cellpadding
Padding around table cells

cellspacing
Spacing between table cells

columnClasses
Comma-separated list of CSS classes for columns

first
Index of the first row shown in the table

footerClass
CSS class for the table footer

frame
Specification for sides of the frame surrounding the table should be drawn; valid values: none, above, below, hsides, vsides, lhs, rhs, box, border

headerClass
CSS class for the table header

rowClasses
Comma-separated list of CSS classes for columns

rules
Specification for lines drawn between cells; valid values: groups, rows, columns, all

summary
Summary of the table's purpose and structure used for non-visual feedback such as speech

var
The name of the variable created by the data table that represents the current item in the value

binding, id, rendered, styleClass, value
Basic attributes

dir, lang, style, title, width
HTML 4.0

onclick, ondblclick, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup
DHTML events

有一个很有意思的例子，它可以生成一个动态可编辑的表格：

事实上，h:dataTable不是直接操作集合对象的，而是通过Table Models来实现的。所以我们可以通过getWrappedData()和setWrappedData（）来实现对modle中对象的操作，比如下面的一个方法：

1 public String deleteNames() {
2
3      if ( ! getAnyNamesMarkedForDeletion())
4
5          return null ;
6
7
8
9     Name[] currentNames = (Name[]) model.getWrappedData();
10
11     Name[] newNames = new Name[currentNames.length -
12
13         getNumberOfNamesMarkedForDeletion()];
14
15
16
17      for ( int i = 0 , j = 0 ; i < currentNames.length; ++ i) {
18
19         Name name = (Name) currentNames[i];
20
21              if ( ! name.isMarkedForDeletion()) {
22
23             newNames[j ++ ] = name;
24
25         }
26
27     }
28
29     model.setWrappedData(newNames);
30
31      return null ;
32
33    }
34
35 }
36
37

同时如果我们要对集合数据进行排序和过滤的话，我们必须通过继承一种table model来实现。

土牛小屋 2006-09-28 12:12 发表评论

事件处理

土牛小屋 — Thu, 28 Sep 2006 02:32:00 GMT

JSP应用程序是事件驱动型的程序。在JSF中处理事件令人惊奇的简单。以下是处理步骤：

编写事件监听器。
在程序目录下的WEB-INF/classes or WEB-INF/lib目录中部署事件监听器。
在表示组件（其事件被捕获）的标记中，使用Core定制标记库中定义的action_listener或者 valuechange_listener标记。

在JSF中的事件对象。 JSF中的所有事件对象必须提供javax.faces .event.FacesEvent类，以便这些事件被请求处理生命周期支持。FacesEvent类是java.util.EventObject的子类，并添加了getComponent方法，该方法返回引发该事件的UIComponent组件。

FacesEvent类有两个子类：ActionEvent和 ValueChangeEvent。ActionEvent类激活诸如UICommand组件之类的UI组件。

ValueChangeEvent类会发出一个通知，告知本地UIInput组件的值被修改了。然而，如果新值没有被成功地验证为合法的，则不会发出ValueChangeEvent通知。被加入到该类中的两个重要方法是getOldValue 和 getNewValue。getOldValue方法返回引发该事件的组件的旧值。getNewValue方法返回相应的新值。这两种方法的返回值类型都是java .lang.Object。
第三，JSF中的事件监听器。

为捕获一个JSF事件，需要使用一个事件监听器。JSF程序中的所有监听器都必须实现javax.faces.event.FacesListener接口。该接口提供java.util.EventListener接口，后者是必须由所有Java事件监听器实现的接口。

Faces Listener接口有两个子接口：ActionListener 和 ValueChangeListener。ActionListener接口是为了捕获ActionEvent而必须被实现的接口。该接口添加了一个新的方法--processAction--该方法请求处理生命周期来调用。当为之注册了ActionListener 的ActionEvent发生事件时，就会调用processAction。processAction方法的代码如下：

				
						1
						
						public
						 
						void
						 processAction(ActionEvent 

						2
						
								  event) 

						3
						
								 
						throws
						 AbortProcessingException

						4

ValueChangeListener接口是为了捕获ValueChangeEvent而实现的接口。该接口添加了一个方法：processValueChange。当ValueChangeEvent动作被其监听者监听到时，就会调用processValueChange方法。processValueChange方法的代码如下：

				
						1
						
						public
						 
						void
						 processValueChange(ValueChangeEvent

						2
						
								  event) 

						3
						
								
						
						throws
						 AbortProcessingException

						4
						
								
								

						
						5

土牛小屋 2006-09-28 10:32 发表评论

在JSP页面中使用UI组件

土牛小屋 — Thu, 28 Sep 2006 02:29:00 GMT

JSF提供两个定制标记库来帮助用户快速编写Web应用程序：HTML和Core。HTML定制标记库定义了用来表示UI组件的标记。Core定制标记库使用具有组件的验证器（validators）定义了注册事件处理器的核心行动，以及其他一些行动。你可以在自己的JSF应用程序的JSP页面中使用这两个库的标记。

为了在JSP页面中使用HTML和Core定制标记库，必须在页面中包含如下所示的taglib指令：

<%@ taglib uri="http://java.sun.com
/jsf/html/" prefix="h" %>
<%@ taglib uri="http://java.sun.com/
jsf/core/" prefix="f" %>

Prefix的属性值可以是任意值。但是，根据惯例，最好是使用"h"和"f"。

在JSF应用程序中编写JSP页面是每一个页面制作者的责任。除了布置组件之外，他们的责任还包括把组件绑定到模型对象数据并且把Core标记（诸如事件监听器和验证器）添加到组件标记中。

在HTML定制标记库中有25个标记。每个组件都呈现为一个HTML元件，而多个标记被呈现为同一个HTML元件。表1列出了HTML定制标记库中的标记。

1 标记说明
2 Column 在UIData组件内表示一个数据列。
3 command_button 表示一个向服务器提交表单的按钮。
4 command_link 表示一个指向另一页面或者本页面内其他位置的超链接。
5 data_table 表示一个支持将数据绑定到一个数据对象的集合上的表。
6 Form 表示一个表单。
7 graphic_image 显示一张图片。
8 input_hidden 表示一个隐藏的元件。
9 input_secret 表示一个密码输入框。
10 input_text 表示一个可接受单个字符串的文本输入框。
11 input_textarea 表示一个可接受多个字符串的文本输入区。
12 Message 显示给定组件的信息。
13 Messages 表示一个从FacesContext中获取消息并且将其显示给用户的组件。
14 output_label 显示文本。
15 output_link 显示一个超链接。
16 output_message 显示给定组件的信息。
17 output_text 显示一行文本。
18 panel_grid 显示一张表。
19 panel_group 将一个组件集合分组。
20 selectboolean_checkbox 表示一个单选文本框。
21 selectmany_checkboxlist 显示一套复选框，用户从中可以选择多个值。
22 selectmany_listbox 表示一个多选下拉选择框，用户从中可以选择多个项目。
23 selectmany_menu 表示一个多选项目列表，用户从中可以选择多个项目。
24 selectone_listbox 表示一个单选下拉选择框，用户从中只能选择一个项目。
25 selectone_menu 表示单选项目列表，用户从中只能选择一个项目。
26 selectone_radio 表示一套单选按钮。
27

表1. HTML定制标记库

土牛小屋 2006-09-28 10:29 发表评论