自定义简单的struts2的s标签

一：自定标签前需要了解的知识：

BodyTagSupport类的方法:
编写标签对应的实现类时，需要重载BodyTagSupport类几个方法：doStartTag(), setBodyContent(), doInitBody(), doAfterBody(), doEndTag();

他们执行顺序如下：
doStartTag()→doInitBody()→setBodyContent()→doAfterBody()→doEndTag()

doStartTag()方法可返回EVAL_BODY_INCLUDE或SKIP_BODY，
如果返回EVAL_BODY_INCLUDE则继续执行；
如果返回SKIP_BODY则接下来的doInitBody(),setBodyContent(), doAfterBody()三个方法不会被执行，
而直接执行doEndTag()方法。

setBodyContent()方法用于设置标签体内容，如果在此之前要作一些初始化工作，则在doInitBody()方法中完成。
标签体内容执行完后，会调用doAfterBody()方法，此方法可返回EVAL_BODY_TAG, SKIP_BODY,
EVAL_PAGE或SKIP_PAGE。
如果返回EVAL_BODY_TAG则会再次设置标签体内容，直到返回SKIP_BODY；
如果返回EVAL_PAGE则标签体执行完后会继续执行JSP页面中接下来的部分；
如果返回SKIP_PAGE，则JSP页面的后续内容将不再执行。

标签中静态常量:

EVAL_BODY_INCLUDE：告诉服务器正文的内容，并把这些内容送入输出流
SKIP_BODY：告诉服务器不要处理正文内容
EVAL_PAGE：让服务器继续执行页面
SKIP_PAGE：让服务器不要处理剩余的页面
EVAL_BODY_AGAIN：让服务器继续处理正文内容，只有doAfterBody方法可以返回
EVAL_BODY_BUFFERED：BodyTag接口的字段，在doStartTag()返回
EVAL_BODY_INCLUDE、SKIP_BODY一般由doStartTag()返回，而EVAL_PAPGE、SKIP_PAGE由doEndTag()返回。

二：自定义标签调用的SeclectAllSt.java类，SeclectStBySex.java类继承TagSupport类

package com.bjsxt.sxf.tag;

import java.io.IOException;
import java.util.List;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.TagSupport;

import org.apache.struts2.ServletActionContext;
import org.springframework.context.ApplicationContext;
import org.springframework.web.context.support.WebApplicationContextUtils;

import com.bjsxt.sxf.dao.StudentDao;
import com.bjsxt.sxf.po.Student;
/**
 * 简单的自定义Struts2标签，没有属性的
* @ClassName: SeclectAllSt 
* @Description: TODO(这里用一句话描述这个类的作用) 
* @author 尚晓飞
* @date 2014-10-21 下午3:21:16 
*
 */
public class SeclectAllSt extends TagSupport {
    private static final long serialVersionUID = 1L;

    //空构造
    public SeclectAllSt(){
        System.out.println("SeclectAllSt.SeclectAllSt(构造函数)");
    }
    
    //标签执行顺序 doStartTag()→doInitBody()→setBodyContent()→doAfterBody()→doEndTag()
    //标签开始访问
    @Override
    public int doStartTag() throws JspException {
        // TODO Auto-generated method stub
        System.out.println("SeclectAllSt.doStartTag(开始运行标签函数)");
        return SKIP_BODY;//则接下来的doInitBody(),setBodyContent(), doAfterBody()三个方法不会被执行，而直接执行doEndTag()方法
    }
    
    //标签结束访问
    @Override
    public int doEndTag() throws JspException {
        // TODO Auto-generated method stub
        System.out.println("SeclectAllSt.doEndTag(标签结束运行函数)");
        //查询出所有学生的信息
        //获取ioc容器（ssh中spring）
        ApplicationContext app = WebApplicationContextUtils.getWebApplicationContext(ServletActionContext.getServletContext());
        //获取与数据库交互的dao
        StudentDao dao=(StudentDao) app.getBean("StudentDao");
        //查询出所有的学生信息
        List<Student> students=dao.queryAll();
        //通过父类TagSupport的属性值pageContext 取得相关的内置对象   
        //=============pageContext还可以get更多的内置对象。   
        //     pageContext.getRequest();   
        //     pageContext.getResponse();   
        //     pageContext.getSession();   
        //     pageContext.getServletContext();   
        JspWriter out=pageContext.getOut();
        //遍历循环打印
    
        try {
            out.print("<table border="1">");
                out.print("<tr>");
                    out.print("<td>id</td>");
                    out.print("<td>姓名</td>");
                    out.print("<td>性别</td>");
                    out.print("<td>班级</td>");
                        out.print("</tr>");
                for(int i=0;i<students.size();i++){
                    Student student=students.get(i);
                    out.print("<tr>");
                            out.print("<td>"+student.getId()+"</td>");
                            out.print("<td>"+student.getName()+"</td>");
                            out.print("<td>"+student.getSex()+"</td>");
                            out.print("<td>"+student.getClassRoom().getName()+"</td>");
                    out.print("</tr>");
                }
            
           out.print("</table>");
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
            
        return EVAL_PAGE;
    }

    

    
    
    
}



package com.bjsxt.sxf.tag;

import java.io.IOException;
import java.util.List;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.TagSupport;

import org.apache.struts2.ServletActionContext;
import org.springframework.context.ApplicationContext;
import org.springframework.web.context.support.WebApplicationContextUtils;

import com.bjsxt.sxf.dao.StudentDao;
import com.bjsxt.sxf.po.Student;
/**
 * 有属性的标签（根据性别）
* @ClassName: SeclectStBySex 
* @Description: TODO(这里用一句话描述这个类的作用) 
* @author 尚晓飞
* @date 2014-10-21 下午3:56:48 
*
 */
public class SeclectStBySex extends TagSupport{
    private static final long serialVersionUID = 1L;
    private String sex;//标签属性传递的值，会通过set get方法
    
