使 JSF 支持含有 HTML 标签 的 Message
使 JSF 支持带有 HTML 标签 的 Message背景介绍JSF 的 HtmlMessage 标签一般用于显示系统的 Error 或者 Va
使 JSF 支持带有 HTML 标签 的 Message
背景介绍
JSF 的 HtmlMessage 标签一般用于显示系统的 Error 或者 Validation 消息,至于其标准用法可以参考官方文档。在大部分的文章中,都讲解了其如何绑定到标签或者基于 table 和 list 去显示消息,但是这些消息都是标准的文字格式,没有夹带有 HTML tag。比如说,原有系统的所有 error 消息都是存在与 property 文件中,而且格式为
xml 代码
- ems=<b>Amount Count<!---->b> must be more than <font color=green>150$<!---->font>
这种格式的消息在被 HtmlMessage tag 渲染显示后,全部变为了转义后的字符,也就是在页面中显示的和上面的文字完全相同。
由于 HtmlOutputText 控件有 escape 属性,所以可以很好地解决这种问题,可是在 HtmlMessage 控件中没有提供这种属性。
解决方法正是受到 HtmlOutputText 的影响,才想到能不能自己写一个类似的标签来解决相应的问题。那么问题的关键是这些 validation message 是在什么时候被转义的,是在传递到标签之前还是之后。如果是在传递到标签之前,那么这种方法是没有任何意义的,因为无论你的标签怎么写,你所接受到的都是已经转义后的内容了。
经过求证发现,所有的 FacesMessage 可以通过 FacesContext 获取到,而且 Message 中的消息都是没有转义之前的内容,这样就可以通过自定义标签来解决上面的问题了。
java 代码
- package com.xxx.xxx; import javax.servlet.jsp.*;
- import javax.servlet.jsp.tagext.*; import java.io.IOException;
- import java.util.Iterator;
- import javax.faces.application.FacesMessage;
- import javax.faces.context.FacesContext;
- public class ValidatorTag implements javax.servlet.jsp.tagext.Tag{ private PageContext pageContext;
- private Tag parent;
- public ValidatorTag() { super();
- }
- /** * configure tag context
- */
- public void setPageContext(PageContext pageContext){ this.pageContext = pageContext;
- }
- /** * configure the last level tag
- */
- public void setParent(Tag parent){ this.parent = parent;
- }
- public int doStartTag()throws JspTagException{ return SKIP_BODY;
- }
- public int doEndTag() throws JspTagException{ try{
- // there is tag logic String errorMessages = "";
- FacesContext ctx = FacesContext.getCurrentInstance(); if(ctx.getMessages()!=null){
- for (Iterator i = ctx.getMessages(); i.hasNext(); ) { FacesMessage o = (FacesMessage) i.next();
- errorMessages = errorMessages + o.getDetail(); }
- } if(!errorMessages.equals(""))
- pageContext.getOut().write(errorMessages); }catch(IOException e){
- throw new JspTagException(e.getMessage()); }
- return EVAL_PAGE; }
- public void release(){
- }
- public PageContext getPageContext() {
- return pageContext; }
- public Tag getParent() {
- return parent; }
- }
因为仅仅是为了在页面上显示 validation 信息,所以没有必要在 faces-config.xml 中注册。为了在JSP页面中可用,需要在TLD中进行声明如下:
xml 代码
- xml version="1.0" encoding="ISO-8859-1" ?> <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-jsptablibrary_2_0.xsd"
- version="2.0"> <description>Demo</<!---->description>
- <tlib-version>1.0</<!---->tlib-version>
- <short-name>Demo Tag<!----></short-name> <uri>http://com.demo/tags</<!---->uri>
- <tag> <description>This is a Tag for Validation Error Message<!----></description>
- <name>errorMessage<!----></name> <tag-class>com.cxxx.xxx.ValidatorTag</<!---->tag-class>
- <body-content>empty</<!---->body-content> <!----></tag>
- <!----></taglib>