J2EE中的标签库给了我们很大的便利,它属于J2ee中的组件,标签库一般是结合EL表达式使用,今天我自己定义了一个标签库,自然是参考里面的<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>来写的,通过导入的.jar包里看结构可以看出:
标签库就是java类和这些比如“c.tld”构成的,
可以看出它其实就是XML文件,仔细看,发现我们用的<c:forEach
就是在这里面的tag定义的,相应的类也在相应的java包里。
就是说,我们自己定义的可以支持tag的类要继承其中的类
下面自己自定义一个简单的HelloTag:
首先肯定要自己先定义一个.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">
<description>yc standard library</description><!-- 描述-->
<display-name>yc tag lib</display-name><!-- 名字-->
<tlib-version>1.0</tlib-version><!-- 版本-->
<short-name>yc</short-name><!-- 库名,类似<c:>我们调用时候就是 <yc:>-->
<uri>http://www.hyycinfo.com/taglib/yc</uri><!-- 就是调用标签库时的那个uri-->
<tag><!-- 一个标签声明-->
<name>hello</name><!-- 标签名-->
<tag-class>com.yc.web.taglibs.HelloTag</tag-class><!-- 对应的实体类-->
<body-content>empty</body-content><!-- 标签体中是否支持 :JSP,El等,这里写空表示标签体里无内容-->
</tag>
下面是对应的实体类:
import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.TagSupport;
public class HelloTag extends TagSupport {
/**
*
*/
private static final long serialVersionUID = -5083413030988958186L;
@Override
public int doStartTag() throws JspException {
PrintWriter out=null;
try {
out=super.pageContext.getResponse().getWriter();
} catch (IOException e) {
e.printStackTrace();
}
out.print("Hello");
out.flush();
return super.SKIP_BODY;
}
}
当然系统类文件.tld放在文件夹WEB-INF下面的;
测试代码:
<%@ page language="java" import="java.util.*" pageEncoding="utf-8" isELIgnored="false"%>
<%@ taglib prefix="yc" uri="http://www.hyycinfo.com/taglib/yc" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%
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>
<yc:hello/>
</body>
就可以看到输出的Hello了。
当然这是一个很简单的案例,一般标签下面会设置属性:比如<c:forEach items="" var="">
这也是在.tld文件里定义的.
很重要的就是标签的执行顺序的返回值,这里给出关系图:
给出自定义的forEach标签的源码分析:
package com.yc.web.taglibs;
import java.util.Collection;
import java.util.Iterator;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.TagSupport;
public class ForEachTag extends TagSupport {
private Collection items;
private String var;
private Iterator its;
@Override
public int doStartTag() throws JspException {
if(items.size()<0||items==null){
return super.SKIP_BODY; //表示不执行标签体
}
its=items.iterator();
if(its.hasNext()){
Object obj=its.next();
super.pageContext.setAttribute(var,obj);
}
return super.EVAL_BODY_INCLUDE; //表示需要执行标签体
}
//这个方法是执行标签体时必须写的方法
@Override
public int doAfterBody() throws JspException {
//判断是否还有下一个
if(its.hasNext()){
Object obj=its.next();
super.pageContext.setAttribute(var,obj);
return super.EVAL_BODY_AGAIN;
}
return super.SKIP_BODY;
}
@Override
public int doEndTag() throws JspException {
return super.EVAL_PAGE;
}
public void setItems(Collection items) {
this.items = items;
}
public void setVar(String var) {
this.var = var;
}
}
可知执行完doStartTag方法后还需要执行标签体里的代码,所以返回EVAL_BODY_INCLUDE;原理就是酱紫。