JAVA教程之JSF开发(二)-java 开发教程

JSF技术为开发基于网络用户界面的Java开发者提供了标准的编程接口API以及标记库。Apache Struts框架的作者Craig McClanahan，协助领导了Sun公司的JSF项目。这使项目能够容易的从流行的Apache向JSF标准移植得到了保证。就像Struts框架一样，JSF定义了一套JSP标记，能够生成与JavaBean属性绑定在一起的HTML表单元素。

本系列第一篇：JAVA教程之JSF开发(一)

用户界面组件与验证

文件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>可被用于隐藏的表单域

#p#

单行文本域（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>

最后一个为通用标记，可以用它在用户界面组件中注册你自己的定制验证器。你也能够创建自己的验证器标记库。

#p#

列表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;  
}  
..........  
}

当生成HTML表单时，JSF将所选的HTML属性加入到列表选项，列表选项的值被保存在JavaBean模型的字体数组中。假设没有验证错误，JSF会在接收到用户新的选择字体的输入时刷新JavaBean属性。

【编辑推荐】