JAVA教程之JSF開發(fā)(二)
JSF技術(shù)為開發(fā)基于網(wǎng)絡(luò)用戶界面的Java開發(fā)者提供了標(biāo)準(zhǔn)的編程接口API以及標(biāo)記庫。Apache Struts框架的作者Craig McClanahan,協(xié)助領(lǐng)導(dǎo)了Sun公司的JSF項(xiàng)目。這使項(xiàng)目能夠容易的從流行的Apache向JSF標(biāo)準(zhǔn)移植得到了保證。就像Struts框架一樣,JSF定義了一套JSP標(biāo)記,能夠生成與JavaBean屬性綁定在一起的HTML表單元素。
本系列第一篇:JAVA教程之JSF開發(fā)(一)
用戶界面組件與驗(yàn)證
文件edit.jsp中的<h:form>元素包含多個(gè)用戶界面組件,我們將會(huì)在后面詳細(xì)地介紹。各組件的HTML代碼都是由JSF組件標(biāo)記產(chǎn)生,例如:<h:input_textarea>,該標(biāo)記中可能還會(huì)包含其他JSF標(biāo)記,如:<f:validate_required>標(biāo)記,該標(biāo)記使JSF確認(rèn)用戶輸入了信息。
處理用戶輸入的組件使用屬性valueRef="pbean.property"與JavaBean屬性綁定起來。JSF獲得和設(shè)置管理bean屬性值已在前面介紹了。
有的JSF組件標(biāo)記不會(huì)處理任何用戶輸入。例如<h:output_text>可用于輸出文本或JavaBean只讀屬性的值。
每個(gè)組件都有唯一的ID,ID可在id屬性中指定或由JSF自動(dòng)生成。要進(jìn)行驗(yàn)證的用戶界面組件需要id屬性以便驗(yàn)證錯(cuò)誤能夠與<h:output_errors for="id"/>一起顯示打印出來。
圖2:驗(yàn)證錯(cuò)誤
文本域Text Area
JSF表單的文本域讓用戶輸入將會(huì)由Pbuilder.java生成并由view.jsp顯示的某些文字段落等內(nèi)容。edit.jsp顯示一個(gè)由<h:output_text>確定的標(biāo)簽并使用<h:input_textarea>生成3行30列的<textarea>HTML元素。<f:validate_required>標(biāo)記注冊一個(gè)JSF驗(yàn)證器,如果用戶在文本域中的輸入為空則發(fā)出錯(cuò)誤信號。
錯(cuò)誤信息將顯示在<h:output_errors>標(biāo)記的位置,除了顯示錯(cuò)誤外該標(biāo)記不會(huì)做其他任何操作。<h:output_errors>標(biāo)記的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實(shí)例,并且將用戶輸入的文本存儲(chǔ)到JavaBean實(shí)例的text屬性中。當(dāng)HTML的表單被生成后,JSF會(huì)將text屬性值插入到<textarea>HTML元素中。類Pbean實(shí)現(xiàn)了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)的標(biāo)記:
- <intput_text>
- <h:input_number>
- <input_secret>(密碼輸入)
- <input_date>
- <input_datetime>
- <input_time>
- <input_hidden>可被用于隱藏的表單域
#p#
單行文本域(Text Field)
edit.jsp文件的單行文本域組件只允許輸入1至7之間的數(shù)字。由<h:input_number>生成這段HTML代碼,該標(biāo)記包含兩個(gè)驗(yàn)證器。<f:validate_required>標(biāo)記在前面已經(jīng)介紹了。<f:validate_longrange>標(biāo)記是使驗(yàn)證器確認(rèn)用戶輸入的數(shù)字在給定的范圍之內(nèi)。如果超出范圍,則向用戶報(bào)告驗(yàn)證錯(cuò)誤,錯(cuò)誤信息由<h:output_errors>產(chǎn)生。
- [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表單數(shù)字輸入?yún)^(qū)域的初值。假設(shè)沒有出現(xiàn)驗(yàn)證錯(cuò)誤,當(dāng)JSF收到包含新JavaBean size屬性值的用戶輸入就會(huì)刷新JavaBean。<h:input_number>標(biāo)記的size屬性是限定單行文本域的字符長度(2),不會(huì)對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>標(biāo)記,JSF還提供了幾個(gè)驗(yàn)證器標(biāo)記:
- <validate_doublerange>
- <validate_stringrange>
- <validate_length>
- <validator>
最后一個(gè)為通用標(biāo)記,可以用它在用戶界面組件中注冊你自己的定制驗(yàn)證器。你也能夠創(chuàng)建自己的驗(yàn)證器標(biāo)記庫。
#p#
列表List Box
<h:selectone_listbox>與<h:selectmany_listbox>標(biāo)記生成HTML元素<select>,網(wǎng)頁瀏覽器會(huì)將<select>顯示為列表。前者允許用戶進(jìn)行單項(xiàng)選擇,后者用于多項(xiàng)選擇。
文件edit.jsp使用<h:selectmany_listbox>標(biāo)記生成一個(gè)含有幾個(gè)字體名稱的列表。HTML的<option>元素定義列表中的選項(xiàng),這由JSF標(biāo)記<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,類型為字符串?dāng)?shù)組(String[])。第一個(gè)getFont()方法使用clone()方法復(fù)制內(nèi)部的數(shù)組并將其返回,內(nèi)部數(shù)組必須從外部訪問中得到保護(hù)。第一個(gè)setFont()方法用clone()方法復(fù)制所提供的數(shù)組并保存起來,所提供的數(shù)組可被第二個(gè)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;
- }
- ..........
- }
當(dāng)生成HTML表單時(shí),JSF將所選的HTML屬性加入到列表選項(xiàng),列表選項(xiàng)的值被保存在JavaBean模型的字體數(shù)組中。假設(shè)沒有驗(yàn)證錯(cuò)誤,JSF會(huì)在接收到用戶新的選擇字體的輸入時(shí)刷新JavaBean屬性。
【編輯推薦】
- JSF文件在web.xml中啟動(dòng)異常
- Ajax優(yōu)于JSF的幾個(gè)原因討論
- JSF理解組件和客戶端標(biāo)識(shí)符
- JSP像烏云般擋住了JSF的光芒
- MyEclipse開發(fā)JSF之創(chuàng)建工程淺析