JSF Converter介绍与使用

忘是亡心i 2022-06-05 23:30 179阅读 0赞

### 转自：http://xiejibin.blog.163.com/blog/static/538770992008816359667/ ###

JSF提供Converter机制对用户输入，以及画面输出值进行变换。  
JSF提供了一些默认的Converter实现，同时也提供了接口可以让用户实现自定义Converter。本文对JSF的Converter的原理机制，功能，实现方法等做一个介绍

1，输入变换：在用户1，输入变换：在用户提交时对用户输入值进行变换 
       2，输出变换：在画面显示前对显示值进行变换 
 
在JSF的几个生命周期阶段，分别会在以下几个阶段调用组件的Converter： 
1，对于UIInput组件：如果按钮事件的immediate属性为true（<h:commandButton immediate="true" .../>），JSF会在 \[Apply Request Values Phase：应用请求值阶段\]，反之，JSF会在\[Process Validations Phase：数据检查阶段\] 检验用户输入的有效性，有效的情况下会调用绑定到该UIInput组件的Converter对用户输入进行转换。同时，跟UIOutput组件一样，JSF会在\[Render Response：重画画面阶段\]调用Converter对UIInput进行显示前的变换处理 
2，对于UIOutput组件：JSF会在\[Render Response：重画画面阶段\]调用绑定到该UIOutput组件的Converter对将要显示的值进行变换。

<table style="line-height:28px; color:rgb(0,0,0); font-family:&quot;Hiragino Sans GB W3&quot;,&quot;Hiragino Sans GB&quot;,Arial,Helvetica,simsun,u5b8bu4f53; font-size:16px; width:703px; height:1044px"> 
 <tbody style="line-height:28px"> 
 <tr style="line-height:28px"> 
 <th style="line-height:28px">Type</th> 
 <th style="line-height:28px">Class</th> 
 <th style="line-height:28px">Name</th> 
 <th style="line-height:28px">For conversion between...</th> 
 </tr> 
 <tr style="line-height:28px"> 
 <td style="line-height:28px">BigDecimal</td> 
 <td style="line-height:28px"> BigDecimalConverter </td> 
 <td style="line-height:28px"> javax.faces.BigDecimal </td> 
 <td style="line-height:28px">String and java.math.BigDecimal values </td> 
 </tr> 
 <tr style="line-height:28px"> 
 <td style="line-height:28px">BigInteger</td> 
 <td style="line-height:28px"> BigIntegerConverter </td> 
 <td style="line-height:28px"> javax.faces.BigInteger </td> 
 <td style="line-height:28px">String and java.math.BigInteger values </td> 
 </tr> 
 <tr style="line-height:28px"> 
 <td style="line-height:28px">Boolean and boolean</td> 
 <td style="line-height:28px"> BooleanConverter </td> 
 <td style="line-height:28px"> javax.faces.Boolean </td> 
 <td style="line-height:28px">String and java.lang.Boolean (and boolean primitive) values </td> 
 </tr> 
 <tr style="line-height:28px"> 
 <td style="line-height:28px">Byte and byte</td> 
 <td style="line-height:28px"> ByteConverter </td> 
 <td style="line-height:28px"> javax.faces.Byte </td> 
 <td style="line-height:28px">String and java.lang.Number values </td> 
 </tr> 
 <tr style="line-height:28px"> 
 <td style="line-height:28px">Character and char</td> 
 <td style="line-height:28px"> CharacterConverter </td> 
 <td style="line-height:28px"> javax.faces.Character </td> 
 <td style="line-height:28px">String and java.lang.Character (and char primitive) values </td> 
 </tr> 
 <tr style="line-height:28px"> 
 <td style="line-height:28px">Double and double</td> 
 <td style="line-height:28px"> DoubleConverter </td> 
 <td style="line-height:28px"> javax.faces.Double </td> 
 <td style="line-height:28px">String and java.lang.Double (and double primitive) values </td> 
 </tr> 
 <tr style="line-height:28px"> 
 <td style="line-height:28px">Float and float</td> 
 <td style="line-height:28px"> FloatConverter </td> 
 <td style="line-height:28px"> javax.faces.Float </td> 
 <td style="line-height:28px">String and java.lang.Float (and float primitive) values </td> 
 </tr> 
 <tr style="line-height:28px"> 
 <td style="line-height:28px">Integer and int</td> 
 <td style="line-height:28px"> IntegerConverter </td> 
 <td style="line-height:28px"> javax.faces.Integer </td> 
 <td style="line-height:28px">String and java.lang.Integer (and int primitive) values </td> 
 </tr> 
 <tr style="line-height:28px"> 
 <td style="line-height:28px">Long and long</td> 
 <td style="line-height:28px"> LongConverter </td> 
 <td style="line-height:28px"> javax.faces.Long </td> 
 <td style="line-height:28px">String and java.lang.Long (and long primitive) values </td> 
 </tr> 
 <tr style="line-height:28px"> 
 <td style="line-height:28px">Short and short</td> 
 <td style="line-height:28px"> ShortConverter </td> 
 <td style="line-height:28px"> javax.faces.Short </td> 
 <td style="line-height:28px">String and java.lang.Short (and short primitive) values </td> 
 </tr> 
 </tbody> 
