來源：http://www.blogjava.net/natlive/archive/2009/05/21/271890.html
Struts2 的UITag原理：
Struts2 UITag分三部份組成，一部份用于定義Tag的內容與邏輯的UIBean，一部份用于定義JSP Tag，也就是平時我們定義的那種，最后就是Template，它存放在你的theme目錄之下，是一個FreeMarker模板文件。
我現在輯寫一份MMTag，它主要是用于輸出帶鏈接的文字，比如像這樣：
<cur:mm message="'I am a boy.'" />
就會輸出：
<a href="http://www.blogjava.net/natlive">I am boy.</a>
文件配置：
tangs.tld
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
<taglib><tlib-version>2.2.3</tlib-version><jsp-version>1.2</jsp-version><short-name>tangs</short-name><uri>/tangs</uri><display-name>"Tangs Tags"</display-name><tag><name>button</name><tag-class>com.gq.tag.button.ButtonTag</tag-class><body-content>empty</body-content><attribute><name>items</name><required>true</required><rtexprvalue>true</rtexprvalue></attribute></tag><tag><name>mm</name><tag-class>com.gq.tag.mm.MmTag</tag-class><body-content>JSP</body-content><attribute><name>message</name><required>true</required><rtexprvalue>true</rtexprvalue></attribute></tag></taglib>
MmTag.java
* getBean（）返回該Tag中的UIBean。
* populateParams()初始化參數，一般用來初始化UIBean(Component)。
* setXXXX設置屬性，和jsp tag是一樣的
/**
*創建日期 :2011-11-16
*創建用戶 :GongQiang
*變更情況 :
*文檔位置 $Archive:test_struct2/com.gq.tag.mm/MmTag.java$
*最后變更 $Author: $
*變更日期 $Date: $
*當前版本 $Revision: $
*
*Copyright (c) 2004 Sino-Japanese Engineering Corp, Inc. All Rights Reserved.
*/
package com.gq.tag.mm;import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;import org.apache.struts2.components.Component;
import org.apache.struts2.views.jsp.ui.AbstractUITag;import com.opensymphony.xwork2.util.ValueStack;public class MmTag extends AbstractUITag {private static final long serialVersionUID = 1L;private String message;@Overridepublic Component getBean(ValueStack stack, HttpServletRequest request, HttpServletResponse response) {return new MmBean(stack, request, response);}@Overrideprotected void populateParams() {super.populateParams();MmBean mm = (MmBean)component;mm.setMessage(message);}public void setMessage(String message) {this.message = message;}
}
MmBean.java
* strutsTag注解指明了該UIBean的名字和Tag類的類名。
* getDefaultTemplate()方法用于返回模板的名字，Struts2會自動在后面加入.ftl擴展名以找到特定的模板文件。
* setXXX，設置UIBean的屬性，一般Tag中有幾個這樣的屬性，這里就有幾個。@StrutsTagAttribute(description="set message", type="String")注解，說明該屬性是字符串（也可以是其它），這一步很重要。
* 覆寫evaluateExtraParams（）方法，在UIBean初始化后會調用這個方法來初始化設定參數，如addParameter方法，會在freemarker里的parameters里加入一個key value。這里要注意findString，還有相關的findxxxx方法，它們是已經封裝好了的解釋ognl語法的工具，具體是怎么樣的，大家可以查看一下UIBean的api doc。
/**
*創建日期 :2011-11-16
*創建用戶 :GongQiang
*變更情況 :
*文檔位置 $Archive:test_struct2/com.gq.tag.mm/MmBean.java$
*最后變更 $Author: $
*變更日期 $Date: $
*當前版本 $Revision: $
*
*Copyright (c) 2004 Sino-Japanese Engineering Corp, Inc. All Rights Reserved.
*/
package com.gq.tag.mm;import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;import org.apache.struts2.components.UIBean;
import org.apache.struts2.views.annotations.StrutsTag;
import org.apache.struts2.views.annotations.StrutsTagAttribute;import com.opensymphony.xwork2.util.ValueStack;@StrutsTag(name="mm", tldTagClass="com.gq.tag.mm.MmTag", description="MM")
public class MmBean extends UIBean {private String message;public MmBean(ValueStack stack, HttpServletRequest request, HttpServletResponse response) {super(stack, request, response);}@Overrideprotected String getDefaultTemplate() {return "mm";}@StrutsTagAttribute(description="set message", type="String")public void setMessage(String message) {this.message = message;}@Overrideprotected void evaluateExtraParams() {super.evaluateExtraParams();if ( message != null ) {addParameter("message", findString(message));System.out.println( "auto_rule_match--->" + findString(message) );System.out.println( "ongl--->" + getStack().findValue( message ) );}}
}
findString( ) 方法并沒有想象中的智能，如下說明：
mmTag.jsp 有如下兩個標簽：
頁面直接給定屬性<br/><tangs:mm message="hahahaha..."/><br/><br/>運行時獲取值<br/><tangs:mm message="name"/>
但是，通過findString( ) 方法，name 并
沒能轉換成其對應的值（“Foo”），而是
直接輸出了。
auto_rule_match--->hahahaha...
ongl--->null
auto_rule_match--->name
ongl--->FoofindString( ) 會去解析
其值而
非本身的兩種格式：${ xxx } 或 %{ xxx }
在源代碼目錄中建立template/simple目錄（這個目錄名和你的theme有關），然后在里面建一個mm.ftl文件：
<a href="http://www.yinsha.com">${parameters.message?html}</a>
以上，tangs.tld、MmTag.java、MmBean.java 和 mm.ftl 就完成了<tangs:mm />的定義。
演示：
struts.xml 中添加 action ： MmTag
<!-- 演示標簽 --><package name="tag" extends="struts-default" namespace="/tag"><action name="Tag" class="com.gq.action.TagTestAction"><result name="success">/tagTest/tags.jsp</result><interceptor-ref name="defaultStack"/></action><action name="ButtonTag" class="com.gq.tag.button.ButtonActionTest"><result name="success">/tagTest/buttonTag.jsp</result><interceptor-ref name="defaultStack"/></action><action name="MmTag" class="com.gq.tag.mm.MmActionTest"><result name="success">/tagTest/mmTag.jsp</result><interceptor-ref name="defaultStack"/></action></package>
MmActionTest.java
/**
*創建日期 :2011-11-16
*創建用戶 :GongQiang
*變更情況 :
*文檔位置 $Archive:test_struct2/com.gq.tag.mm/MmActionTest.java$
*最后變更 $Author: $
*變更日期 $Date: $
*當前版本 $Revision: $
*
*Copyright (c) 2004 Sino-Japanese Engineering Corp, Inc. All Rights Reserved.
*/
package com.gq.tag.mm;import com.opensymphony.xwork2.ActionSupport;public class MmActionTest extends ActionSupport {private static final long serialVersionUID = 1L;public String getName(){return "Foo";}@Overridepublic String execute() throws Exception {return SUCCESS;}
}
mmTag.jsp
<%@ page language="java" pageEncoding="UTF-8"%>
<%@taglib prefix="s" uri="/struts-tags" %>
<%@taglib prefix="tangs" uri="/tangs" %>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";
%><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><base href="<%=basePath%>"><title>My JSP 'buttonTag.jsp' starting page</title></head><body>頁面直接給定屬性<br/><tangs:mm message="hahahaha..."/><br/><br/>運行時獲取值<br/><tangs:mm message="%{name}"/></body>
</html>
圖示頁面：
總結
以上是生活随笔為你收集整理的Struts2自定义标签（template）——示例的全部內容，希望文章能夠幫你解決所遇到的問題。
如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。
