JSP自定义标签开发入门

一般情况下开发jsp自定义标签需要引用以下两个包

import javax.servlet.jsp.*;

import javax.servlet.jsp.tagext.*;

首先我们需要大致了解开发自定义标签所涉及到的接口与类的层次结构(其中SimpleTag接口与SimpleTagSupport类是JSP2.0中新引入的)。

目标1:自定义一个用表格显示用户信息的简单标签

效果图:

在jsp页面使用此自定义标签:

假设我们有一个UserInfo的javabean,那么在JSP页面使用此标签只需调用此标签即可

<!-- 创建需要展现UserInfo的实例(用于测试数据) -->

<%

UserInfo user = new UserInfo();

user.setUserName("Xuwei");

user.setAge(33);

user.setEmail("test@test.test");

pageContext.setAttribute("userinfo", user);

%>

<!-- 给标签设置user属性绑定要展现的UserInfo对象  -->

<cc:showUserInfo user="${pageScope.userinfo }" />

开发步骤:

简单标签的开发我们只要实现Tag接口即可,为了简单起见可以直接继承实现了此接口的TagSupport类

1 创建自定义标签类

public class UserInfoTag extends TagSupport {

private UserInfo user;

@Override

public int doStartTag() throws JspException {

try {

JspWriter out = this.pageContext.getOut();

if(user == null) {

out.println("No UserInfo Found...");

return SKIP_BODY;

}

out.println("<table width='500px' border='1' align='center'>");

out.println("<tr>");

out.println("<td width='20%'>Username:</td>");

out.println("<td>" + user.getUserName() + "</td>");

out.println("</tr>");

out.println("<tr>");

out.println("<td>Age:</td>");

out.println("<td>" + user.getAge() + "</td>");

out.println("</tr>");

out.println("<tr>");

out.println("<td>Email:</td>");

out.println("<td>" + user.getEmail() + "</td>");

out.println("</tr>");

out.println("</table>");

} catch(Exception e) {

throw new JspException(e.getMessage());

}

return SKIP_BODY;

}

@Override

public int doEndTag() throws JspException {

return EVAL_PAGE;

}

@Override

public void release() {

super.release();

this.user = null;

}

//getter and setters

public UserInfo getUser() {

return user;

}

public void setUser(UserInfo user) {

this.user = user;

}

}

2 在Web-Inf创建标签库描述文件.tdl(Tag Library Description)

<?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 web-jsptaglibrary_2_0.xsd">

<tlib-version>1.0</tlib-version>

<jsp-version>2.0</jsp-version>

<short-name>cc</short-name>

<uri>/mytaglib</uri>

<tag>

<name>showUserInfo</name>

<tag-class>com.mytags.UserInfoTag</tag-class>

<body-content>empty</body-content>

<attribute>

<name>user</name>

<required>false</required>

<rtexprvalue>true</rtexprvalue>

</attribute>

</tag>

</taglib>

3 配置web.xml

<jsp-config>

<taglib>

<taglib-uri>/mytaglib</taglib-uri>

<taglib-location>/WEB-INF/mytaglib.tld</taglib-location>

</taglib>

</jsp-config>

4 在需要使用此标签的jsp页面头部引入

<%@ taglib uri="/mytaglib" prefix="cc"%>

5 使用(参照上面的使用步骤)

此致,一个简单的JSP标签开发完成

标签类说明:

我们创建的UserInfoTag类继承了TagSupport类,而它又实现了Tag接口,Tag接口的生命周期由其所在的容器控制,如下图:

setPageContext() 将所在jsp页面的pageContext注入进来,目的是为了在后面的方法中可以访问到jsp页面对象的pageContext属性

setParent()       设置此标签的父标签

setAttribute()   将标签中的属性注入到此class的属性,不需要自己实现但要提供属性的get与set方法

doStartTag()      在开始标签属性设置后调用,如果返回SKIP_BODY则忽略标签之中的内容,如果返回EVAL_BODY_INCLUDE则将标签体的内容进行输出

