一.自定义标签入门

1.步骤

  • 标签处理类(标签也是一个对象,那么就需要先由类!)
  • tld文件,它是一个xml
  • 页面中使用<%@taglib%>来指定tld文件的位置

2.标签处理类

  • SimpleTag接口
  • void doTag():每次执行标签时都会调用这个方法
  • JspTag getParent():返回父标签(非生命周期方法)
  • void setParent(JspTag):设置父标签
  • void setJspBody(JspFragment):设置标签体
  • void seetJspContext(JspContext):设置jsp上下文对象,它儿子是PageContext
  • 其中doTag()会在其他三个方法之后被tomcat调用
/*
 * 自定义标签 1
 */
public class MyTag implements SimpleTag {

    private PageContext pageContext;
    private JspFragment body;

    /*
     * 所有的setXxx()方法都会在doTag()方法之前被tomcat调用
     * 所在doTag()中就可以使用tomcat传递过来的对象了
     */
    @Override
    public void doTag() throws JspException, IOException {
        pageContext.getOut().print("Hello Tag!");

    }

    @Override
    public JspTag getParent() { 
        return null;
    }

    @Override
    public void setJspBody(JspFragment body) {
    this.body=body;

    }

    @Override
    public void setJspContext(JspContext context) {
        this.pageContext=(PageContext) context;

    }

    @Override
    public void setParent(JspTag arg0) {

    }

}

3.配置tld文件

  • tld文件一般都放到WEB-INF下,这样保证客户端访问不到
<?xml version="1.0" encoding="UTF-8" ?>

<taglib xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd"
    version="2.1">

  <tlib-version>1.0</tlib-version>
  <short-name>st</short-name>
  <uri>http://www.zhoushicanyin.cn/tags/1.0</uri>

  <tag>
      <name>myTag1</name>
      <tag-class>cn.st.web.Tag.MyTag</tag-class><!--指定当前标签的标签处理类-->
      <body-content>empty</body-content><!--指定标签体的类型,我们这里使用的是空标签!-->
  </tag>
</taglib>

4.页面中指定tld文件位置

<%@ taglib prefix="st" uri="/WEB-INF/tlds/st.tld" %>
<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@ taglib prefix="st" uri="/WEB-INF/tlds/st.tld" %>    
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
         <h1><st:myTag1/></h1>
</body>
</html>

页面显示效果

Hello Tag!

5.更简单的方法继承SimpleTagSupport,这个类实现了SimpleTag接口,只需要重写doTag方法

/*
 *     SimpleTagSupport它实现了SimpleTag接口
 *     它已经把所有的tomcat传递的数据都保存起来了!而且还提供了get方法供子类调用!
 */
public class MyTag2 extends SimpleTagSupport {

           @Override
        public void doTag() throws JspException, IOException {
            this.getJspContext().getOut().print("再Hello 一次!!!");;
        }
}
<tag>
      <name>myTag2</name>
      <tag-class>cn.st.web.Tag.MyTag2</tag-class>
      <body-content>empty</body-content>
  </tag>
<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@ taglib prefix="st" uri="/WEB-INF/tlds/st.tld" %>    
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
         <h2><st:myTag2/></h2>
</body>
</html>

页面显示效果

再Hello 一次!!!

二.标签体内容

  • empty:无标签体
  • JSP: jsp2.0已经不再支持这个类型了!表示标签体内容可以是:java脚本,可以是标签,可以是el表达式
  • scriptless:只能是EL表达式,也可以是其他的标签
  • tagdependent:标签体内容不会被执行,而是直接赋值标签处理类!
    一般选择第一个或者第三个
public class MyTag3 extends SimpleTagSupport {
          @Override
        public void doTag() throws JspException, IOException {
             Writer out=this.getJspContext().getOut();
             out.write("<br/>*******************<br/>");//获取当然jsp页面的输出流
            this.getJspBody().invoke(out);//执行标签体内容,把结果写到指定的流中,即页面上
             out.write("<br/>*******************<br/>");
            super.doTag();
        }
}
<tag>
      <name>myTag3</name>
      <tag-class>cn.st.web.Tag.MyTag3</tag-class>
      <body-content>scriptless</body-content>
  </tag>
