自定义标签库入门

于 2018-06-04 19:59:52 发布
阅读量1.8k 收藏 2
点赞数
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/qq_35287067/article/details/80572149
版权

入门

1. 步骤
  * 标签处理类（标签也是一个对象，那么就需要先有类！）
  * tld文件，它是一个xml
  * 页面中使用<%@taglib%>来指定tld文件的位置
2. 标签处理类
  SimpleTag接口：
  * void doTag()：每次执行标签时都会调用这个方法；
  * JspTag getParent()：返回父标签（非生命周期方法）
  * void setParent(JspTag)：设置父标签
  * void setJspBody(JspFragment)：设置标签体
  * void seetJspContext(JspContext)：设置jsp上下文对象，它儿子是PageContext
　　其中doTag()会在其他三个方法之后被tomcat调用。
3. 配置tld文件
tld文件一般都放到WEB-INF之下，这样保证客户端访问不到！
  <tag>
  <name>myTag1</name> 指定当前标签的名称
  <tag-class>cn.itcast.tag.MyTag1</tag-class> 指定当前标签的标签处理类！
  <body-content>empty</body-content> 指定标签体的类型，我们这里使用的是空标签！
  </tag>
4. 页面中指定tld文件位置
<%@ taglib prefix="it" uri="/WEB-INF/tlds/itcast-tag.tld" %>

导标签库，就是为页面指定tld文件的位置！

package cn.itcast.tag;

import java.io.IOException;

import javax.servlet.jsp.JspContext;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.tagext.JspFragment;
import javax.servlet.jsp.tagext.JspTag;
import javax.servlet.jsp.tagext.SimpleTag;

/**
 * 自定义标签 1
 * 
 * @author Administrator
 *
 */
public class MyTag1 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;
	}

	public void setParent(JspTag parent) {

	}

}

itcast-tag.tld

<?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>itcast</short-name>
	<uri>http://www.itcast.cn/tags/it-1.0</uri>
	
	<tag>
		<name>myTag1</name>   <!-- 指定当前标签的名称 -->
		<tag-class>cn.itcast.tag.MyTag1</tag-class>   <!-- 指定当前标签的标签处理类 -->
		<body-content>empty</body-content>		<!-- 指定标签体的类型 我们这里使用空标签 -->
	</tag>
	
	<tag>
		<name>myTag2</name>   <!-- 指定当前标签的名称 -->
		<tag-class>cn.itcast.tag.MyTag2</tag-class>   <!-- 指定当前标签的标签处理类 -->
		<body-content>empty</body-content>		<!-- 指定标签体的类型 我们这里使用空标签 -->
	</tag>

</taglib>

index.jsp

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ taglib prefix="it" uri="/WEB-INF/tlds/itcast-tag.tld" %>
<%
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>
    <base href="<%=basePath%>">
    
    <title>My JSP 'index.jsp' starting page</title>
	<meta http-equiv="pragma" content="no-cache">
	<meta http-equiv="cache-control" content="no-cache">
	<meta http-equiv="expires" content="0">    
	<meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
	<meta http-equiv="description" content="This is my page">
	<!--
	<link rel="stylesheet" type="text/css" href="styles.css">
	-->
  </head>
  
  <body>
    <h1> <it:myTag1/></h1>
    <h2> <it:myTag2/></h2>
  </body>
</html>

简便用法 直接继承SimpleTagSupport类

package cn.itcast.tag;

import java.io.IOException;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.SimpleTagSupport;

/**
 * SimpleTagSupport 它实现了simpleTag接口
 * 已经把所有tomcat传递的数据都保存起来了 而且还提供了get方法给子类调用
 * @author Administrator
 *
 */
public class MyTag2 extends SimpleTagSupport {
	@Override
	public void doTag() throws JspException, IOException {
		//this.getJspBody();
		this.getJspContext().getOut().print("第二次Hello");;
		
	}
}

进阶

标签体内容
  * empty：无标签体！
  * JSP：jsp2.0已经不在支持这个类型了！表示标签体内容可以是：java脚本，可以是标签，可以是el表达式(过时)
  * scriptless：只能是EL表达式，也可以是其他的标签！

  * tagdependent：标签体内容不会被执行，而是直接赋值标签处理类！(过时)

所以一般只需要懂empty和scriptless标签,empty标签在入门已经学了,所以接下来是scriptless标签

