使JSF支持帶有HTMLMessage

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>