自定义简单的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>

五：效果图