一.自定义标签的基本编写
下面编写一个自定义标签,它可以输出当前的时间.
1.编写标签类
类可以通过继承SimpleTagSupport类实现一个标签类编写.父类为我们提供了一些编写自定义标签的快捷的成员变量.而在服务器解析到自定义标签的时候,会去寻找标签类的doTag方法(这个方法在父类中有定义),并且将这些成员变量赋值.在开发中,用的最多的成员变量有2个,代表页面上下文的JspContext和代表标签内的内容的JspFragement.JSPContext对象实际上就是一个PageContext对象,它可以获得其他jsp的八大隐式对象,和存放数据.而JspFragement对象则提供了一些快捷操作标签内部内容的方法.两个对象分别通过getJspContext和getJspBody方法获得.下面给出了输出当前时间的标签类的编写:
public class PrintTag extends SimpleTagSupport{ @Override
public void doTag() throws JspException, IOException {
Date date=new Date();
SimpleDateFormat sdf=new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
PageContext pageContext = (PageContext) getJspContext();
pageContext.getOut().write(sdf.format(date));
} }
可以通过pagecontext对象获得jsp内置对象out来输出数据.doTag方法,在jsp引擎解析到标签的时候调用.
2.创建一个配置文件,配置标签的相关属性.
1>在WEB-INF目录下建立一个后缀名为.tld的配置文件.在配置文件中引入下列模板:
<?xml version="1.0" encoding="UTF-8"?>
<taglib 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"
version="2.0">
<tlib-version>1.0</tlib-version>
<short-name>itheima</short-name>
<!--声明在taglib上的命名空间-->
<uri>http://www.xyy.com/tags</uri> </taglib>
2>在<tag>里声明标签的属性.
<tag>
<!-- 标签名.在前缀:后面添加的字符串 -->
<name>print</name>
<!-- 实现该标签的类 -->
<tag-class>com.xyy.tag.PrintTag</tag-class>
<!-- body-content没有标签的主体内容,用empty -->
<body-content>empty</body-content>
</tag>
<body-content>取值:
empty:没有主体内容。简单和传统标签都能用。
scriptless:给简单标签用的,说明主体内容是非脚本。(不能使用<%=%>这样的,但是EL表达式可以被正常解析)
tagdependent:把主体内容的EL表达式当做普通字符串对待。
3.在jsp页面用taglib引入,并且在页面中使用标签.
二.自定义标签的执行流程
执行流程如下图(需要注意的是标签处理类是线程安全的,每次访问带有标签的页面,标签处理类都会实例化.)
三.采用自定义标签模拟foreach标签.
1.首先在页面中将需要模拟的标签的基本形式编写好,页面如下:
<%@page import="java.util.*"%>
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<%@ taglib uri="http://www.yunyun.com/demo" prefix="demo"%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
<!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>
<%
List<String> list=new ArrayList<String>();
list.add( "hlhdidi");
list.add("23岁");
list.add("7000");
%>
<%
Map<String,String> map=new HashMap<String,String>();
map.put("name", "hlhdidi");
map.put("age", "23岁");
map.put("salary", "7000元");
pageContext.setAttribute("map", map);
%>
<c:set value="<%=list %>" var="list" scope="request"></c:set>
<demo:foreach items="${list }" var="item" varstatus="vs">
${vs.count }---${item }
</demo:foreach>
<demo:foreach items="${map }" var="en" varstatus="vs">
${vs.count }---${en.key }:${en.value }
</demo:foreach>
</body>
</html>
可以看出,标签中需要传递三个参数.分别是items,var,以及varstatus.如果需要传递参数到标签类中,只需要在标签类中声明对应的成员变量即可.jsp引擎在发现这些参数的时候,将会自动寻找标签类的相应属性并且进行赋值.可以看出items必须是Object类型,而var和varstatus由于仅仅是传入PageContext域中的值的标识,所以采用字符串类型.
2.声明标签类.
for each标签需要将每一个遍历到的当前对象传入pageContext域中,同时将状态信息传入pageContext域中,因此建立Status类描述状态信息,为了简便,status类只定义了一个成员变量count,记录当前的循环次数.
public class Status implements Serializable{
private int count; public int getCount() {
return count;
} public void setCount(int count) {
this.count = count;
} }
由于items是Object的数据类型,因此需要对其进行类型判断,在标签类的内部采用Collection的引用进行接收标签的items传入的对象.随后在doTag方法中,将遍历的对象放入PageContext域中,随后执行展示的操作.这里采用getJspBody.invoke(null)方法.这个方法将会进行默认的标签内容展示.具体的标签类如下:
public class SimpleForEachTag extends SimpleTagSupport{ private String var;
private String varstatus;
private Object items;
/*用Collection的引用是因为,需要在将items传入的时候,实行强制转换.
如果用List或者Set来接收,那么当只能强转为List/Set.
因为,将一个类型的对象强制转化为一个不匹配的引用会报错,所以只能用Collecion来接收*/
private Collection list=new ArrayList(); public void setVar(String var) {
this.var = var;
} public void setVarstatus(String varstatus) {
this.varstatus = varstatus;
}
//为了方便遍历,进行强制类型转换
public void setItems(Object items) {
//在这里会将items传入
if(items instanceof List) {
list=(List)items;
}
else if(items instanceof Set) {
list=(Set)items;
}
else if(items instanceof Map) {
list=((Map)items).entrySet();
}
else if(items instanceof Object[]) {
list=Arrays.asList((Object[])items);
}
} @Override
public void doTag() throws JspException, IOException {
PageContext pageContext = (PageContext) getJspContext();
Status status=new Status();
int i=0;//循环次数
if(list!=null) {
for(Object obj:list) {
//放入pageContext域中
pageContext.setAttribute(var, obj);
status.setCount(++i);
pageContext.setAttribute(varstatus, status);
getJspBody().invoke(null); //默认的输出
}
} } }
3.配置标签.
配置如下:
<tag>
<name>foreach</name>
<tag-class>com.xyy.tag.SimpleForEachTag</tag-class>
<body-content>scriptless</body-content>
<!-- 设置属性的值 -->
<attribute>
<!-- 属性名 -->
<name>items</name>
<!-- 属性是否必须 -->
<required>true</required>
<!--
属性是否支持Java表达式/EL表达式.true为支持,false不支持
如果不支持的时候在设置属性时,如果写了EL表达式.会抛出异常
-->
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>var</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>varstatus</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
四.总结
自定义标签是一个很有用的功能,可以通过最基本的自定义标签的学习,在jsp页面中完成我们想要的功能展示.