MyTag3.java

package cn.itcast.tag;

import java.io.IOException;
import java.io.Writer;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.SimpleTagSupport;

public class MyTag3 extends SimpleTagSupport {
	@Override
	public void doTag() throws JspException, IOException {
		Writer out = this.getJspContext().getOut();	//获取当前jsp页面的输出流
		out.write("***************<br/>");
		this.getJspBody().invoke(out);	//执行标签体内容,把页面写到指定的流中,即页面上
		out.write("<br/>***************");
	}
}

<tag>
		<name>myTag3</name>   <!-- 指定当前标签的名称 -->
		<tag-class>cn.itcast.tag.MyTag3</tag-class>   <!-- 指定当前标签的标签处理类 -->
		<body-content>scriptless</body-content>		<!-- 指定标签体的类型 我们这里使用scriptless标签 -->
	</tag>
<hr />
	<%
		request.setAttribute("xxx", "zhangsan");
	%>
	<h3>
		<it:myTag3>
			<!-- 这里面可以写标签体内容 -->
    	${xxx }  
    </it:myTag3>
	</h3>
	<h3>
		<it:myTag3>
			<!-- 这里面可以写标签体内容 -->
    	我是张三的大哥
    </it:myTag3>
	</h3>

不在执行标签下面内容的标签！

在标签处理类中的doTag()中使用SkipPageException来结束！

Tomcat会调用标签处理类的doTag()方法，然后Tomcat会得到SkipPageException，它会跳过本页面其他内容！

MyTag4.java

package cn.itcast.tag;

import java.io.IOException;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.SkipPageException;
import javax.servlet.jsp.tagext.SimpleTagSupport;

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.itcast.tag.MyTag4</tag-class>   <!-- 指定当前标签的标签处理类 -->
		<body-content>empty</body-content>		<!-- 指定标签体的类型 我们这里使用空标签 -->
	</tag>
<body>
<it:myTag4/>
	<h1>
		<it:myTag1 />
	</h1>
	<h2>
		<it:myTag2 />
	</h2>
	<hr />
	<%
		request.setAttribute("xxx", "zhangsan");
	%>
	<h3>
		<it:myTag3>
			<!-- 这里面可以写标签体内容 -->
    	${xxx }  
    </it:myTag3>
	</h3>
	<h3>
		<it:myTag3>
			<!-- 这里面可以写标签体内容 -->
    	我是张三的大哥
    </it:myTag3>
	</h3>
	<h1>12321312</h1>
</body>
4执行结果

标签属性

步骤：
1. 给你的标签处理类添加属性！
　　为标签处理类添加属性，属性至少要且一个set方法！这个set方法会在doTag()方法之前被tomcat执行！所在doTag()中就可以使用属性了。
2. 在tld文件中对属性进行配置
  <attribute>
  <name>test</name> 指定属性名
  <required>true</required> 指定属性是否为必需的
  <rtexprvalue>true</rtexprvalue> 指定属性是否可以使用EL
  </attribute> 
package cn.itcast.tag;

import java.io.IOException;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.SimpleTagSupport;

/**
 * 有属性的标签
 * @author Administrator
 *
 */
public class MyTag5 extends SimpleTagSupport {
	private boolean test;
	
	//可以不用get方法
	public boolean isTest() {
		return test;
	}
	
	//这个方法由tomcat调用.并且在dooTag()之前被调用
	public void setTest(boolean test) {
		this.test = test;
	}

	@Override
	public void doTag() throws JspException, IOException {
		if(test){
			/*
			 * 执行标签体
			 */
			this.getJspBody().invoke(null); 	//如果传递的输出流为null,表示使用的就是当前页面的out
			//==this.getJspBody().invoke(this.getJspContext().getOut()); 
		}
	}
}

<tag>
		<name>myTag5</name>   <!-- 指定当前标签的名称 -->
		<tag-class>cn.itcast.tag.MyTag5</tag-class>   <!-- 指定当前标签的标签处理类 -->
		<body-content>scriptless</body-content>		<!-- 指定标签体的类型 我们这里使用空标签 -->
		<attribute>
			<name>test</name>	 <!-- 指定属性名 -->
			<required>true</required>	<!-- 指定属性是否为必需的 -->
			<rtexprvalue>true</rtexprvalue>		<!--指定属性是否可以使用EL-->
		</attribute>

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





评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值