JSF验证器和转换器

JSF定义了一系列标准的转换器(Converter)，支持8种基本类型数据转换
DateTime、Number可以使用<f:convertDateTime>、<f:convertNumber>标签进行转换

自定义转换器
自定义转换器要实现javax.faces.convert.Converter接口，这个接口有两个要实现的方法：
public Object getAsObject(FacesContext context,UIComponent component,String str);
public String getAsString(FacesContext context,UIComponent component,Object obj);
实现自定义转换器后，需要在faces-config.xml中注册转换器
例如：
<converter>
<converter-id>onlyfun.caterpillar.User</converter-id>
<converter-class>
onlyfun.caterpillar.UserConverter
</converter-class>
</converter>
注册转换器时，需提供转换器标识(Converter ID)与转换器类，接下来要在JSF页面中使用转换器的话，就是指定所要使用的转换器标识.
例如：
<h:inputText id="userField" value="#{guest.user}" converter="onlyfun.caterpillar.User"/>
也可以<f:converter>标签并使用converterId属性来指定转换器
<h:inputText id="userField" value="#{guest.user}">
<f:converter converterId="onlyfun.caterpillar.User"/>
</h:inputText>
除了向JSF注册转换器之外，还有一个方式可以不用注册，就是直接在Bean上提供一个取得转换器的方法
<h:inputText id="userField" value="#{guest.user}" converter="#{guest.converter}"/>

标准验证器
JSF提供了三种标准验证器：<f:validateDoubleRange>、<f:validateLongRange>、<f:validateLength>
<h:inputText>、</h:inputSecret>中required属性为true，这表示这个栏目一定要输入值

自定义验证器，所需要的是实现javax.faces.validator.Validator接口
如果验证错误，则丢出一个ValidatorException，它接受一个FacesMessage对象，这个对象接受三个参数，分别表示信息的严重程度(INFO、WARN、ERROR、FATAL)信息概述与详细信息内容
这些信息可以使用<h:messages>或<h:message>标签显示在页面上
例如：
public void validate(FacesContext context,UIComponent component,Object obj)throws ValidatorException {
if(obj!=null){
String password = (String) obj;
if(password.length() < 6) {
FacesMessage message = new FacesMessage(FacesMessage.SEVERITY_ERROR,
"字符长度小于 6","字符长度不得小于 6");
throw new ValidatorException(message);
}
if(!password.matches(".+[0-9]+")) {
FacesMessage message = new FacesMessage(acesMessage.SEVERITY_ERROR,
"密码必须包括字符与数字","密码必须是字符加数字所组成");
throw new ValidatorException(message);
}
}
}
接下来要在faces-config.xml中注册验证器的标识(Validater ID)
<validator>
<validator-id>
onlyfun.caterpillar.Password
</validator-id>
<validator-class>
onlyfun.caterpillar.PasswordValidator
</validator-class>
</validator>
要使用自定义的验证器，我们可以使用<f:validator>标签并设定validatorId属性
<h:inputSecret value="#{user.password}" required="true">
<f:validator validatorId="onlyfun.caterpillar.Password"/>
</h:inputSecret>
在自定义验证器中，使用<f:attribute>标签来设置属性
<h:inputSecret value="#{user.password}" required="true">
<f:validator validatorId="onlyfun.caterpillar.Password"/>
<f:attribute name="pattern" value=".+[0-9]+"/> <!--添加属性-->
</h:inputSecret><p>
程序中可以通过component来获取所设定的属性
public void validate(FacesContext context,UIComponent component,Object obj)
throws ValidatorException {
String pattern = (String)component.getAttributes().get("pattern");
}

采用JSF注解方式进行验证

@FacesValidator(value="com.bond.validator.EmailValidator")
public class EmailValidator implements Validator {
private String pattern="^[_a-z0-9]+@([_a-z0-9]+\\.)+[a-z0-9]{2,3}$";
@Override
public void validate(FacesContext context, UIComponent arg1, Object arg2)
throws ValidatorException {
......
}
public String getPattern() {
return pattern;
}
public void setPattern(String pattern) {
this.pattern = pattern;
}
}

页面引用

<h:inputText value="#{userBean.email}">
<f:validator validatorId="com.bond.validator.EmailValidator"/>
</h:inputText>
其中validatorId的值为@FacesValidator注解中value中的字符串。这样就完成了，不需要另外的xml等配置，非常方便

