JAVA开发精彩教程：JSF系列(一)
来源：互联网 发布：董洁的长相知乎 编辑：程序博客网 时间：2024/04/30 14:36
JAVA开发精彩教程：JSF系列(一) 出处：PConline责任编辑：chenyong
[03-10-21 15:34] 作者：fpwang/Matrix.com
Java Server Faces（JSF）技术为开发基于网络用户界面的Java开发者提供了标准的编程接口API以及标记库。Apache Struts框架的作者Craig McClanahan，协助领导了Sun公司的JSF项目。这使项目能够容易的从流行的Apache向JSF标准移植得到了保证。就像Struts框架一样，JSF定义了一套JSP标记，能够生成与JavaBean属性绑定在一起的HTML表单元素。从应用开发者的角度看，两种框架是很相似的，但是JSF可能将会得到更多的支持。因为JSF是Java的标准。在未来的发展中，有可能所有的J2EE应用服务器都需要支持JSF（Java Server Faces）。
Sun公司在已经发布的免费下载开发包Java Web Services Developer Pack 1.2 （ http://java.sun.com/webservices/downloads/webservicespack.html）中，包括了JSF详细说明（JSF Specification Version 1.0, Public Review Draft 2）的参考实现（Early Access 4 — EA4）。EA4版本实现了许多新特性：动作、beans管理和导航规则。本文将集中介绍这些新特性以及展示如何从JSF的开发中得到好处以便建立表单，确认用户输入以及将用户界面组件与JavaBean属性绑定起来。
本文包含一个由四个主要部分组成的网络应用：
1. JavaBean类（PBean.java），作为数据模型保存一些文本以及相关属性：字体、大小、 颜色、摆放位置等；
2. 基于JSF的表单（edit.jsp），使用户可以为JavaBean的属性赋值；
3. Java类（PBuilder.java），用给定的文本按照其属性值生成HTML页面程序；
4. JSP页面（view.jsp），显示生成的HTML页面。
注：
源代码下载地址： http://www.onjava.com/onjava/2003/09/03/examples/usingjsf-src.zip
相关文档
原文：Introducing JavaServer Faces（ http://www.onjava.com/pub/a/onjava/2003/07/30/jsf_intro.html）
译文： http://www.matrix.org.cn/forum_view.asp?forum_id=14&view_id=658
JavaServer Faces（或者叫JSF）是服务端程序开发新的发展趋势。它可以使你更轻松的的设计程序，你的程序也能够更容易维护，甚至可能还会使你的工作更有趣。Budi Kurniawan向我们展示了JSF技术，解释了为什么JSF如此有用以及它是否实现了所承诺的功能。
图1：基于JSF的表单
制作JSF表单
当你开发网络应用时，处理HTML表单是最常见的一项任务。一个好的框架能够节省很多开发时间，因为许多日常的程序操作可以自动的完成或是减少到最低限度只需要在XML文件中用几行完成。这也有可能简化使用JSP标记库的网络开发。Java Server Faces框架提供了JSP标记，用于描述表单、管理表单状态、确认用户输入以及报错、将用户界面组件与JavaBean属性绑定在一起以及其他许多可提高开发效率的功能。JSF也有丰富的编程接口可用于建立定制的用户界面（UI）组件，定制验证类（验证器validator）以及服务端的事件监听器。
JSF包含两类标记库分别叫JSF核心库与HTML基础库。前者提供普通的标记和一些用于在用户界面组件中注册验证器以及事件监听器的标记。后者包含用于描述用户界面组件的JSP标记，如：按钮、文本域、复选按钮、列表等。文件edit.jsp用这些标记建立了表单。两种标记库的标准前缀是f和h，并且定义在edit.jsp文件的最前面：
<%@ taglib prefix="f" uri=" http://java.sun.com/jsf/core"; %> <%@ taglib prefix="h" uri=" http://java.sun.com/jsf/html"; %>
<f:use_faces>标记是容器标记，必须包含所有在同一页面中出现的JSF标记。该标记不会产生任何HTML内容，但是它会触发JSF的内部机制。<h:form>标记产生能够包含用户界面元素的HTML元素<form>。
<html><head><title>Edit</title></head><body> <f:use_faces> <h:form formName="pform"> .......... </h:form></f:use_faces> </body></html>
上面的JSP代码生成下面的HTML片断：
<html><head><title>Edit</title></head><body> <form method="post" action="/usingjsf/faces/edit.jsp"> .......... </form></body></html>
下一部分介绍应用的JavaBean模型。
管理Bean
像其他一些Web框架一样，JSF将用户界面从封装数据以及应用逻辑的对象模型中分离出来。当HTML用户界面由JSF标记产生时，JSF框架从JavaBean模型获得数据并设置HTML表单用户界面组件的属性状态。用户提交表单时，JSF验证用户输入，如果全部正常JSF就将用户输入保存到JavaBean模型并且HTTP请求会根据“导航规则”进入下一页面。如果验证出现错误，JSF回到表单并返回错误信息，这样用户就可以纠正错误输入。
类Pbean遵循JavaBean规范，实现了java.io.Serializable并为其属性（文本、大小、字体、颜色、摆放位置、粗体、斜体、下划线）提供了相应的get及set方法。JSF每一个应用的用户都创建了一个PBean的实例，该实例存储在JSP的会话（session）中并在名为faces-config.xml的XML格式配置文件中指定ID。JSF也会根据faces-config.xml文件提供的数据初始化JavaBean实例的属性值。该XML文件还可能包含其他JSF配置参数，如：导航规则，我们将在后面的章节介绍。
下面的XML程序片断包含由JSF所管理的JavaBean的声明：
<?xml version="1.0"?> <!DOCTYPE faces-config PUBLIC "-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.0//EN" " http://java.sun.com/dtd/web-facesconfig_1_0.dtd";> <faces-config> .......... <managed-bean> <managed-bean-name>pbean</managed-bean-name> <managed-bean-class> com.devsphere.articles.usingjsf.PBean </managed-bean-class> <managed-bean-scope>session</managed-bean-scope> <managed-property> <property-name>text</property-name> <null-value/> </managed-property> <managed-property> <property-name>size</property-name> <value>3</value> </managed-property> <managed-property> <property-name>font</property-name> <values> <value>Arial</value> <value>Courier New</value> </values> </managed-property> <managed-property> <property-name>color</property-name> <value>green</value> </managed-property> <managed-property> <property-name>align</property-name> <value>left</value> </managed-property> <managed-property> <property-name>bold</property-name> <value>false</value> </managed-property> <managed-property> <property-name>italic</property-name> <value>true</value> </managed-property> <managed-property> <property-name>underline</property-name> <value>false</value> </managed-property> </managed-bean></faces-config>
由JSF创建的管理bean能够根据<managed-bean-scope>元素的值而存储在请求（request）、会话（session）或应用的范围内。<managed-bean-scope>元素的值可为空值。如果一个对象已经指定了ID并注册在给定的范围内那么JSF不会建立JavaBean实例。
用户界面组件与验证
文件edit.jsp中的<h:form>元素包含多个用户界面组件，我们将会在后面详细地介绍。各组件的HTML代码都是由JSF组件标记产生，例如：<h:input_textarea>，该标记中可能还会包含其他JSF标记，如：<f:validate_required>标记，该标记使JSF确认用户输入了信息。
处理用户输入的组件使用属性valueRef="pbean.property"与JavaBean属性绑定起来。JSF获得和设置管理bean属性值已在前面介绍了。
有的JSF组件标记不会处理任何用户输入。例如<h:output_text>可用于输出文本或JavaBean只读属性的值。
每个组件都有唯一的ID，ID可在id属性中指定或由JSF自动生成。要进行验证的用户界面组件需要id属性以便验证错误能够与<h:output_errors for="id"/>一起显示打印出来。
图2：验证错误
文本域Text Area
JSF表单的文本域让用户输入将会由Pbuilder.java生成并由view.jsp显示的某些文字段落等内容。edit.jsp显示一个由<h:output_text>确定的标签并使用<h:input_textarea>生成3行30列的<textarea>HTML元素。<f:validate_required>标记注册一个JSF验证器，如果用户在文本域中的输入为空则发出错误信号。错误信息将显示在<h:output_errors>标记的位置，除了显示错误外该标记不会做其他任何操作。<h:output_errors>标记的for属性值与<h:input_textarea>的id属性值相同。
<f:use_faces> <h:form formName="pform"> <p><h:output_text value="Text:"/><br> <h:input_textarea id="text" valueRef="pbean.text" rows="3" cols="30"> <f:validate_required/> </h:input_textarea> <br><h:output_errors for="text"/> .......... </h:form></f:use_faces>
上面的JSP代码生成下面的HTML片断：
<form method="post" action="/usingjsf/faces/edit.jsp"> <p>Text:<br> <textarea name="text" cols="30" rows="3">JavaServer Faces</textarea> <br> ..........</form>
<h:input_textarea>的属性valueRef="pbean.text"使JSF查找ID为pbean的JavaBean实例，并且将用户输入的文本存储到JavaBean实例的text属性中。当HTML的表单被生成后，JSF会将text属性值插入到<textarea>HTML元素中。类Pbean实现了get和set方法可让JSF获得或修改属性的值：
public class PBean implements java.io.Serializable { private String text; public String getText() { return text; } public void setText(String text) { this.text = text; } .......... }
除了<h:input_textarea>，JSF还提供了许多生成单行文本域（text field）的标记：
<intput_text>
<h:input_number>
<input_secret>（密码输入）
<input_date>
<input_datetime>
<input_time>
<input_hidden>可被用于隐藏的表单域
单行文本域（Text Field）
edit.jsp文件的单行文本域组件只允许输入1至7之间的数字。由<h:input_number>生成这段HTML代码，该标记包含两个验证器。<f:validate_required>标记在前面已经介绍了。<f:validate_longrange>标记是使验证器确认用户输入的数字在给定的范围之内。如果超出范围，则向用户报告验证错误，错误信息由<h:output_errors>产生。
[code]<f:use_faces>
<h:form formName="pform">
..........
<p><h:output_text value="Size: [1-7]"/><br>
<h:input_number id="size" valueRef="pbean.size" size="2">
<f:validate_required/>
<f:validate_longrange minimum="1" maximum="7"/>
</h:input_number>
<br><h:output_errors for="size"/>
..........
</h:form>
</f:use_faces>
[/code]
上面的JSP代码生成下面的HTML片断：
<form method="post" action="/usingjsf/faces/edit.jsp">
..........
<p>Size: [1-7]<br>
<input type="text" name="sie" id="size" value="3" size="2">
<br>
..........
</form>
单行文本域被定为size，类型为整形（int）。size中value属性的值（3）是表示所生成的HTML表单数字输入区域的初值。假设没有出现验证错误，当JSF收到包含新JavaBean size属性值的用户输入就会刷新JavaBean。<h:input_number>标记的size属性是限定单行文本域的字符长度（2），不会对JavaBean属性有其他操作。
public class PBean implements java.io.Serializable { .......... private int size; public int getSize() { return size; } public void setSize(int size) { this.size = size; } .......... }
除了<f:validate_required>与<f:validate_longrange>标记，JSF还提供了几个验证器标记：
<validate_doublerange>
<validate_stringrange>
<validate_length>
<validator>
最后一个为通用标记，可以用它在用户界面组件中注册你自己的定制验证器。你也能够创建自己的验证器标记库。
列表List Box
<h:selectone_listbox>与<h:selectmany_listbox>标记生成HTML元素<select>，网页浏览器会将<select>显示为列表。前者允许用户进行单项选择，后者用于多项选择。
文件edit.jsp使用<h:selectmany_listbox>标记生成一个含有几个字体名称的列表。HTML的<option>元素定义列表中的选项，这由JSF标记<h:selectitem>生成：
<f:use_faces> <h:form formName="pform"> .......... <p><h:output_text value="Font:"/><br> <h:selectmany_listbox id="font" valueRef="pbean.font"> <h:selectitem itemvalue="Arial" itemLabel="Arial"/> <h:selectitem itemvalue="Courier New" itemLabel="Courier New"/> <h:selectitem itemvalue="Times New Roman" itemLabel="Times New Roman"/> </h:selectmany_listbox> .......... </h:form></f:use_faces>
上面的代码生成下面的HTML片断：
<form method="post" action="/usingjsf/faces/edit.jsp"> .......... <p>Font:<br> <select name="font" multiple size="3"> <option value="Arial" selected>Arial</option> <option value="Courier New" selected>Courier New</option> <option value="Times New Roman">Times New Roman</option> </select> ..........</form>
列表被定义为font，类型为字符串数组（String[]）。第一个getFont()方法使用clone()方法复制内部的数组并将其返回，内部数组必须从外部访问中得到保护。第一个setFont()方法用clone()方法复制所提供的数组并保存起来，所提供的数组可被第二个setFont()方法修改。
public class PBean implements java.io.Serializable {
..........
private String fontArray[];
public String[] getFont() {
return (String[]) fontArray. clone();
}
public void setFont(String fontArray[]) {
this.fontArray = (String[]) fontArray.clone();
}
public String getFont(int index) {
return fontArray[index];
}
public void setFont(int index, String font) {
if (fontArray == null)
fontArray = new String[index+1];
else if (fontArray.length <= index) {
String oldFontArray[] = fontArray;
fontArray = new String[index+1];
for (int i = 0; i < oldFontArray.length; i++)
fontArray[i] = oldFontArray[i];
}
fontArray[index] = font;
}
..........
}
下拉列表（Drop-Down List）
<h:selectone_menu>标记用于生成包含几个颜色选项的下拉列表。
<h:selectitem>标记包含在<h:selectone_menu>中，作为下拉列表的选项：
<f:use_faces> <h:form formName="pform"> .......... <p><h:output_text value="Color:"/><br> <h:selectone_menu id="color" valueRef="pbean.color"> <f:validate_required/> <h:selectitem itemvalue="black" itemLabel="Black"/> <h:selectitem itemvalue="red" itemLabel="Red"/> <h:selectitem itemvalue="blue" itemLabel="Blue"/> <h:selectitem itemvalue="green" itemLabel="Green"/> </h:selectone_menu> <br><h:output_errors for="color"/> .......... </h:form></f:use_faces>
上面的JSP代码生成下面的HTML片断：
<form method="post" action="/usingjsf/faces/edit.jsp"> .......... <p>Color:<br> <select name="color" size="1"> <option value="black">Black</option> <option value="red">Red</option> <option value="blue">Blue</option> <option value="green" selected>Green</option> </select> <br> ..........</form>
下拉列表定义为color，类型为字符串（String）：
public class PBean implements java.io.Serializable { .......... private String color; public String getColor() { return color; } public void setColor(String color) { this.color = color; } .......... }
当HTML表单被生成时，JSF将HTML属性selected加入到值与JavaBean模型color属性相同的列表项中。假设没有验证错误，JSF收到包含新颜色值的用户输入后会刷新JavaBean属性。
单选钮（Radio Button）
<h:selectone_radio>与<h:selectitem>标记用于生成一组单选钮：
<f:use_faces> <h:form formName="pform"> .......... <p><h:output_text value="Alignment:"/><br> <h:selectone_radio id="align" valueRef="pbean.align" layout="LINE_DIRECTION"> <f:validate_required/> <h:selectitem itemvalue="left" itemLabel="Left"/> <h:selectitem itemvalue="center" itemLabel="Center"/> <h:selectitem itemvalue="right" itemLabel="Right"/> </h:selectone_radio> <br><h:output_errors for="align"/> .......... </h:form></f:use_faces>
上面的JSP代码生成如下代码：
<form method="post" action="/usingjsf/faces/edit.jsp"> .......... <p>Alignment:<br> <table border="0"> <tr> <td><input type="radio" checked name="align" value="left"> Left</td> &nbp; <td><input type="radio" name="align" value="center"> Center</td> <td><input type="radio" name="align" value="right"> Right</td> </tr> </table> <br> ..........</form>
单选钮定义为align：
public class PBean implements java.io.Serializable { .......... private String align; public String getAlign() { return align; } public void setAlign(String align) { this.align = align; } .......... }
HTML表单生成时，JSF将HTML属性checked加入到与JavaBean模型的align属性值相同的单选钮中。假如没有验证错误，JSF收到新摆放位置的用户输入时刷新JavaBean属性。
复选钮（Checkbox）
文件edit.jsp包含3个由<h:selectboolean_checkbox>标记生成的复选钮。这些界面组件包含在由<h:panel_grid>与<h:panel_group>标记生成的表格（table）中：
<f:use_faces> <h:form formName="pform"> .......... <p><h:output_text value="Style:"/><br> <h:panel_grid columns="3" border="0" cellspacing="5"> <h:panel_group> <h:selectboolean_checkbox id="bold" valueRef="pbean.bold"/> <h:output_text value="Bold"/> </h:panel_group> <h:panel_group> <h:selectboolean_checkbox id="italic" valueRef="pbean.italic"/> <h:output_text value="Italic"/> </h:panel_group> <h:panel_group> <h:selectboolean_checkbox id="underline" valueRef="pbean.underline"/> <h:output_text value="Underline"/> </h:panel_group> </h:panel_grid> .......... </h:form></f:use_faces>
上面代码生成如下片断：
<form method="post" action="/usingjsf/faces/edit.jsp"> .......... <p>Style:<br> <table border="0" cellspacing="5"> <tr> <td><input type="checkbox" name="bold">Bold</td> <td><input type="checkbox" name="italic" checked>Italic</td> <td><input type="checkbox" name="underline">Underline</td> </tr> </table> ..........</form>
3个复选钮分别与类型为布尔（Boolean）的bold、italic、underline绑定在一起：
public class PBean implements java.io.Serializable { .......... private boolean bold; public boolean isBold() { return bold; } public void setBold(boolean bold) { this.bold = bold; } private boolean italic; public boolean isItalic() { return italic; } public void setItalic(boolean italic) { this.italic = italic; } private boolean underline; public boolean isUnderline() { return underline; } public void setUnderline(boolean underline) { this.underline = underline; } .......... }
生成HTML表单时，JSF将checked属性加入到每一个JavaBean属性为真（true）的复选钮中。假如没有验证错误，JSF收到用户输入后就会刷新JavaBean属性。
在本例中，复选钮是分别独立生成的。JSF也提供了<h:selectmany_checkboxlist>标记用于生成一组复选钮。还提供了<h:panel_list>和<h:panel_data>两个标记用于从集合与数组中生成表格。
命令按钮（Command Buttons）
文件faces-config.xml定义了导航规则，决定JSF在用户点击网页中的命令按钮时做什么，网页的路径由<from-tree-id>标记（/edit.jsp）指定。由<navigation-case>元素分别定义了两个导航块（navigation case）：
..........<faces-config> <navigation-rule> <from-tree-id>/edit.jsp</from-tree-id> <navigation-case> <from-outcome>editOutcome</from-outcome> <to-tree-id>/edit.jsp</to-tree-id> </navigation-case> <navigation-case> <from-outcome>viewOutcome</from-outcome> <to-tree-id>/view.jsp</to-tree-id> </navigation-case> </navigation-rule> ..........</faces-config>
文件edit.jsp包含由标记<h:command_button>生成的两个按钮。每个都有一个标识（ID）、一个标签、一个命令名称（这里没有使用，但JSF需要）以及一个action或actionRef属性：
<f:use_faces> <h:form formName="pform"> .......... <p> <h:command_button id="view" label="View" commandName="viewCmd" action="viewOutcome"/> <h:command_button id="boldUpperCase" label="Bold Upper Case / View" commandName="boldUpperCaseCmd" actionRef="pbean.boldUpperCaseAction"/> </h:form></f:use_faces>
上面JSP代码生成如下HTML片断：
<form method="post" action="/usingjsf/faces/edit.jsp"> .......... <p> <input type="submit" name="view" value="View"> <input type="submit" name="boldUpperCase" value="Bold Upper Case / View"></form>
JSF会在每次浏览器提交用户输入时验证表单中的数据。如果验证器没有发出错误信号而且没有类型转换错误，JSF便会分析导航块（navigation case）。对于第一个按钮，JSF会得到action属性的值viewOutcome，该值与第二个导航块的<from-outcome>元素中的文本匹配。因此，JSF将HTTP请求转发给view.jsp，文件view.jsp的路径包含在第二个导航块的<to-tree-id>元素中。
当用户点击第二个按钮时，JSF则调用PBean对象的getBoldUpperCaseAction()方法。该方法返回一个BoldUpperCaseAction的实例，BoldUpperCaseAction则是PBean的内部类。接着，JSF调用invoke()方法，该方法返回一个在运行时决定的结果而不是固定不变的HTML文件：
public class PBean implements java.io.erializable { .......... public BoldUpperCaseAction getBoldUpperCaseAction() { return new BoldUpperCaseAction(); } public class BoldUpperCaseAction extends javax.faces.application.Action { public String invoke() { String ucText = getText().toUpperCase(); if (isBold() && getText().equals(ucText)) return "viewOutcome"; else { setBold(true); setText(ucText); return "editOutcome"; } } } }
如果bold（粗体）属性的值为true（真）并且文本的所有字符为大写的，JSF就按照第二个导航块中的定义，与另一个按钮情况一样JSF将HTTP请求转发给view.jsp。另外，invoke()方法会将bold属性设为true，并将文本的所有字符改为大写的，最后返回字符串editOutcome，使JSF按照第一个导航块的定义，保持edit.jsp为当前页。
[03-10-21 15:34] 作者：fpwang/Matrix.com
Java Server Faces（JSF）技术为开发基于网络用户界面的Java开发者提供了标准的编程接口API以及标记库。Apache Struts框架的作者Craig McClanahan，协助领导了Sun公司的JSF项目。这使项目能够容易的从流行的Apache向JSF标准移植得到了保证。就像Struts框架一样，JSF定义了一套JSP标记，能够生成与JavaBean属性绑定在一起的HTML表单元素。从应用开发者的角度看，两种框架是很相似的，但是JSF可能将会得到更多的支持。因为JSF是Java的标准。在未来的发展中，有可能所有的J2EE应用服务器都需要支持JSF（Java Server Faces）。
Sun公司在已经发布的免费下载开发包Java Web Services Developer Pack 1.2 （ http://java.sun.com/webservices/downloads/webservicespack.html）中，包括了JSF详细说明（JSF Specification Version 1.0, Public Review Draft 2）的参考实现（Early Access 4 — EA4）。EA4版本实现了许多新特性：动作、beans管理和导航规则。本文将集中介绍这些新特性以及展示如何从JSF的开发中得到好处以便建立表单，确认用户输入以及将用户界面组件与JavaBean属性绑定起来。
本文包含一个由四个主要部分组成的网络应用：
1. JavaBean类（PBean.java），作为数据模型保存一些文本以及相关属性：字体、大小、 颜色、摆放位置等；
2. 基于JSF的表单（edit.jsp），使用户可以为JavaBean的属性赋值；
3. Java类（PBuilder.java），用给定的文本按照其属性值生成HTML页面程序；
4. JSP页面（view.jsp），显示生成的HTML页面。
注：
源代码下载地址： http://www.onjava.com/onjava/2003/09/03/examples/usingjsf-src.zip
相关文档
原文：Introducing JavaServer Faces（ http://www.onjava.com/pub/a/onjava/2003/07/30/jsf_intro.html）
译文： http://www.matrix.org.cn/forum_view.asp?forum_id=14&view_id=658
JavaServer Faces（或者叫JSF）是服务端程序开发新的发展趋势。它可以使你更轻松的的设计程序，你的程序也能够更容易维护，甚至可能还会使你的工作更有趣。Budi Kurniawan向我们展示了JSF技术，解释了为什么JSF如此有用以及它是否实现了所承诺的功能。
图1：基于JSF的表单
制作JSF表单
当你开发网络应用时，处理HTML表单是最常见的一项任务。一个好的框架能够节省很多开发时间，因为许多日常的程序操作可以自动的完成或是减少到最低限度只需要在XML文件中用几行完成。这也有可能简化使用JSP标记库的网络开发。Java Server Faces框架提供了JSP标记，用于描述表单、管理表单状态、确认用户输入以及报错、将用户界面组件与JavaBean属性绑定在一起以及其他许多可提高开发效率的功能。JSF也有丰富的编程接口可用于建立定制的用户界面（UI）组件，定制验证类（验证器validator）以及服务端的事件监听器。
JSF包含两类标记库分别叫JSF核心库与HTML基础库。前者提供普通的标记和一些用于在用户界面组件中注册验证器以及事件监听器的标记。后者包含用于描述用户界面组件的JSP标记，如：按钮、文本域、复选按钮、列表等。文件edit.jsp用这些标记建立了表单。两种标记库的标准前缀是f和h，并且定义在edit.jsp文件的最前面：
<%@ taglib prefix="f" uri=" http://java.sun.com/jsf/core"; %> <%@ taglib prefix="h" uri=" http://java.sun.com/jsf/html"; %>
<f:use_faces>标记是容器标记，必须包含所有在同一页面中出现的JSF标记。该标记不会产生任何HTML内容，但是它会触发JSF的内部机制。<h:form>标记产生能够包含用户界面元素的HTML元素<form>。
<html><head><title>Edit</title></head><body> <f:use_faces> <h:form formName="pform"> .......... </h:form></f:use_faces> </body></html>
上面的JSP代码生成下面的HTML片断：
<html><head><title>Edit</title></head><body> <form method="post" action="/usingjsf/faces/edit.jsp"> .......... </form></body></html>
下一部分介绍应用的JavaBean模型。
管理Bean
像其他一些Web框架一样，JSF将用户界面从封装数据以及应用逻辑的对象模型中分离出来。当HTML用户界面由JSF标记产生时，JSF框架从JavaBean模型获得数据并设置HTML表单用户界面组件的属性状态。用户提交表单时，JSF验证用户输入，如果全部正常JSF就将用户输入保存到JavaBean模型并且HTTP请求会根据“导航规则”进入下一页面。如果验证出现错误，JSF回到表单并返回错误信息，这样用户就可以纠正错误输入。
类Pbean遵循JavaBean规范，实现了java.io.Serializable并为其属性（文本、大小、字体、颜色、摆放位置、粗体、斜体、下划线）提供了相应的get及set方法。JSF每一个应用的用户都创建了一个PBean的实例，该实例存储在JSP的会话（session）中并在名为faces-config.xml的XML格式配置文件中指定ID。JSF也会根据faces-config.xml文件提供的数据初始化JavaBean实例的属性值。该XML文件还可能包含其他JSF配置参数，如：导航规则，我们将在后面的章节介绍。
下面的XML程序片断包含由JSF所管理的JavaBean的声明：
<?xml version="1.0"?> <!DOCTYPE faces-config PUBLIC "-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.0//EN" " http://java.sun.com/dtd/web-facesconfig_1_0.dtd";> <faces-config> .......... <managed-bean> <managed-bean-name>pbean</managed-bean-name> <managed-bean-class> com.devsphere.articles.usingjsf.PBean </managed-bean-class> <managed-bean-scope>session</managed-bean-scope> <managed-property> <property-name>text</property-name> <null-value/> </managed-property> <managed-property> <property-name>size</property-name> <value>3</value> </managed-property> <managed-property> <property-name>font</property-name> <values> <value>Arial</value> <value>Courier New</value> </values> </managed-property> <managed-property> <property-name>color</property-name> <value>green</value> </managed-property> <managed-property> <property-name>align</property-name> <value>left</value> </managed-property> <managed-property> <property-name>bold</property-name> <value>false</value> </managed-property> <managed-property> <property-name>italic</property-name> <value>true</value> </managed-property> <managed-property> <property-name>underline</property-name> <value>false</value> </managed-property> </managed-bean></faces-config>
由JSF创建的管理bean能够根据<managed-bean-scope>元素的值而存储在请求（request）、会话（session）或应用的范围内。<managed-bean-scope>元素的值可为空值。如果一个对象已经指定了ID并注册在给定的范围内那么JSF不会建立JavaBean实例。
用户界面组件与验证
文件edit.jsp中的<h:form>元素包含多个用户界面组件，我们将会在后面详细地介绍。各组件的HTML代码都是由JSF组件标记产生，例如：<h:input_textarea>，该标记中可能还会包含其他JSF标记，如：<f:validate_required>标记，该标记使JSF确认用户输入了信息。
处理用户输入的组件使用属性valueRef="pbean.property"与JavaBean属性绑定起来。JSF获得和设置管理bean属性值已在前面介绍了。
有的JSF组件标记不会处理任何用户输入。例如<h:output_text>可用于输出文本或JavaBean只读属性的值。
每个组件都有唯一的ID，ID可在id属性中指定或由JSF自动生成。要进行验证的用户界面组件需要id属性以便验证错误能够与<h:output_errors for="id"/>一起显示打印出来。
图2：验证错误
文本域Text Area
JSF表单的文本域让用户输入将会由Pbuilder.java生成并由view.jsp显示的某些文字段落等内容。edit.jsp显示一个由<h:output_text>确定的标签并使用<h:input_textarea>生成3行30列的<textarea>HTML元素。<f:validate_required>标记注册一个JSF验证器，如果用户在文本域中的输入为空则发出错误信号。错误信息将显示在<h:output_errors>标记的位置，除了显示错误外该标记不会做其他任何操作。<h:output_errors>标记的for属性值与<h:input_textarea>的id属性值相同。
<f:use_faces> <h:form formName="pform"> <p><h:output_text value="Text:"/><br> <h:input_textarea id="text" valueRef="pbean.text" rows="3" cols="30"> <f:validate_required/> </h:input_textarea> <br><h:output_errors for="text"/> .......... </h:form></f:use_faces>
上面的JSP代码生成下面的HTML片断：
<form method="post" action="/usingjsf/faces/edit.jsp"> <p>Text:<br> <textarea name="text" cols="30" rows="3">JavaServer Faces</textarea> <br> ..........</form>
<h:input_textarea>的属性valueRef="pbean.text"使JSF查找ID为pbean的JavaBean实例，并且将用户输入的文本存储到JavaBean实例的text属性中。当HTML的表单被生成后，JSF会将text属性值插入到<textarea>HTML元素中。类Pbean实现了get和set方法可让JSF获得或修改属性的值：
public class PBean implements java.io.Serializable { private String text; public String getText() { return text; } public void setText(String text) { this.text = text; } .......... }
除了<h:input_textarea>，JSF还提供了许多生成单行文本域（text field）的标记：
<intput_text>
<h:input_number>
<input_secret>（密码输入）
<input_date>
<input_datetime>
<input_time>
<input_hidden>可被用于隐藏的表单域
单行文本域（Text Field）
edit.jsp文件的单行文本域组件只允许输入1至7之间的数字。由<h:input_number>生成这段HTML代码，该标记包含两个验证器。<f:validate_required>标记在前面已经介绍了。<f:validate_longrange>标记是使验证器确认用户输入的数字在给定的范围之内。如果超出范围，则向用户报告验证错误，错误信息由<h:output_errors>产生。
[code]<f:use_faces>
<h:form formName="pform">
..........
<p><h:output_text value="Size: [1-7]"/><br>
<h:input_number id="size" valueRef="pbean.size" size="2">
<f:validate_required/>
<f:validate_longrange minimum="1" maximum="7"/>
</h:input_number>
<br><h:output_errors for="size"/>
..........
</h:form>
</f:use_faces>
[/code]
上面的JSP代码生成下面的HTML片断：
<form method="post" action="/usingjsf/faces/edit.jsp">
..........
<p>Size: [1-7]<br>
<input type="text" name="sie" id="size" value="3" size="2">
<br>
..........
</form>
单行文本域被定为size，类型为整形（int）。size中value属性的值（3）是表示所生成的HTML表单数字输入区域的初值。假设没有出现验证错误，当JSF收到包含新JavaBean size属性值的用户输入就会刷新JavaBean。<h:input_number>标记的size属性是限定单行文本域的字符长度（2），不会对JavaBean属性有其他操作。
public class PBean implements java.io.Serializable { .......... private int size; public int getSize() { return size; } public void setSize(int size) { this.size = size; } .......... }
除了<f:validate_required>与<f:validate_longrange>标记，JSF还提供了几个验证器标记：
<validate_doublerange>
<validate_stringrange>
<validate_length>
<validator>
最后一个为通用标记，可以用它在用户界面组件中注册你自己的定制验证器。你也能够创建自己的验证器标记库。
列表List Box
<h:selectone_listbox>与<h:selectmany_listbox>标记生成HTML元素<select>，网页浏览器会将<select>显示为列表。前者允许用户进行单项选择，后者用于多项选择。
文件edit.jsp使用<h:selectmany_listbox>标记生成一个含有几个字体名称的列表。HTML的<option>元素定义列表中的选项，这由JSF标记<h:selectitem>生成：
<f:use_faces> <h:form formName="pform"> .......... <p><h:output_text value="Font:"/><br> <h:selectmany_listbox id="font" valueRef="pbean.font"> <h:selectitem itemvalue="Arial" itemLabel="Arial"/> <h:selectitem itemvalue="Courier New" itemLabel="Courier New"/> <h:selectitem itemvalue="Times New Roman" itemLabel="Times New Roman"/> </h:selectmany_listbox> .......... </h:form></f:use_faces>
上面的代码生成下面的HTML片断：
<form method="post" action="/usingjsf/faces/edit.jsp"> .......... <p>Font:<br> <select name="font" multiple size="3"> <option value="Arial" selected>Arial</option> <option value="Courier New" selected>Courier New</option> <option value="Times New Roman">Times New Roman</option> </select> ..........</form>
列表被定义为font，类型为字符串数组（String[]）。第一个getFont()方法使用clone()方法复制内部的数组并将其返回，内部数组必须从外部访问中得到保护。第一个setFont()方法用clone()方法复制所提供的数组并保存起来，所提供的数组可被第二个setFont()方法修改。
public class PBean implements java.io.Serializable {
..........
private String fontArray[];
public String[] getFont() {
return (String[]) fontArray. clone();
}
public void setFont(String fontArray[]) {
this.fontArray = (String[]) fontArray.clone();
}
public String getFont(int index) {
return fontArray[index];
}
public void setFont(int index, String font) {
if (fontArray == null)
fontArray = new String[index+1];
else if (fontArray.length <= index) {
String oldFontArray[] = fontArray;
fontArray = new String[index+1];
for (int i = 0; i < oldFontArray.length; i++)
fontArray[i] = oldFontArray[i];
}
fontArray[index] = font;
}
..........
}
下拉列表（Drop-Down List）
<h:selectone_menu>标记用于生成包含几个颜色选项的下拉列表。
<h:selectitem>标记包含在<h:selectone_menu>中，作为下拉列表的选项：
<f:use_faces> <h:form formName="pform"> .......... <p><h:output_text value="Color:"/><br> <h:selectone_menu id="color" valueRef="pbean.color"> <f:validate_required/> <h:selectitem itemvalue="black" itemLabel="Black"/> <h:selectitem itemvalue="red" itemLabel="Red"/> <h:selectitem itemvalue="blue" itemLabel="Blue"/> <h:selectitem itemvalue="green" itemLabel="Green"/> </h:selectone_menu> <br><h:output_errors for="color"/> .......... </h:form></f:use_faces>
上面的JSP代码生成下面的HTML片断：
<form method="post" action="/usingjsf/faces/edit.jsp"> .......... <p>Color:<br> <select name="color" size="1"> <option value="black">Black</option> <option value="red">Red</option> <option value="blue">Blue</option> <option value="green" selected>Green</option> </select> <br> ..........</form>
下拉列表定义为color，类型为字符串（String）：
public class PBean implements java.io.Serializable { .......... private String color; public String getColor() { return color; } public void setColor(String color) { this.color = color; } .......... }
当HTML表单被生成时，JSF将HTML属性selected加入到值与JavaBean模型color属性相同的列表项中。假设没有验证错误，JSF收到包含新颜色值的用户输入后会刷新JavaBean属性。
单选钮（Radio Button）
<h:selectone_radio>与<h:selectitem>标记用于生成一组单选钮：
<f:use_faces> <h:form formName="pform"> .......... <p><h:output_text value="Alignment:"/><br> <h:selectone_radio id="align" valueRef="pbean.align" layout="LINE_DIRECTION"> <f:validate_required/> <h:selectitem itemvalue="left" itemLabel="Left"/> <h:selectitem itemvalue="center" itemLabel="Center"/> <h:selectitem itemvalue="right" itemLabel="Right"/> </h:selectone_radio> <br><h:output_errors for="align"/> .......... </h:form></f:use_faces>
上面的JSP代码生成如下代码：
<form method="post" action="/usingjsf/faces/edit.jsp"> .......... <p>Alignment:<br> <table border="0"> <tr> <td><input type="radio" checked name="align" value="left"> Left</td> &nbp; <td><input type="radio" name="align" value="center"> Center</td> <td><input type="radio" name="align" value="right"> Right</td> </tr> </table> <br> ..........</form>
单选钮定义为align：
public class PBean implements java.io.Serializable { .......... private String align; public String getAlign() { return align; } public void setAlign(String align) { this.align = align; } .......... }
HTML表单生成时，JSF将HTML属性checked加入到与JavaBean模型的align属性值相同的单选钮中。假如没有验证错误，JSF收到新摆放位置的用户输入时刷新JavaBean属性。
复选钮（Checkbox）
文件edit.jsp包含3个由<h:selectboolean_checkbox>标记生成的复选钮。这些界面组件包含在由<h:panel_grid>与<h:panel_group>标记生成的表格（table）中：
<f:use_faces> <h:form formName="pform"> .......... <p><h:output_text value="Style:"/><br> <h:panel_grid columns="3" border="0" cellspacing="5"> <h:panel_group> <h:selectboolean_checkbox id="bold" valueRef="pbean.bold"/> <h:output_text value="Bold"/> </h:panel_group> <h:panel_group> <h:selectboolean_checkbox id="italic" valueRef="pbean.italic"/> <h:output_text value="Italic"/> </h:panel_group> <h:panel_group> <h:selectboolean_checkbox id="underline" valueRef="pbean.underline"/> <h:output_text value="Underline"/> </h:panel_group> </h:panel_grid> .......... </h:form></f:use_faces>
上面代码生成如下片断：
<form method="post" action="/usingjsf/faces/edit.jsp"> .......... <p>Style:<br> <table border="0" cellspacing="5"> <tr> <td><input type="checkbox" name="bold">Bold</td> <td><input type="checkbox" name="italic" checked>Italic</td> <td><input type="checkbox" name="underline">Underline</td> </tr> </table> ..........</form>
3个复选钮分别与类型为布尔（Boolean）的bold、italic、underline绑定在一起：
public class PBean implements java.io.Serializable { .......... private boolean bold; public boolean isBold() { return bold; } public void setBold(boolean bold) { this.bold = bold; } private boolean italic; public boolean isItalic() { return italic; } public void setItalic(boolean italic) { this.italic = italic; } private boolean underline; public boolean isUnderline() { return underline; } public void setUnderline(boolean underline) { this.underline = underline; } .......... }
生成HTML表单时，JSF将checked属性加入到每一个JavaBean属性为真（true）的复选钮中。假如没有验证错误，JSF收到用户输入后就会刷新JavaBean属性。
在本例中，复选钮是分别独立生成的。JSF也提供了<h:selectmany_checkboxlist>标记用于生成一组复选钮。还提供了<h:panel_list>和<h:panel_data>两个标记用于从集合与数组中生成表格。
命令按钮（Command Buttons）
文件faces-config.xml定义了导航规则，决定JSF在用户点击网页中的命令按钮时做什么，网页的路径由<from-tree-id>标记（/edit.jsp）指定。由<navigation-case>元素分别定义了两个导航块（navigation case）：
..........<faces-config> <navigation-rule> <from-tree-id>/edit.jsp</from-tree-id> <navigation-case> <from-outcome>editOutcome</from-outcome> <to-tree-id>/edit.jsp</to-tree-id> </navigation-case> <navigation-case> <from-outcome>viewOutcome</from-outcome> <to-tree-id>/view.jsp</to-tree-id> </navigation-case> </navigation-rule> ..........</faces-config>
文件edit.jsp包含由标记<h:command_button>生成的两个按钮。每个都有一个标识（ID）、一个标签、一个命令名称（这里没有使用，但JSF需要）以及一个action或actionRef属性：
<f:use_faces> <h:form formName="pform"> .......... <p> <h:command_button id="view" label="View" commandName="viewCmd" action="viewOutcome"/> <h:command_button id="boldUpperCase" label="Bold Upper Case / View" commandName="boldUpperCaseCmd" actionRef="pbean.boldUpperCaseAction"/> </h:form></f:use_faces>
上面JSP代码生成如下HTML片断：
<form method="post" action="/usingjsf/faces/edit.jsp"> .......... <p> <input type="submit" name="view" value="View"> <input type="submit" name="boldUpperCase" value="Bold Upper Case / View"></form>
JSF会在每次浏览器提交用户输入时验证表单中的数据。如果验证器没有发出错误信号而且没有类型转换错误，JSF便会分析导航块（navigation case）。对于第一个按钮，JSF会得到action属性的值viewOutcome，该值与第二个导航块的<from-outcome>元素中的文本匹配。因此，JSF将HTTP请求转发给view.jsp，文件view.jsp的路径包含在第二个导航块的<to-tree-id>元素中。
当用户点击第二个按钮时，JSF则调用PBean对象的getBoldUpperCaseAction()方法。该方法返回一个BoldUpperCaseAction的实例，BoldUpperCaseAction则是PBean的内部类。接着，JSF调用invoke()方法，该方法返回一个在运行时决定的结果而不是固定不变的HTML文件：
public class PBean implements java.io.erializable { .......... public BoldUpperCaseAction getBoldUpperCaseAction() { return new BoldUpperCaseAction(); } public class BoldUpperCaseAction extends javax.faces.application.Action { public String invoke() { String ucText = getText().toUpperCase(); if (isBold() && getText().equals(ucText)) return "viewOutcome"; else { setBold(true); setText(ucText); return "editOutcome"; } } } }
如果bold（粗体）属性的值为true（真）并且文本的所有字符为大写的，JSF就按照第二个导航块中的定义，与另一个按钮情况一样JSF将HTTP请求转发给view.jsp。另外，invoke()方法会将bold属性设为true，并将文本的所有字符改为大写的，最后返回字符串editOutcome，使JSF按照第一个导航块的定义，保持edit.jsp为当前页。
- JAVA开发精彩教程：JSF系列(一)
- JSF入门系列教程(一) jsf简介,jsf是什么？
- JSF概述(JSF系列一)
- JSF开发实战(一)
- JSF开发实战(一)
- JSF开发实战(一)
- JSF开发实战(一)
- JSF开发实战(一)
- JSF开发实战(一)
- JSF+AJAX企业级开发之路——来自Sun的高级工程师Ed Burns的精彩演讲【一】
- JSF+AJAX企业级开发之路——来自Sun的高级工程师Ed Burns的精彩演讲【一】
- Java EE开发系列教程
- Java EE开发系列教程
- Java EE开发系列教程
- Java EE开发系列教程
- 【Android学习系列】 OpenGL开发教程一
- AndEngine游戏开发系列教程（一）
- 微软小娜开发系列教程<一>
- C++获取当前路径的学问
- Men r too hard to Pleased~~
- 下载HTML内容保存到文件
- XAML之外，.NET Form上的HTML文档对象模型
- 头文件与软件著作权
- JAVA开发精彩教程：JSF系列(一)
- 收到证书
- VC++.NET读取并创建资源文件
- 它山之blog
- weblogstop.sh
- 得了几个Gmail,谁要?
- 十二宫之白羊宫
- 很久没来了
- SQL Server 存储过程的分页
