自定义标签开发

最新推荐文章于 2019-06-01 20:17:16 发布

涂文远

最新推荐文章于 2019-06-01 20:17:16 发布

阅读量341

点赞数

分类专栏： JavaEE

本文链接：https://blog.csdn.net/daividtu/article/details/53691514

版权

JavaEE 专栏收录该内容

37 篇文章 1 订阅

订阅专栏

自定义标签开发
1.自定义标签主要用于移除Jsp页面中的java代码
2.使用自定义标签移除jsp页面中的java代码，只需要完成以下两个步骤：
编写一个实现Tag接口的Java类(标签处理器类)
编写标签库描述符（tld）文件，在tld文件中对标签处理器类描述成一个标签

Tag接口的执行流程
JSP引擎将遇到自定义标签时，首先创建标签处理器类的实例对象，然后按照JSP规范定义的通信规则依次调用它的方法。
1、public void setPageContext(PageContext pc)， JSP引擎实例化标签处理器后，将调用setPageContext方法将JSP页面的pageContext对象传递给标签处理器，标签处理器以后可以通过这个pageContext对象与JSP页面进行通信。
2、public void setParent(Tag t)，setPageContext方法执行完后，WEB容器接着调用的setParent方法将当前标签的父标签传递给当前标签处理器，如果当前标签没有父标签，则传递给setParent方法的参数值为null。
3、public int doStartTag()，调用了setPageContext方法和setParent方法之后，WEB容器执行到自定义标签的开始标记时，就会调用标签处理器的doStartTag方法。
4、public int doEndTag()，WEB容器执行完自定义标签的标签体后，就会接着去执行自定义标签的结束标记，此时，WEB容器会去调用标签处理器的doEndTag方法。
5、public void release()，通常WEB容器执行完自定义标签后，标签处理器会驻留在内存中，为其它请求服务器，直至停止web应用时，web容器才会调用release方法。

JSP 实现Tag接口类图

开发人员在编写Jsp页面时，经常还需要在页面中引入一些逻辑，例如：
控制jsp页面某一部分内容是否执行。<c:if>
控制整个jsp页面是否执行。
控制jsp页面内容重复执行。<c:forEach>
修改jsp页面内容输出。<c:out> HTML转义
自定义标签除了可以移除jsp页面java代码外，它也可以实现以上功能。

tld文件中的四种标签体类型
EMPTY：空标记，即起始标记和结束标记之间没有内容
JSP：接受所有JSP语法，如定制的或内部的tag、scripts、静态HTML、脚本元素、JSP指令和动作
scriptless：接受文本、EL和JSP动作

tagdepentend：标签体内容直接被写入BodyContent，由自定义标签类来进行处理，而不被JSP容器解释

传统标签执行流程图

例一：控制标签体内容是否执行
doStartTag
EVAL_BODY_INCLUDE 执行标签内容
SKIP_BODY 跳过标签内容

Tld配置
<tag>
<name>demo1</name>
<tag-class>mytag.MyTag1</tag-class>
<body-content>JSP</body-content>
</tag>

例二：控制标签后的jsp页面是否执行
doEndTag
EVAL_PAGE 执行标签后的页面内容
SKIP_PAGE 跳过标签后的页面内容

Tld配置
<tag>
<name>demo2</name>
<tag-class>mytag.MyTag2</tag-class>
<body-content>empty</body-content>
</tag>

例三：控制标签体内容重复执行
doStartTag
EVAL_BODY_INCLUDE 执行标签内容
doAfterBody
EVAL_BODY_AGAIN 重复执行标签内容
SKIP_BODY 跳过标签内容

doAfterBody代码
times--;
if (times > 0) {
return EVAL_BODY_AGAIN;
} else {
return SKIP_BODY;
}

例四：修改标签体内容输出
将标签体内容大写输出
MyTag4 extends BodyTagSupport
doStartTag
EVAL_BODY_BUFFERED
doEndTag
String content = getBodyContent().getString();
pageContext.getOut().write(…);