<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@ taglib prefix="st" uri="/WEB-INF/tlds/st.tld" %>    
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>

         <%
          request.setAttribute("xxx","ZhangSan");

         %>
       <st:myTag3>
       ${xxx }
       </st:myTag3>
       <st:myTag3>
              我是张三的大哥
       </st:myTag3>
</body>
</html>

页面显示效果

*******************
 ZhangSan 
*******************

*******************
我是张三的大哥 
*******************

三.不再执行标签下面内容的标签

  • 如果希望在执行了自定义标签后,不再执行JSP页面下面的东西,那么就需要在doTag()方法中使用SkipPageException
  • 在标签处理类中的doTag()中使用SkipPageException来结束!
  • Tomcat会调用标签处理类的doTag()方法,然后Tomcat会得到SkipPageException 它会跳过本页面其他内容
public class MyTag4 extends SimpleTagSupport{
           @Override
        public void doTag() throws JspException, IOException {
            this.getJspContext().getOut().print("你只看得到我,看不到下面的");
            throw new SkipPageException();//抛出这个异常,在本标签后的内容,都将看不到
        }
}
<tag>
      <name>myTag4</name>
      <tag-class>cn.st.web.Tag.MyTag4</tag-class>
      <body-content>empty</body-content>
  </tag>
<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@ taglib prefix="st" uri="/WEB-INF/tlds/st.tld" %>    
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>

         <st:myTag4></st:myTag4>

         <%
          request.setAttribute("xxx","ZhangSan");

         %>
       <st:myTag3>
       ${xxx }
       </st:myTag3>
       <st:myTag3>
              我是张三的大哥
       </st:myTag3>

</body>
</html>

页面显示效果

你只看得到我,看不到下面的

四.有属性的标签

1. 步骤

  • 给你的标签处理类添加属性! 为添加处理类添加属性,属性至少要且一个set方法,这个set方法会在doTag方法之前被tomcat调用,所在doTag中就可以使用属性了
/*
 * 带属性标签
 */
public class MyTag5 extends SimpleTagSupport {

    private boolean test;

    public void setTest(boolean test) {
             this.test=test;
    }

       @Override
    public void doTag() throws JspException, IOException {
        if(test) {
            /*
             * 执行标签体
             */
            this.getJspBody().invoke(null);//如果传递的输出流是null,表示就是使用当前页面的out
        }
    }
}
  • 在tld文件中对属性进行配置
<tag>
      <name>myTag5</name>
      <tag-class>cn.st.web.Tag.MyTag5</tag-class>
      <body-content>scriptless</body-content>
       <attribute>
          <name>test</name><!--指定属性名-->
          <required>true</required><!--指定属性是否为必须的-->
          <rtexprvalue>true</rtexprvalue><!--指属性是否可以是EL-->
       </attribute>
  </tag>
<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@ taglib prefix="st" uri="/WEB-INF/tlds/st.tld" %>    
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>


         <st:myTag5 test="${ empty param.xxx}">
         <st:myTag4></st:myTag4>
         </st:myTag5> 

         <%
          request.setAttribute("xxx","ZhangSan");

         %>
       <st:myTag3>
       ${xxx }
       </st:myTag3>
       <st:myTag3>
              我是张三的大哥
       </st:myTag3>

</body>
</html>

访问地址

http://localhost:8080/javaweb11/index.jsp

页面显示效果

你只看得到我,看不到下面的

访问地址

http://localhost:8080/javaweb11/index.jsp?xxx=XXX

页面显示效果

*******************
 ZhangSan 
*******************

*******************
我是张三的大哥 
*******************

END!!!!!!!!!!!!!!!!!!!