doEndTag()         在结束标签之前调用,返回SKIP_PAGE跳过整个jsp页面后面的输出,返回EVAL_PAGE执行页面余下部分

release()          生命周期结束时调用

特别说明:在tomcat4.1之后的版本中默认开启了标签缓冲池 (websphere和weblogic并不会这么做),所以执行完标签后并不会执行release()方法(_jspDestroy()时才释放),也 就是说同一个jsp页面自定义标签不管使用多少次只会存在一个实例,但也并不是每一个标签都会为其创建一个缓冲池,要根据参数来判断,例如:

<cc:UserInfoTag user=”…” />

<cc:UserInfoTag />

上面例子中由于参数不同就会创建两个标签缓冲池。

这个问题可以通过设定tomcat的配置文件加以解决:
在%tomcat%\conf\web.xml加入enablePooling参数,并设置为false(不缓存自定义标签)。

<init-param>
  <param-name>enablePooling</param-name>
  <param-value>false</param-value>
</init-param>

清空%tomcat%\conf\目录

-------------------------------------------------------------------------------------------------------------------------------

TagSupport类已经为我们实现并扩展了一些方法(比如在上述方法中我们可以直接使用pageContext对象,调用父标签getParent()等),所以一般情况下我们只需重写doStartTag(),doEndTag() 即可

TLD文件说明:

<!--版本号-->

<tlib-version>1.0</tlib-version>

<jsp-version>2.0</jsp-version>

<short-name>cc</short-name>

<tag>

<!—指定标签名 -->

<name>showUserInfo</name>

<!—指定标签类文件的全路径 -->

<tag-class>com.mytags.UserInfoTag</tag-class>

<!--如果不需要标签体则设置empty,反之设定jsp -->

<body-content>empty</body-content>

<!—设定属性(如果有的话) -->

<attribute>

<!—指定标签名 -->

<name>user</name>

<!—是否是必须,如果非必须没设置则为空 -->

<required>false</required>

<rtexprvalue>true</rtexprvalue><!—是否可在属性中使用表达式 -->

</attribute>

</tag>

Web.xml文件说明:

<jsp-config>

<taglib>

<!--

标签库的uri路径

即jsp头文件中声明<%@ taglib uri="/mytaglib" prefix="cc"%>

的uri

-->

<taglib-uri>/mytaglib</taglib-uri>

<!—tld文件所在的位置-->

<taglib-location>/WEB-INF/mytaglib.tld</taglib-location>

</taglib>

</jsp-config>

目标2:自定义一个类似于Asp.Net中的Reapter控件的标签

效果图:

在jsp页面使用此自定义标签:

<!-- 创建需要展现javabean(UserInfo)集合的实例(用于测试数据) -->

<%

List<UserInfo> users = new ArrayList<UserInfo>();

users.add(new UserInfo("Zhangsan", 12, "Zhangsan@163.com"));

users.add(new UserInfo("Lisi", 22, "Lisi@sina.com"));

users.add(new UserInfo("Wangwu", 33, "Wangwu@qq.com"));

pageContext.setAttribute("users", users);

%>

<!-- 给标签绑定数据源  -->

<table width='500px' border='1' align='center'>

<tr>

<td width='20%'>UserName</td>

<td width='20%'>Age</td>

<td>Email</td>

</tr>

<cc:repeater var="item" items="${pageScope.users }">

<tr>

<td>${item.userName }</td>

<td>${item.age }</td>

<td>${item.email }</td>

</tr>

</cc:repeater>

</table>

开发步骤:

要完成此控件我们需要实现一个迭代接口,即IterationTag,由于TagSupport同样实现了此接口,所以我们继承此类

1 创建自定义标签类