    //标签开始执行的方法
    @Override
    public int doStartTag() throws JspException {
        System.out.println("SeclectStBySex.doEndTag(标签开始)");
        return SKIP_BODY;
    } 

    //最后执行的方法
    @Override
    public int doEndTag() throws JspException {
        // TODO Auto-generated method stub
                System.out.println("SeclectAllSt.doEndTag(标签结束运行函数)");
                //查询出所有学生的信息
                //获取ioc容器（ssh中spring）
                ApplicationContext app = WebApplicationContextUtils.getWebApplicationContext(ServletActionContext.getServletContext());
                //获取与数据库交互的dao
                StudentDao dao=(StudentDao) app.getBean("StudentDao");
                //查询出指定性别的学生集合
                List<Student> students=dao.queryBySex(sex);
                //通过父类TagSupport的属性值pageContext 取得相关的内置对象   
                //=============pageContext还可以get更多的内置对象。   
                //     pageContext.getRequest();   
                //     pageContext.getResponse();   
                //     pageContext.getSession();   
                //     pageContext.getServletContext();   
                JspWriter out=pageContext.getOut();
                //遍历循环打印
            
                try {
                    out.print("<table border="1">");
                        out.print("<tr>");
                            out.print("<td>id</td>");
                            out.print("<td>姓名</td>");
                            out.print("<td>性别</td>");
                            out.print("<td>班级</td>");
                                out.print("</tr>");
                        for(int i=0;i<students.size();i++){
                            Student student=students.get(i);
                            out.print("<tr>");
                                    out.print("<td>"+student.getId()+"</td>");
                                    out.print("<td>"+student.getName()+"</td>");
                                    out.print("<td>"+student.getSex()+"</td>");
                                    out.print("<td>"+student.getClassRoom().getName()+"</td>");
                            out.print("</tr>");
                        }
                    
                   out.print("</table>");
                } catch (IOException e) {
                    // TODO Auto-generated catch block
                    e.printStackTrace();
                }
        return EVAL_PAGE;
    }

    
    public String getSex() {
        return sex;
    }

    public void setSex(String sex) {
        this.sex = sex;
    }
    
    
}

三：在项目webroot/web-inf/下建立自定义标签库的.tld文件 str.tld

<?xml version="1.0" encoding="UTF-8"?>  
    <!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN" "http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd">  
    <taglib>     <!-- 自定义库标签的根 -->  
    <tlibversion>1.2</tlibversion>     <!-- 版本号 -->  
    <jspversion>1.1</jspversion>       <!-- JSP版本号 -->  
    <shortname>stu</shortname>        <!-- prefix="stu"标签名称-->  
    <uri>StudentTags</uri>   <!-- uri="StudentTags" 外界导入标签时，认识的名字，很重要。-->  
      
    <tag>  
     <name>selectAll</name>                            <!-- 标签名称 -->  
     <tagclass>com.bjsxt.sxf.tag.SeclectAllSt</tagclass>          <!-- 对应的java类的全路径 -->  
    </tag>  
      
    <!-- 有属性的标签，可以有多个属性  <attribute>并列 -->  
      <tag>  
           <name>selectBySex</name>  <!-- 标签名称 -->
            <tagclass>com.bjsxt.sxf.tag.SeclectStBySex</tagclass> 
            <attribute>   <!-- 对应标签的属性。 -->  
                 <name>sex</name>  
                 <required>true</required>  <!-- 是必需写的属性，即没有写属性标签不能被正常使用 -->  
            </attribute>         
       </tag>  
       
    </taglib>  

四：页面上测试jsp

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ taglib uri="StudentTags" prefix="stu" %>
<%
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>
  </head>
  
  <body>
    This is my JSP page. <br>
    <a href="<%=request.getContextPath()%>/StudentAction!reportStudent.action">班级表单下载</a>
    <!-- 查询出所有学生 -->
       <stu:selectAll></stu:selectAll>
       <!-- 查询出指定性别的学生 -->
       <stu:selectBySex sex="男"></stu:selectBySex>
  </body>
  
</html>

五：效果图