第四章驗(yàn)證和轉(zhuǎn)換

第四章驗(yàn)證和轉(zhuǎn)換第1頁(yè)，共21頁(yè)，2023年，2月20日，星期三引言上兩章里我們分別討論了UI組件模型和事件處理模型，這些基本是JSF的MVC框架的核心了但對(duì)于一個(gè)完整的JSF框架中還包括一些輔助組件：格式化和轉(zhuǎn)換器驗(yàn)證器JSF提供了兩種方式來實(shí)現(xiàn)以上，本章將介紹這些組件在JSF框架中如何使用和如何擴(kuò)展第2頁(yè)，共21頁(yè)，2023年，2月20日，星期三本章目標(biāo)轉(zhuǎn)換器和驗(yàn)證器簡(jiǎn)介轉(zhuǎn)換器處理模型使用轉(zhuǎn)換器格式化java.text.NumberFormat＆DateFormat內(nèi)置轉(zhuǎn)換器自定義擴(kuò)展轉(zhuǎn)換器驗(yàn)證處理模型使用內(nèi)置驗(yàn)證器自定義擴(kuò)展驗(yàn)證器第3頁(yè)，共21頁(yè)，2023年，2月20日，星期三轉(zhuǎn)換器和驗(yàn)證器簡(jiǎn)介JSF框架提供了驗(yàn)證器用來驗(yàn)證數(shù)據(jù)規(guī)則，一些默認(rèn)規(guī)則被定義再javax.faces.validator包中，這些規(guī)則都實(shí)現(xiàn)Validator接口JSF框架同時(shí)還提供了轉(zhuǎn)換器，把頁(yè)面串轉(zhuǎn)換成程序?qū)?yīng)處理的數(shù)據(jù)類型，或把程序中的數(shù)據(jù)類型轉(zhuǎn)換成相應(yīng)的字符串格式輸出。該功能在javax.faces.convert包中，轉(zhuǎn)換器都實(shí)現(xiàn)了Converter接口以上兩個(gè)工作都是在請(qǐng)求生命周期的Process－Validations階段完成的；當(dāng)然如果UI組件實(shí)現(xiàn)了ActionSource接口或EditableValueHolder接口，并把immediateproperty設(shè)置true，其將在ApplyRequestValues階段進(jìn)行。第4頁(yè)，共21頁(yè)，2023年，2月20日，星期三轉(zhuǎn)換器處理模型首先我們來討論轉(zhuǎn)換器(Converter)，顯然轉(zhuǎn)換過程是一個(gè)雙向的；一方面把請(qǐng)求的字符串?dāng)?shù)據(jù)轉(zhuǎn)換成Java數(shù)據(jù)類型，另一方面把Java數(shù)據(jù)類型轉(zhuǎn)換成字符串。在處理用戶請(qǐng)求階段（inbound），用戶請(qǐng)求的字符串通常都會(huì)包含格式化信息（如：日期，信用卡等）；當(dāng)數(shù)據(jù)通過驗(yàn)證以后，將調(diào)用Converter的getAsObejct方法把字符串轉(zhuǎn)換成相應(yīng)的數(shù)據(jù)類型。（圖解）在處理回復(fù)階段（outbound），服務(wù)器回復(fù)的字符串通常會(huì)把數(shù)據(jù)類型轉(zhuǎn)換成視圖的格式化字符串（圖解）第5頁(yè)，共21頁(yè)，2023年，2月20日，星期三inbound階段的轉(zhuǎn)換第6頁(yè)，共21頁(yè)，2023年，2月20日，星期三outbound階段的轉(zhuǎn)換第7頁(yè)，共21頁(yè)，2023年，2月20日，星期三使用轉(zhuǎn)換器我們可以在標(biāo)簽的converter屬性指定轉(zhuǎn)換器如：<h:inputTextconverter=“Double”value=“perty”/><h:inputTextvalue=“perty”><f:converter

converterId=“Double”/>

</h:inputText>此時(shí)的Double轉(zhuǎn)換器必須要提供在faces-config.xml中注冊(cè)此后在我們提交數(shù)據(jù)的時(shí)候，會(huì)由JSF框架使用默認(rèn)的DoubleConverter轉(zhuǎn)換器來轉(zhuǎn)換我們的屬性支持converter屬性的標(biāo)簽包括：inputText、inputHidden、inputSecret、outputText。JSF定義了Java常規(guī)數(shù)據(jù)類型的轉(zhuǎn)換器，主要包括：數(shù)值類型、日期類型、字符類型和布爾類型。當(dāng)然我們也可以自定義轉(zhuǎn)換器，在稍后我們將介紹實(shí)現(xiàn)Conerter接口自定義轉(zhuǎn)換器。當(dāng)發(fā)生異常的時(shí)候頁(yè)面通過<h:messages/>標(biāo)簽顯示異常信息第8頁(yè)，共21頁(yè)，2023年，2月20日，星期三注冊(cè)轉(zhuǎn)換器所有要使用的轉(zhuǎn)換器，必須在faces-config.xml中注冊(cè)Converter注冊(cè)方法是，使用<converter>標(biāo)簽，如：

<converter> <converter-id>Integer</converter-id> <converter-class>javax.faces.convert.IntegerConverter</converter-class> </converter>convert-id表示在converter屬性中用到的名字convert-class表示converter的類用戶自定義的Convert也要采用類似的方式第9頁(yè)，共21頁(yè)，2023年，2月20日，星期三內(nèi)置轉(zhuǎn)換器轉(zhuǎn)換器類轉(zhuǎn)換器名稱BigDecimalConverter