</table>

JSF跟Converter有关的标签：

<h:inputHidden  converter=" "></h:inputHidden> 
<h:inputSecret converter=" "></h:inputSecret> 
<h:inputText converter=" "></h:inputText> 
<h:inputTextarea converter=" "></h:inputTextarea> 
<h:outputFormat converter=" "></h:outputFormat> 
<h:outputLabel converter=" "></h:outputLabel> 
<h:outputLink converter=" "></h:outputLink> 
<h:outputText converter=" "></h:outputText> 
<h:selectBooleanCheckbox converter=" "></h:selectBooleanCheckbox> 
<h:selectManyCheckbox converter=" "></h:selectManyCheckbox> 
<h:selectManyListbox converter=" "></h:selectManyListbox> 
<h:selectManyMenu converter=" "></h:selectManyMenu> 
<h:selectOneListbox converter=" "></h:selectOneListbox> 
<h:selectOneMenu converter=" "></h:selectOneMenu> 
<h:selectOneRadio converter=" "></h:selectOneRadio> 
<f:converter  converterId=" "></f:converter> 
<f:convertDateTime></f:convertDateTime> 
<f:convertNumber></f:convertNumber>

其中h:inputHidden等标签的converter属性以及f:converter标签的converterId属性为被定义的converter-id，或指定为javax.faces.convert.Converter的实例。该调用方法不能向Converter传递参数。  
f:converter，f:convertDateTime或其他自定义Converter标签可以对h:inputHidden，h:inputText，h:selectOneRadio等父标签的value值进行变换。

JSF Converter的使用：

使用converter属性调用指定id的Converter，例：

<h:inputHidden converter=" javax.faces.DateTime" value=" \#\{myBean.datetime\}" />

使用f:converter标签调用指定id的Converter，例：

<h:inputText value=" \#\{myBean.datetime\}"> 
    <f:converter converterId=" javax.faces.DateTime"></f:converter> 
</h:inputText>

使用f:convertNumber等Converter标签或自定义Converter标签，例：

<h:inputText value=" \#\{myBean.datetime\}"> 
    <f:convertNumber type=" number" pattern=" \#,\#\#\#"/> 
</h:inputText>

上面我们介绍了JSF Converter的基本概念，功能，JSF提供的默认Converter实现以及Converter的使用方法等。在下文中，我们将介绍如何自定义JSF Converter。

例子：转换成long类型的。

<h:inputText value="\#\{myBean.myId\}"> 
**    <f:converter converterId="javax.faces.Long"></f:converter>** 
</h:inputText>