您也可以让Bean自行负责验证的工作，可以在Bean上提供一个验证方法，这个方法没有传回值，并可以接收FacesContext、UIComponent、Object三个参数，
public void validate(FacesContext context,UIComponent component,Object obj)throws ValidatorException {}
接着可以在页面下如下使用验证器
<h:inputSecret value="#{user.password}" required="true" validator="#{user.validate}"/>

错误信息处理

使用<h:messages>标签，当有验证错误发生时，相关的错误信息会收集起来
使用<h:messages>标签可以一次将所有的错误信息显示出来

在使用标准转换器或验证器时，当发生错误时，会有一些预定义的错误信息,预定义的错误信息也是可以修改的.
提供一个信息资源文件.
在您提供自定义信息的时候，也可以提供{0}或{1}来设定显示相对的属性值，以提供详细正确的错误提示信息。

信息的显示有概述信息与详述信息，如果是详述信息，则在标识上加上"_detail"

例如：

javax.faces.component.UIInput.CONVERSION=Error.
javax.faces.component.UIInput.CONVERSION_detail= Detail Error.

除了在信息资源文件中提供信息， 您也可以在程序中使用FacesMessage来提供信息
最好的方法是在信息资源文件中提供信息，这么一来如果我们要修改信息，就只要修改信息资源文件的内容，而不用修改程序
onlyfun.caterpillar.message1=This is message1
onlyfun.caterpillar.message2=This is message2 with \{0} and \{1}
在程序中取得信息资源文件的内容
// 取得应用程序代表对象
Application application = context.getApplication();
// 取得信息文件主名称
String messageFileName = application.getMessageBundle();
// 取得当前 Locale 对象
Locale locale = context.getViewRoot().getLocale();
// 取得信息绑定 ResourceBundle 对象
ResourceBundle rsBundle = ResourceBundle.getBundle(messageFileName, locale);
String message = rsBundle.getString("onlyfun.caterpillar.message1");
FacesMessage facesMessage = new FacesMessage(FacesMessage.SEVERITY_FATAL, message, message);
将FacesMessage对象填入ValidatorException或ConverterException后再丢出
如果需要在信息资源文件中设定{0}、{1}等参数
String message = rsBundle.getString("onlyfun.caterpillar.message2");
Object[] params = {"param1", "param2"}
message = java.text.MessageFormat.format(message, params);
FacesMessage facesMessage = new FacesMessage(FacesMessage.SEVERITY_FATAL, message, message);
，在显示信息时，onlyfun.caterpillar.message2的{0}与{1}的位置就会被"param1"与"param2"所取代

自定义转换, 验证标签
要开发自定义验证器标签，您可以直接继承javax.faces.webapp.ValidatorTag，覆写createValidator()方法

编写标签处理类(继承ValidatorTag,覆写createValidator()方法)
protected Validator createValidator() {
Application application = FacesContext.getCurrentInstance().getApplication();
PasswordValidator validator =
(PasswordValidator) application.createValidator("onlyfun.caterpillar.Password");
validator.setPattern(pattern);
return validator;
}
application.createValidator()方法建立验证器对象时，是根据在faces-config.xml中注册的标识（Validater ID）：
<validator>
<validator-id>
onlyfun.caterpillar.Password
</validator-id>
<validator-class>
onlyfun.caterpillar.PasswordValidator
</validator-class>
</validator>

布署tld描述文件
<taglib xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
web-jsptaglibrary_2_0.xsd" version="2.0">
<tlib-version>1.0</tlib-version>
<jsp-version>2.0</jsp-version>
<short-name>co</short-name>
<uri>http://caterpillar.onlyfun.net</uri>

<tag>
<name>passwordValidator</name>
<tag-class>
onlyfun.caterpillar.PasswordValidatorTag
</tag-class>
<body-content>empty</body-content>
<attribute>
<name>pattern</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
</attribute>
</tag>
</taglib>

页面导入
<%@ taglib uri="/WEB-INF/taglib.tld" prefix="co" %>
<co:passwordValidator pattern=".+[0-9]+"/><!-- 使用自定义标签-->

自定义转换器标签方法也是类似(继承javax.faces.webapp.ConverterTag，并重新定义其createConverter()方法)