public class Repeater extends TagSupport {

private Collection items;

private Iterator it;

private String var;

@Override

public int doStartTag() throws JspException {

if(items == null || items.size() == 0) return SKIP_BODY;

it = items.iterator();

        if(it.hasNext()) {

pageContext.setAttribute(var, it.next());

}

return EVAL_BODY_INCLUDE;

}

@Override

public int doAfterBody() throws JspException {

if(it.hasNext()) {

pageContext.setAttribute(var, it.next());

return EVAL_BODY_AGAIN;

}

return SKIP_BODY;

}

@Override

public int doEndTag() throws JspException {

return EVAL_PAGE;

}

public void setItems(Collection items) {

this.items = items;

}

public void setVar(String var) {

this.var = var;

}

}

2在Web-Inf创建标签库描述文件.tdl(Tag Library Description)

由于目标1种已经创建了此文件,我们只需增加此标签的配置即可

<tag>

<name>repeater</name>

<tag-class>com.mytags.Repeater</tag-class>

<body-content>jsp</body-content>

<attribute>

<name>items</name>

<required>false</required>

<rtexprvalue>true</rtexprvalue>

</attribute>

<attribute>

<name>var</name>

<required>true</required>

<rtexprvalue>true</rtexprvalue>

</attribute>

</tag>

3 配置web.xml (目标1中已完成,无需修改)

4 在需要使用此标签的jsp页面头部引入

<%@ taglib uri="/mytaglib" prefix="cc"%>

5 使用(参照上面的使用步骤)

标签类说明:

我们用到了迭代接口,以下是容器处理此接口的流程

作为目标1中的补充: 在doAfterBody()如果返回值是EVAL_BODY_AGAIN那么将重新执行此方法

目标3:使用BodyTagSupport

此目标并不会使用实际例子进行显示,主要是说明为什么,什么情况下需要使用到BodyTag接口或者BodyTagSupport类?

如果我们需要在<test>  ….  
</test>之间的标签体的头部和尾部加上一些标记或者是其他处理,一般的处理方法是在doStartTag和doEndTag方法中进
行, 但是如果是个迭代标签,标签体的每段内容在循环输出时每次都需要在头部和尾部加上一些标记,我们使用BodyTagSupport就很方便了,

此接口在doStartTag()方法返回值多了一个EVAL_BODY_BUFFERED,它将对主体进行计算,并输出到缓冲区(注:此处是缓冲
区并非直接输出到客户端,需要我们手动
(this.bodyContent.getEnclosingWriter().write(this.bodyContent.getString());)
进行输出客户端的调用,否则主体内容不会进行显示)

标签类说明:

关于BodyTagSupport接口的说明

目标4:自定义的函数库

1 创建函数库类

public class MyFunctions {

public static String formatMyName(String name) {

return "your name is " + name;

}

public static int add(int a, int b) {

return a+b;

}

}

2 在TLD文件中配置 (引用于目标1中的tld文件)

<function>

<name>formatMyName</name>

<function-class>com.taglib.MyFunctions</function-class>

<function-signature>java.lang.String formatMyName(java.lang.String)</function-signature>

</function>

<function>

<name>add</name>

<function-class>com.taglib.MyFunctions</function-class>

<function-signature>java.lang.String add(int, int)</function-signature>

</function>

3 JSP中调用

${cc:formatMyName("wangfei") }

${cc:add(12, 34) }

