使JSF支持带有HTMLMessage

开发 后端
本文介绍JSF的HtmlMessage标签一般用于显示系统的Error或者Validation 消息。

JSF背景介绍

JSF 的 HtmlMessage 标签一般用于显示系统的 Error 或者 Validation 消息,至于其标准用法可以参考官方文档。在大部分的文章中,都讲解了其如何绑定到标签或者基于 table 和 list 去显示消息,但是这些消息都是标准的文字格式,没有夹带有 HTML tag。比如说,原有系统的所有 error 消息都是存在与 property 文件中

  1. ems=<b>Amount Countb> must be more than <font color=green>150$font> 

这种格式的消息在被 HtmlMessage tag 渲染显示后,全部变为了转义后的字符,也就是在页面中显示的和上面的文字完全相同。

由于 HtmlOutputText 控件有 escape 属性,所以可以很好地解决这种问题,可是在 HtmlMessage 控件中没有提供这种属性。

JSF解决方法

正是受到 HtmlOutputText 的影响,才想到能不能自己写一个类似的标签来解决相应的问题。那么问题的关键是这些 validation message 是在什么时候被转义的,是在传递到标签之前还是之后。如果是在传递到标签之前,那么这种方法是没有任何意义的,因为无论你的标签怎么写,你所接受到的都是已经转义后的内容了。

经过求证发现,所有的 FacesMessage 可以通过 FacesContext 获取到,而且 Message 中的消息都是没有转义之前的内容,这样就可以通过自定义标签来解决上面的问题了。

  1. package com.xxx.xxx;  
  2. import javax.servlet.jsp.*;  
  3. import javax.servlet.jsp.tagext.*;  
  4. import java.io.IOException;  
  5. import java.util.Iterator;  
  6. import javax.faces.application.FacesMessage;  
  7. import javax.faces.context.FacesContext;  
  8. public class ValidatorTag implements javax.servlet.jsp.tagext.Tag{  
  9. private PageContext pageContext;  
  10. private Tag parent;  
  11. public ValidatorTag() {  
  12. super();  
  13. }  
  14. /**  
  15. * configure tag context  
  16. */  
  17. public void setPageContext(PageContext pageContext){  
  18. this.pageContext = pageContext;  
  19. }  
  20. /**  
  21. * configure the last level tag  
  22. */  
  23. public void setParent(Tag parent){  
  24. this.parent = parent;  
  25. }  
  26. public int doStartTag()throws JspTagException{  
  27. return SKIP_BODY;  
  28. }  
  29. public int doEndTag() throws JspTagException{  
  30. try{  
  31. // there is tag logic  
  32. String errorMessages = "";  
  33. FacesContext ctx = FacesContext.getCurrentInstance();  
  34. if(ctx.getMessages()!=null){  
  35. for (Iterator i = ctx.getMessages(); i.hasNext(); ) {  
  36. FacesMessage o = (FacesMessage) i.next();  
  37. errorMessageserrorMessages = errorMessages + o.getDetail();  
  38. }  
  39. }  
  40. if(!errorMessages.equals(""))  
  41. pageContext.getOut().write(errorMessages);  
  42. }catch(IOException e){  
  43. throw new JspTagException(e.getMessage());  
  44. }  
  45. return EVAL_PAGE;  
  46. }  
  47. public void release(){  
  48. }  
  49. public PageContext getPageContext() {  
  50. return pageContext;  
  51. }  
  52. public Tag getParent() {  
  53. return parent;  
  54. }  

因为仅仅是为了在页面上显示 validation 信息,所以没有必要在 faces-config.xml 中注册。为了在JSP页面中可用,需要在TLD中进行声明如下:

  1. xml version="1.0" encoding="ISO-8859-1" ?> 
  2. <taglib xmlns="http://java.sun.com/xml/ns/j2ee" 
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  4. xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee web-jsptablibrary_2_0.xsd" 
  5. version="2.0"> 
  6. <description>Demo</description> 
  7. <tlib-version>1.0</tlib-version> 
  8. <short-name>Demo Tag</short-name> 
  9. <uri>http://com.demo/tags</uri> 
  10. <tag> 
  11. <description>This is a Tag for Validation Error Message</description> 
  12. <name>errorMessage</name> 
  13. <tag-class>com.cxxx.xxx.ValidatorTag</tag-class> 
  14. <body-content>empty</body-content> 
  15. </tag> 
  16. </taglib> 

【编辑推荐】

  1. JSF和AJAX企业级开发之路(一)
  2. JSF和AJAX企业级开发之路(二)
  3. 在JSF应用中捕捉managed-bean构造方法
  4. 表现层框架Struts/Tapestry/JSF比较
  5. 简单介绍JSF标签
责任编辑:佚名 来源: JavaEye
相关推荐

2012-02-24 15:25:45

ibmdw

2009-06-11 11:15:40

JSF开发工具

2009-09-23 17:56:45

JSF入门

2009-06-26 14:06:08

JSF基础框架

2009-06-25 11:11:25

控制JSF切入点

2009-06-26 13:48:57

G4JSFGWTJSF

2009-06-22 15:52:15

JSF测试框架

2009-06-26 10:22:58

JSF测试

2009-06-23 15:51:00

JSF框架

2009-06-24 13:06:41

JSF组件Facelets

2009-06-23 17:38:57

ExternalConJSF

2009-06-24 11:39:45

学习JSF

2009-06-22 13:27:01

JSF组件模型

2009-06-29 09:00:14

JSFJava

2009-06-23 09:53:10

JSF程序配置

2009-06-22 13:48:45

JSF是什么

2009-06-22 14:22:41

JSF和Tapestr

2009-06-29 13:06:25

JSF程序

2009-06-22 13:16:49

JavaServer JSF

2009-06-23 13:55:17

JSF标签
点赞
收藏

51CTO技术栈公众号