开发带属性的标签
自定义标签可以定义一个或多个属性，这样，在JSP页面中应用自定义标签时就可以设置这些属性的值，通过这些属性为标签处理器传递参数信息，从而提高标签的灵活性和复用性。
要想让一个自定义标签具有属性，通常需要完成两个任务：
在标签处理器中编写每个属性对应的setter方法
在TLD文件中描术标签的属性
为自定义标签定义属性时，每个属性都必须按照JavaBean的属性命名方式，在标签处理器中定义属性名对应的setter方法，用来接收JSP页面调用自定义标签时传递进来的属性值。例如属性url，在标签处理器类中就要定义相应的setUrl(String url)方法。
在标签处理器中定义相应的set方法后，JSP引擎在解析执行开始标签前，也就是调用doStartTag方法前，会调用set属性方法，为标签设置属性。

tld中描述标签的属性图

WEB-INF/ExecTag.tld

<?xml version="1.0" encoding="UTF-8"?>
<taglib version="2.0" xmlns="http://java.sun.com/xml/ns/j2ee"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd">
 <tlib-version>1.0</tlib-version>
 <short-name>execTag</short-name>
 <uri>http://www.twy.com/execTag</uri>
 
 <tag>
 	<name>ref</name>
 	<tag-class>com.itheima.tag.RefererTag</tag-class>
 	<body-content>empty</body-content>
 </tag>
 <tag>
 	<name>html</name>
 	<tag-class>com.itheima.tag.HtmlTag</tag-class>
 	<body-content>scriptless</body-content>
 </tag>
 <tag>
 	<name>if</name>
 	<tag-class>com.itheima.tag.TwyIf</tag-class>
 	<body-content>JSP</body-content>
 	<attribute>
 		<name>test</name>
 		<required>true</required>
 		<rtexprvalue>true</rtexprvalue>
 		<type>boolean</type>
 	</attribute>
 </tag>
</taglib>

模拟<c:if>标签例子

TwyIf.java

package com.itheima.tag;

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

public class TwyIf extends TagSupport {
	private boolean test;
	
	public void setTest(boolean test) {
		this.test = test;
	}

	@Override
	public int doStartTag() throws JspException {
		if(test){
			return EVAL_BODY_INCLUDE;//通知jsp引擎执行标签体
		}else{
			return SKIP_BODY;//通知jsp引擎跳过标签体
		}
	}
}

twyIf.jsp

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ taglib uri="http://www.twy.com/execTag" prefix="execTag" %>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head></head>
  
  <body>
    <execTag:if test="${1==1 }">
    	1=1
    </execTag:if>
    <execTag:if test="${1!=1 }">
    	1!=1吗
    </execTag:if>
  </body>
</html>

html转义标签

HtmlTag.java

package com.itheima.tag;

import java.io.IOException;

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

public class HtmlTag extends BodyTagSupport {
	@Override
	public int doEndTag() throws JspException {
		String body = bodyContent.getString();
		body = filter(body);
		try{
			pageContext.getOut().write(body);
		}catch (IOException e) {
			e.printStackTrace();
		}
		
		return EVAL_PAGE;
	}
	