BigDecimalBigIntegerConverter

BigIntegerBooleanConverter

BooleanByteConverter

ByteCharacterConverter

CharacterDateTimeConverter

DateTimeDoubleConverter

DoubleFloatConverter

FloatIntegerConverter

IntegerLongConverter

LongNumberConverter

NumberShortConverterShort第10頁(yè)，共21頁(yè)，2023年，2月20日，星期三格式化從上面的表中我們可以看到要轉(zhuǎn)換的類型其實(shí)只有4類：數(shù)值類型日期類型布爾類型字符類型其中數(shù)值類型和日期類型，我們可以指定輸入/輸出格式<f:convertNumber>數(shù)值格式化<f:convertDataTime>日期格式化第11頁(yè)，共21頁(yè)，2023年，2月20日，星期三數(shù)值格式化使用數(shù)值格式化，我們必須在UIInput和UIOutput組件標(biāo)簽，放置子標(biāo)簽：<f:convertNumber>該標(biāo)簽的屬性用來控制如何格式化pattern格式化符號(hào)如：#,###.##type處理數(shù)據(jù)的類型包括："number","currency",and"percent“groupingUsed是否可以使用分隔如：2,000,000maxIntegerDigitsminIntegerDigits整數(shù)部分最大小范圍maxFractionDigitsminFractionDigits小數(shù)部分最大小范圍第12頁(yè)，共21頁(yè)，2023年，2月20日，星期三日期格式化日期格式化使用<f:convertDateTime/>,如：<h:outputTextvalue="#{now}"> <f:convertDateTimepattern="M-dd-yyyy"/> </h:outputText>其屬性包括：dateStyle只能是如下值："default","short","medium","long",and"full".patten如：M/dd/yyyytimeStyle同dateStyletype必須是：”date”,”time”,”both”第13頁(yè)，共21頁(yè)，2023年，2月20日，星期三自定義擴(kuò)展轉(zhuǎn)換器首先，我們先從Converter接口實(shí)現(xiàn)我們自己的驗(yàn)證規(guī)則。Converter接口要實(shí)現(xiàn)兩個(gè)方法publicObjectgetAsObject(FacesContext,UIComponent,String)throwsConverterExceptionpublicStringgetAsString(FacesContext,UIComponent,String)throwsConverterException當(dāng)用戶擴(kuò)展完轉(zhuǎn)換器后依然要注冊(cè)轉(zhuǎn)換器第14頁(yè)，共21頁(yè)，2023年，2月20日，星期三驗(yàn)證處理模型可以為UIComponent組件定義驗(yàn)證處理過程，以幫助數(shù)據(jù)的有效性的驗(yàn)證，驗(yàn)證器在生命周期的ProcessValidations階段執(zhí)行。啟動(dòng)驗(yàn)證器的UI組件必須實(shí)現(xiàn)了EditableValueHodler接口或ActionSource的immediate屬性設(shè)置為true驗(yàn)證器才會(huì)在該組件中調(diào)用JSF框架中所有的驗(yàn)證器都必須從javax.faces.validator.Validator接口中實(shí)現(xiàn)，并實(shí)現(xiàn)validate()方法第15頁(yè)，共21頁(yè)，2023年，2月20日，星期三使用內(nèi)置驗(yàn)證器內(nèi)置的驗(yàn)證器包括：<f:validateDoubleRangemaximumminmum><f:validateLengthmaximumminmum><f:validateLongRangemaximumminmum>如: <h:form><h:inputTextid="t1"value="100"><f:validateLongRangemaximum="99"minimum="10"/></h:inputText> <h:messagefor="t1"/> <h:commandButtonid="c1"value="OK"action="conv"/></h:form>第16頁(yè)，共21頁(yè)，2023年，2月20日，星期三驗(yàn)證器方法在JSF框架中，也許你需要為自己的字段加入一些邏輯的驗(yàn)證規(guī)則此時(shí)可以編寫自己的驗(yàn)證方法，其方法原形publicvoidmethodName(FacesContext,UIComponent,Object)throwsValidatorException如果通過驗(yàn)證則return，否則拋出ValidatorException異常，并在該異常中綁定消息FacesMessage在inputText標(biāo)簽中提供了validator屬性來綁定驗(yàn)證方法，如：<h:inputTextvalidator=“#{…}”/>第17頁(yè)，共21頁(yè)，2023年，2月20日，星期三自定義擴(kuò)展驗(yàn)證器自定義驗(yàn)證器必須從Validator接口派生，Validator接口要實(shí)現(xiàn)的方法并在faces－config.xml文件中進(jìn)行注冊(cè)<validator><validator-id>驗(yàn)證器名稱<validator-class>驗(yàn)證器類在JSF組件中使用自定義驗(yàn)證器可以通過<f:validator>標(biāo)簽,如：<h:inputTextvalue=“…”>

<f:validatorvalidatatorId=“驗(yàn)證器名稱”/> </h:inputText>第18頁(yè)，共21頁(yè)，2023年，2月20日，星期三本章小結(jié)本章介紹JSF框架的最后一個(gè)部分驗(yàn)證器和轉(zhuǎn)換器，其基本處理都是在數(shù)據(jù)inbound和outbound期間進(jìn)行，這樣用戶輸入的數(shù)據(jù)和輸出的數(shù)據(jù)都保證了系統(tǒng)的數(shù)據(jù)完整性JSF框