随笔-124  评论-49  文章-56  trackbacks-0
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>

我们先写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文件:

<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: 写得有些粗鄙,所以,如有问题的,可以留言。

 

 

 

http://devilkirin.javaeye.com/blog/427395

http://xiaojianhx.javaeye.com/blog/482888
posted on 2011-05-30 21:43 junly 阅读(1099) 评论(1)  编辑  收藏 所属分类: struts2/struts1.3/JSF

评论:
# re: Struts2 自定义标签的方法[未登录] 2014-04-03 10:12 |
我自己写了一个自定义标签,但是我现在需要一个扩展struts2的自定义标签,找到好久还是没有头绪,急需赐教,如方便,请加2359428382。多谢。
  回复  更多评论
  

只有注册用户登录后才能发表评论。


网站导航: