使用JSF（Java Server Faces）开发(二)

用户界面组件与验证


  文件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>

<form method="post" action="/usingjsf/faces/edit.jsp">
    <p>Text:<br>
    <textarea name="text" 
        cols="30" rows="3">JavaServer Faces</textarea>
    <br>
    ..........
</form>

public class PBean implements java.io.Serializable {
 
    private String text;
 
    public String getText() {
        return text;
    }
 
    public void setText(String text) {
        this.text = text;
    }
 
    ..........
 
}

<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>

public class PBean implements java.io.Serializable {
 
    ..........
 
    private int size;
 
    public int getSize() {
        return size;
    }
 
    public void setSize(int size) {
        this.size = size;
    }
 
    ..........
 
}

<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>

<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>