JSP自定义标签开发入门《转》的更多相关文章

  1. JSP自定义标签开发入门

    一般情况下开发jsp自定义标签需要引用以下两个包 import javax.servlet.jsp.*; import javax.servlet.jsp.tagext.*; 首先我们需要大致了解开发 ...

  2. javaweb学习总结(二十三)——jsp自定义标签开发入门

    一.自定义标签的作用 自定义标签主要用于移除Jsp页面中的java代码. 二.自定义标签开发和使用 2.1.自定义标签开发步骤 1.编写一个实现Tag接口的Java类(标签处理器类) 1 packag ...

  3. javaweb(二十三)——jsp自定义标签开发入门

    一.自定义标签的作用 自定义标签主要用于移除Jsp页面中的java代码. 二.自定义标签开发和使用 2.1.自定义标签开发步骤 1.编写一个实现Tag接口的Java类(标签处理器类) 1 packag ...

  4. 【JSP】自定义标签开发入门

    JSP 自定义标签 自定义标签是用户定义的JSP语言元素.当JSP页面包含一个自定义标签时将被转化为servlet,标签转化为对被 称为tag handler的对象的操作,即当servlet执行时We ...

  5. JSP自定义标签开发步骤

    自定义的标签库一.基本概念: 1.标签(Tag): 标签,通常也成为动作,是一组按照XML语法格式编写的代码片段,在JSP中,用来封装在页面中可重复利用的逻辑,通过标签可以使JSP网页变得简洁并且易于 ...

  6. jsp自定义标签开发

    参考:http://blog.csdn.net/lw001x/article/details/7589302

  7. 【转】Jsp自定义标签详解

    一.前言 原本是打算研究EXtremeComponents这个jsp标签插件,因为这个是自定义的标签,且自身对jsp的自定义标签并不是非常熟悉,所以就打算继续进行扫盲,开始学习并且整理Jsp自定义标签 ...

  8. 深入分析JavaWeb Item23 -- jsp自己定义标签开发入门

    一.自己定义标签的作用 自己定义标签主要用于移除Jsp页面中的java代码. 二.自己定义标签开发和使用 2.1.自己定义标签开发步骤 1.编写一个实现Tag接口的Java类(标签处理器类) 要编写一 ...

  9. JSP 自定义标签

    0 标签技术的API继承体系 1 作用 jsp自定义标签用于移除页面中的java代码 2 实现 2.1 标签处理类ViewIPTag.java package com.zsm.util; import ...

随机推荐

  1. u-boot中网口处理--软件部分

    u-boot中DM9000驱动分析 1. CSRs和PHY reg读写. static u16 phy_read(int reg) { u16 val; /* Fill the phyxcer reg ...

  2. win7/win8下手工搭建WAMP环境

    win7/win8下手工搭建WAMP环境. 最近学习wamp,看了好多教程,出来好多问题,终于成功搞定,这里集合了一下最好的教程,写了一些自己的经验,希望大家有用 这里不能上传图片,我就写了个带pdf ...

  3. 手工配置oracle数据库

    手工配置Oracle 10G Enterprise Manager今天安装oracle,反复装了几遍都报下面错误:试了几种方法都不行:由于以下错误,Enterprise Manager配置失败启动Da ...

  4. javac编译成功,用java运行class文件出现“找不到或无法加载主类” 的问题

    1.pack后为包名,包与系统文件夹一一对应.并且代码中的包名不包含文件包的名字,即文件名 2.javac 按照*.java 文件的所在路径进行编译,编译完成后,使用java +完整包名(包含文件包名 ...

  5. 7 款基于 JavaScript/AJAX 的文件上传插件

    本文整理了7款基于JavaScript和AJAX的文件上传插件,这些插件基本上都能实现以下功能: 多文件上传 拖拽操作 实时上传进度 自定义上传限制 希望能为你的开发工作带来帮助. 1.  jQuer ...

  6. e595. Drawing an Image

    See also e575 The Quintessential Drawing Program and e594 Reading an Image or Icon from a File. publ ...

  7. 质量管理是SQA(软件质量保证)人员的职责

    质量管理是SQA(软件质量保证)人员的职责

  8. 【转载】WebApi 接口测试工具:WebApiTestClient

    正文 前言:这两天在整WebApi的服务,由于调用方是Android客户端,Android开发人员也不懂C#语法,API里面的接口也不能直接给他们看,没办法,只有整个详细一点的文档呗.由于接口个数有点 ...

  9. [mysql] 查询前几条记录

    From: http://www.cnblogs.com/xuxm2007/archive/2010/11/16/1878211.html SELECT   *   FROM   table   LI ...

  10. 解决 openpyxl 垂直分页符和水平分页符同时添加的问题

    前言 十天前知乎上有人提问 python:openpyxl模块怎么给表格添加分页符?实现分页打印功能?,看到问题之后,我很快的给他了一个如何添加垂直分页符或水平分页符的示例,你以为问题就结束了?我是这 ...