	public static String filter(String message) {

        if (message == null)
            return (null);

        char content[] = new char[message.length()];
        message.getChars(0, message.length(), content, 0);
        StringBuffer result = new StringBuffer(content.length + 50);
        for (int i = 0; i < content.length; i++) {
            switch (content[i]) {
            case '<':
                result.append("<");
                break;
            case '>':
                result.append(">");
                break;
            case '&':
                result.append("&");
                break;
            case '"':
                result.append(""");
                break;
            default:
                result.append(content[i]);
            }
        }
        return (result.toString());

    }
}

html.jsp

<%@ page language="java" import="java.util.*" pageEncoding="ISO-8859-1"%>
<%@ taglib uri="http://www.twy.com/execTag" prefix="execTag" %>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head></head>
  
  <body>
    <execTag:html><a href="xxxxx">xxxxx</a></execTag:html>
  </body>
</html>

开发防盗链标签

RefererTag.java

package com.itheima.tag;

import java.io.IOException;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.TagSupport;

public class RefererTag extends TagSupport {
	@Override
	public int doEndTag() throws JspException {
		HttpServletRequest req = (HttpServletRequest) this.pageContext.getRequest();
		HttpServletResponse resp = (HttpServletResponse) this.pageContext.getResponse();
		String referer = req.getHeader("referer");
		if(referer==null||"".equals(referer)||!referer.startsWith("http://localhost")){
			try {
				resp.sendRedirect(req.getContextPath()+"/index.jsp");
			} catch (IOException e) {
				// TODO Auto-generated catch block
				e.printStackTrace();
			}
  		}
		return EVAL_PAGE;
	}
}

referer.jsp

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ taglib uri="http://www.twy.com/execTag" prefix="execTag" %>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head></head>
  
  <body>
    <%-- <%
  		String referer = request.getHeader("referer");
  		if(referer==null||"".equals(referer)||!referer.startsWith("http://localhost")){
			response.sendRedirect(request.getContextPath()+"/index.jsp");
  		}
  	 %> --%>
  	 <execTag:ref/>
  	 凤姐回忆录
  </body>
</html>

简单标签

由于传统标签使用三个标签接口来完成不同的功能，显得过于繁琐，不利于标签技术的推广， SUN公司为降低标签技术的学习难度，在JSP 2.0中定义了一个更为简单、便于编写和调用的SimpleTag接口来实现标签的功能。实现SimpleTag接口的标签通常称为简单标签。简单标签共定义了5个方法：
setJspContext方法
setParent和getParent方法
setJspBody方法
doTag方法

setJspContext方法
用于把JSP页面的pageContext对象传递给标签处理器对象
setParent方法
用于把父标签处理器对象传递给当前标签处理器对象
getParent方法
用于获得当前标签的父标签处理器对象
setJspBody方法
用于把代表标签体的JspFragment对象传递给标签处理器对象
doTag方法
用于完成所有的标签逻辑，包括输出、迭代、修改标签体内容等。在doTag方法中可以抛出javax.servlet.jsp.SkipPageException异常，用于通知WEB容器不再执行JSP页面中位于结束标记后面的内容，这等效于在传统标签的doEndTag方法中返回Tag.SKIP_PAGE常量的情况。

SimpleTag接口方法的执行顺序
当web容器开始执行标签时，会调用如下方法完成标签的初始化
WEB容器调用标签处理器对象的setJspContext方法，将代表JSP页面的pageContext对象传递给标签处理器对象。
WEB容器调用标签处理器对象的setParent方法，将父标签处理器对象传递给这个标签处理器对象。注意，只有在标签存在父标签的情况下，WEB容器才会调用这个方法。
如果调用标签时设置了属性，容器将调用每个属性对应的setter方法把属性值传递给标签处理器对象。如果标签的属性值是EL表达式或脚本表达式，则WEB容器首先计算表达式的值，然后把值传递给标签处理器对象。
如果简单标签有标签体，容器将调用setJspBody方法把代表标签体的JspFragment对象传递进来。
执行标签时：
容器调用标签处理器的doTag()方法，开发人员在方法体内通过操作JspFragment对象，就可以实现是否执行、迭代、修改标签体的目的。

JspFragment类
javax.servlet.jsp.tagext.JspFragment类是在JSP2.0中定义的，它的实例对象代表JSP页面中的一段符合JSP语法规范的JSP片段，这段JSP片段中不能包含JSP脚本元素。

WEB容器在处理简单标签的标签体时，会把标签体内容用一个JspFragment对象表示，并调用标签处理器对象的setJspBody方法把JspFragment对象传递给标签处理器对象。JspFragment类中只定义了两个方法，如下所示：

getJspContext方法
用于返回代表调用页面的JspContext对象. ---- pageContext

public abstract void invoke(java.io.Writer out) -- 输出标签体内容
用于执行JspFragment对象所代表的JSP代码片段
参数out用于指定将JspFragment对象的执行结果写入到哪个输出流对象中，如果传递给参数out的值为null，则将执行结果写入到JspContext.getOut()方法返回的输出流对象中。(简而言之，可以理解为写给浏览器)

invoke方法详解
JspFragment.invoke方法是JspFragment最重要的方法，利用这个方法可以控制是否执行和输出标签体的内容、是否迭代执行标签体的内容或对标签体的执行结果进行修改后再输出。例如：
在标签处理器中如果没有调用JspFragment.invoke方法，其结果就相当于忽略标签体内容；
在标签处理器中重复调用JspFragment.invoke方法，则标签体内容将会被重复执行；
若想在标签处理器中修改标签体内容，只需在调用invoke方法时指定一个可取出结果数据的输出流对象（例如StringWriter），让标签体的执行结果输出到该输出流对象中，然后从该输出流对象中取出数据进行修改后再输出到目标设备，即可达到修改标签体的目的。

例子

WEB-INF/SimpleTag.tld

<?xml version="1.0" encoding="UTF-8"?>
<taglib version="2.0" xmlns="http://java.sun.com/xml/ns/j2ee"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd">
 <tlib-version>1.0</tlib-version>
 <short-name>simpleTag</short-name>
 <uri>http://www.twy.com/simpleTag</uri>
 <tag>
 	<name>test</name>
 	<tag-class>com.itheima.tag.SimpleTag</tag-class>
 	<body-content>scriptless</body-content>
 </tag>
</taglib>

SimpleTag.java

package com.itheima.tag;

import java.io.IOException;
import java.io.StringWriter;

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

public class SimpleTag extends SimpleTagSupport {
	@Override
	public void doTag() throws JspException, IOException {
		//控制jsp页面某一部分内容是否执行。
		//1.1控制标签体不输出，什么都不做标签体就不输出
		//1.2控制标签体输出
		//JspFragment fragment = this.getJspBody();
		//fragment.invoke(getJspContext().getOut());
		//fragment.invoke(null);
		
		//控制整个jsp页面是否执行。
		//2.1控制标签之后的页面执行：什么都不做，标签之后的内容就执行
		//2.2控制标签之后的页面不执行：抛出一个SkipPageException
		//throw new SkipPageException();
		
		//控制jsp页面内容重复执行。
//		for(int i = 0;i<5;i++)
//			this.getJspBody().invoke(null);
		
		//修改jsp页面内容输出。
		StringWriter writer = new StringWriter();
		JspFragment fragment = this.getJspBody();
		fragment.invoke(writer);
		String body = writer.toString();
		body = body.toUpperCase();
		this.getJspContext().getOut().write(body);

		//super.doTag();
	}
}

SimpleDemo.jsp

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ taglib uri="http://www.twy.com/simpleTag" prefix="simpleTag" %>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head></head>
  
  <body>
  之前内容
    <simpleTag:test>a-</simpleTag:test>
    之后内容
  </body>
</html>

打包标签库类似jstl
1.创建一个java project工程
2.把要打包的类文件复制进来

3.导入javae依赖包

4.创建META-INF文件且把tld配置文件复制进来

5.导出生成jar包

涂文远

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
自定义标签开发

自定义标签开发1.自定义标签主要用于移除Jsp页面中的java代码2.使用自定义标签移除jsp页面中的java代码，只需要完成以下两个步骤：编写一个实现Tag接口的Java类(标签处理器类)编写标签库描述符（tld）文件，在tld文件中对标签处理器类描述成一个标签Tag接口的执行流程JSP引擎将遇到自定义标签时，首先创建标签处理器类的实例对象，然后按照JSP规范定义
复制链接

扫一扫

专栏目录