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