用户界面组件与验证
文件edit.jsp中的元素包含多个用户界面组件,我们将会在后面详细地介绍。各组件的HTML代码都是由JSF组件标记产生,例如:,该标记中可能还会包含其他JSF标记,如:标记,该标记使JSF确认用户输入了信息。
处理用户输入的组件使用属性valueRef="pbean.property"与JavaBean属性绑定起来。JSF获得和设置管理bean属性值已在前面介绍了。
有的JSF组件标记不会处理任何用户输入。例如可用于输出文本或JavaBean只读属性的值。
每个组件都有唯一的ID,ID可在id属性中指定或由JSF自动生成。要进行验证的用户界面组件需要id属性以便验证错误能够与一起显示打印出来。
文本域Text Area
JSF表单的文本域让用户输入将会由Pbuilder.java生成并由view.jsp显示的某些文字段落等内容。edit.jsp显示一个由确定的标签并使用生成3行30列的HTML元素。标记注册一个JSF验证器,如果用户在文本域中的输入为空则发出错误信号。错误信息将显示在标记的位置,除了显示错误外该标记不会做其他任何操作。标记的for属性值与的id属性值相同。
rows="3" cols="30"
..........
上面的JSP代码生成下面的HTML片断:
Text:
cols="30" rows="3"JavaServer Faces
..........
的属性valueRef="pbean.text"使JSF查找ID为pbean的JavaBean实例,并且将用户输入的文本存储到JavaBean实例的text属性中。当HTML的表单被生成后,JSF会将text属性值插入到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;
}
..........
}
除了,JSF还提供了许多生成单行文本域(text field)的标记:
l
l
l
(密码输入)
l
l
l
l
可被用于隐藏的表单域
单行文本域(Text Field)
edit.jsp文件的单行文本域组件只允许输入1至7之间的数字。由生成这段HTML代码,该标记包含两个验证器。标记在前面已经介绍了。标记是使验证器确认用户输入的数字在给定的范围之内。如果超出范围,则向用户报告验证错误,错误信息由产生。
[code]
..........
..........
[/code]
上面的JSP代码生成下面的HTML片断:
..........
Size: [1-7]
..........
单行文本域被定为size,类型为整形(int)。size中value属性的值(3)是表示所生成的HTML表单数字输入区域的初值。假设没有出现验证错误,当JSF收到包含新JavaBean size属性值的用户输入就会刷新JavaBean。标记的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;
}
..........
}
除了与标记,JSF还提供了几个验证器标记:
l
l
l
l
最后一个为通用标记,可以用它在用户界面组件中注册你自己的定制验证器。你也能够创建自己的验证器标记库。
列表List Box
与标记生成HTML元素,网页浏览器会将显示为列表。前者允许用户进行单项选择,后者用于多项选择。
文件edit.jsp使用标记生成一个含有几个字体名称的列表。HTML的元素定义列表中的选项,这由JSF标记生成:
..........
itemLabel="Arial"/
itemLabel="Courier New"/
itemLabel="Times New Roman"/
..........
上面的代码生成下面的HTML片断:
..........
Font:
Arial
Courier New
Times New Roman
..........
列表被定义为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
String oldFontArray[] = fontArray;
fontArray = new String[index+1];
for (int i = 0; i
fontArray[i] = oldFontArray[i];
}
fontArray[index] = font;
}
..........
}
当生成HTML表单时,JSF将所选的HTML属性加入到列表选项,列表选项的值被保存在JavaBean模型的字体数组中。假设没有验证错