又回鍋弄Struts2……
看完uitag這部份,發現一個問題,就是如果我要一個pagebar這樣的UITag怎么辦?總不能每一頁我都在JSP上寫吧?就算是復制都很不聰明。于是開始研究怎么去寫一個Tag,在網站找了N多文章,大都是用out.println(...)這樣的方式,而沒有使用template的方式,自己總覺得這樣的方式不靈活而且麻煩,容易出錯,于是查看struts2的源碼,終于找出怎么去寫Struts2 Tag的方法。
Struts2 的UITag原理:
Struts2 UITag分三部份組成,一部份用于定義Tag的內容與邏輯的UIBean,一部份用于定義JSP Tag,也就是平時我們定義的那種,最后就是Template,它存放在你的theme目錄之下,是一個FreeMarker模板文件。
我現在輯寫一份MMTag,它主要是用于輸出帶鏈接的文字,比如像這樣:
<cur:mm message="'I am a boy.'" />
就會輸出:
<a href="http://www.tkk7.com/natlive">I am boy.</a>
我們先寫UIBean部份:我們把它定義為MM,它繼承于org.apache.struts2.components.UIBean:
package limitstudy.corestruts2.tag;
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;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
@StrutsTag(name="mm", tldTagClass="limitstudy.corestruts2.tag.MMTag", description="MM")
public class MM extends UIBean {
private String message;
public MM(ValueStack stack, HttpServletRequest request, HttpServletResponse response) {
super(stack, request, response);
}
@Override
protected String getDefaultTemplate() {
return "mm";
}
@StrutsTagAttribute(description="set message", type="String")
public void setMessage(String message) {
this.message = message;
}
@Override
protected void evaluateExtraParams() {
super.evaluateExtraParams();
if (null != message) {
addParameter("message", findString(message));
}
}
}
* 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。
然后是Tag部份:
package limitstudy.corestruts2.tag;
import org.apache.struts2.views.jsp.ui.AbstractUITag;
import org.apache.struts2.components.Component;
import com.opensymphony.xwork2.util.ValueStack;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class MMTag extends AbstractUITag {
private String message;
@Override
public Component getBean(ValueStack stack, HttpServletRequest request, HttpServletResponse response) {
return new MM(stack, request, response);
}
@Override
protected void populateParams() {
super.populateParams();
MM mm = (MM)component;
mm.setMessage(message);
}
public void setMessage(String message) {
this.message = message;
}
}
*
getBean()返回該Tag中的UIBean。
* populateParams()初始化參數,一般用來初始化UIBean(Component)。
* setXXXX設置屬性,和jsp tag是一樣的。
在/WEB-INF/tlds/下建立current.tld文件(文名隨你喜歡):
<?xml version="1.0" encoding="UTF-8"?>
<taglib xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.0"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd">
<description>test</description>
<tlib-version>2.0</tlib-version>
<short-name>cur</short-name>
<uri>/cur</uri>
<tag>
<name>mm</name>
<tag-class>limitstudy.corestruts2.tag.MMTag</tag-class>
<body-content>JSP</body-content>
<attribute>
<name>message</name>
<required>true</required>
</attribute>
</tag>
</taglib>
在源代碼目錄中建立template/simple目錄(這個目錄名和你的theme有關),然后在里面建一個mm.ftl文件:
<a href="http://www.yinsha.com">${parameters.message?html}</a>
建一個action測試一下,視圖文件:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib prefix="s" uri="/struts-tags" %>
<%@ taglib prefix="cur" uri="/cur" %>
<html>
<head>
<title><s:property value="message" /></title>
</head>
<body>
<cur:mm message="haoahahhahaha" />
</body>
</html>
完。
PS:寫得有些粗鄙,所以,如有問題的,可以留言。