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. }  
55. } 

因為僅僅是為了在頁面上顯示 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標簽