日期:2014-05-16 浏览次数:20329 次
本文参考 http://www.javaworld.com.tw/confluence/pages/viewpage.action?pageId=2630
?
在使用标准转换器或验证器时,当发生错误时,会有一些预定义的错误信息显示,这些信息可以使用<h:messages>或<h:message>标签来显示出来,而这些预定义的错误信息也是可以修改的,您所要作的是提供一个信息资源文件,例如:messages.properties
javax.faces.component.UIInput.CONVERSION=Format Error. javax.faces.component.UIInput.REQUIRED=Please input your data. ....
?javax.faces.component.UIInput.CONVERSION是用来设定当转换器发现错误时显示的信息,而javax.faces.component.UIInput.REQUIRED是在标签设定了required为true,而使用者没有在栏目输入时显示的错误信息。
您要在faces-config.xml中告诉JSF您使用的信息文件名称,例如:
<?xml version="1.0"?> <!DOCTYPE faces-config PUBLIC "-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.0//EN" "http://java.sun.com/dtd/web-facesconfig_1_0.dtd"> <faces-config> <application> <local-config> <default-locale>en</default-locale> <supported-locale>zh_CN</supported-locale> </local-config> <message-bundle>messages</message-bundle> </application> ..... </faces-config>
?在这边我们设定了信息文件的名称为messages_xx_YY.properties,其中xx_YY是根据您的Locale来决定,转换器或验证器的错误信息如果有设定的话,就使用设定值,如果没有设定的话,就使用预定义值。
验证器错误信息,除了上面的javax.faces.component.UIInput.REQUIRED之外,还可以搜索javax.faces.validator包找到一些错误信息。
在您提供自定义信息的时候,也可以提供{0}或{1}来设定显示相对的属性值,以提供详细正确的错误提示信息。
信息的显示有概述信息与详述信息,如果是详述信息,则在标识上加上 "_detail",例如:
javax.faces.component.UIInput.CONVERSION=Error. javax.faces.component.UIInput.CONVERSION_detail= Detail Error. ....
?除了在信息资源文件中提供信息,您也可以在程序中使用FacesMessage来提供信息,例如在 自定义验证器 中我们就这么用过:
.... if(password.length() < 6) { FacesMessage message = new FacesMessage( FacesMessage.SEVERITY_ERROR, "字符长度小于6", "字符长度不得小于6"); throw new ValidatorException(message); } ....
?最好的方法是在信息资源文件中提供信息 ,这么一来如果我们要修改信息,就只要修改信息资源文件的内容,而不用修改程序,来看一个简单的例子,假设我们的信息资源文件中有以下的内容:
bruce.zhao.message1=This is message1. bruce.zhao.message2=This is message2 with \{0} and \{1}.
?则我们可以在程序中取得信息资源文件的内容,例如:
package bruce.zhao; import java.util.Locale; import java.util.ResourceBundle; import javax.faces.context.FacesContext; improt javax.faces.component.UIComponent; import javax.faces.application.Application; import javax.faces.application.FacesMessage; .... public void xxxMethod(FacesContext context, UIComponent component, Object obj) { // 取得应用程序代表对象 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("bruce.zhao.message1"); FacesMessage facesMessage = new FacesMessage(FacesMessage.SEVERITY_FATAL, message, message); .... } .... ....
?接下来您可以将FacesMessage对象填入ValidatorException或ConverterException后再丢出,FacesMessage建构时所使用的三个参数是严重程度、概述信息与详述信息,严重程度有SEVERITY_FATAL、SEVERITY_ERROR、SEVERITY_WARN与SEVERITY_INFO四种。
如果需要在信息资源文件中设定{0}、{1}等参数,则可以如下:
.... String message = rsBundle.getString("bruce.zhao.message2"); Object[] params = {"param1", "param2"}; message = java.text.MessageFormat.format(message, params); FacesMessage facesMessage = new FacesMessage(FacesMessage.SEVERITY_FATAL, message, message);
?如此一来,在显示信息时,bruce.zhao.message2的{0}与{1}的位置就会被"param1"与"param2"所取代。