JSP自定义标签库

今天闲来无事,于是想起自己之前一直使用的标签,无论是jstl,struts标签还是springmvc标签,使用起来都觉得很方便,于是自己想尝试定义自己的标签。

下面把今天自己的成果给大家分享下。要自定义标签并使用标签,需要以下几步:

1、定义自己的标签解析类,一般都是继承TagSupport类(servlet-api.jar),Override该类的doStartTag()或者doEndTag()方法;

2、定义.tld文件;

3、在web.xml中声明要使用的标签(也可以不声明);

4、在jsp中使用自定义的标签。

下面通过一个例子来给大家详细的讲解:

1、定义自己的第一个标签解析类:

package com.jrj.tag.example;
import java.io.IOException;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.TagSupport;
@SuppressWarnings("serial")
public class FirstTag extends TagSupport{
@Override
public int doEndTag() throws JspException {
try {
pageContext.getOut().write("hello world");
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return EVAL_PAGE;
}
}

2、在web-inf下新建一个tagFile文件夹,然后在文件中新建一个example.tld,内容如下:

<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE taglib
  PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
  "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
<taglib>
<tlib-version>1.0</tlib-version>
<jsp-version>1.2</jsp-version>
<short-name>em</short-name>
<uri>http://com.jrj.tag/em</uri>
<display-name>Example</display-name>
  <description>em 1.0 library</description>
<tag>
<name>out</name>
<tag-class>com.jrj.tag.example.FirstTag</tag-class>
<body-content>JSP</body-content>
<description>writer out the cotentes</description>
</tag>
</taglib>

3、如果你想在web.xml文件中添加标签的声明,在web.xml中添加如下一段代码:

<jsp-config>
    <taglib>
    <taglib-uri>/em</taglib-uri>
    <taglib-location>/WEB-INF/tagFile/example.tld</taglib-location>
    </taglib>
</jsp-config>

note:在今天讲解的这些事例中,我没有在web.xml中添加以上代码,如果添加了那么在后面jsp的引用标签时会有所不同,希望大家注意!

4、在jsp中使用标签,在使用之前需要先引用标签:

<%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8" %>
<%@ taglib uri="http://com.jrj.tag/em" prefix="em" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
</head>
<body>
<em:out></em:out>
</body>
</html>

下面我给大家扩展两个其他的例子,一个是关于条件表达式,一个是关于迭代以及标签的嵌套:

1、关于条件表达式,按照上面给大家讲解的步骤:

1)、

package com.jrj.tag.example;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.TagSupport;
@SuppressWarnings("serial")
public class IfTag extends TagSupport{
private boolean condition;
@Override
public int doStartTag() throws JspException {
return condition?EVAL_BODY_INCLUDE:SKIP_BODY;
}
public boolean isCondition() {
return condition;
}
public void setCondition(boolean condition) {
this.condition = condition;
}
}

2)、在example.tld中添加如下内容:

<tag>
<name>if</name>
<tag-class>com.jrj.tag.example.IfTag</tag-class>
<body-content>JSP</body-content>
<description>If Condition</description>
<attribute>
<name>condition</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
<type>boolean</type>
<description>condition</description>
</attribute>
</tag>

3)、jsp中使用,jsp修改完后变成如下:

<%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8" %>
<%@ taglib uri="http://com.jrj.tag/em" prefix="em" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
</head>
<body>
<em:out></em:out>
<em:if condition="${1==1}">
if is validate
</em:if>
</body>
</html>

2、关于迭代及标签的嵌套

1)、标签解析类

package com.jrj.tag.example;
import java.util.Collection;
import java.util.Iterator;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;
@SuppressWarnings("serial")
public class ForEachTag extends BodyTagSupport {
@SuppressWarnings("rawtypes")
private Collection items;
private String var;
@SuppressWarnings("rawtypes")
private Iterator it;
@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;
}
@SuppressWarnings("rawtypes")
public Collection getItems() {
return items;
}
@SuppressWarnings("rawtypes")
public void setItems(Collection items) {
this.items = items;
}
public String getVar() {
return var;
}
public void setVar(String var) {
this.var = var;
}
}

2)、在example.tld中添加如下内容:

<tag>
<name>foreach</name>
<tag-class>com.jrj.tag.example.ForEachTag</tag-class>
<body-content>JSP</body-content>
<description>ForEach The Collection</description>
<attribute>
<name>var</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>items</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>

3)、jsp中使用,jsp内容如下:

<%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8" %>
<%@ taglib uri="http://com.jrj.tag/em" prefix="em" %>
<%@ page import="java.util.*" %>
<%
String path = request.getContextPath();
ArrayList<String> values = new ArrayList<String>();
values.add("zhouming");
values.add("xiaoshou");
values.add("minggou");
pageContext.setAttribute("values", values);
%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
</head>
<body>
<em:out></em:out>
<em:if condition="${1==1}">
if is validate
</em:if>
<em:foreach items="${pageScope.values}" var="val">
<em:out></em:out>
${val}
</em:foreach>
</body>
</html>

下面大家可能会对两个方面有疑问:一是java类中每个方法的返回值的含义,二是tld文件中一些元素代表的意思。

1、在我们创建自定义的标签时,在复写父类的方法是,需要注意返回值的含义,不同的返回值代表不同的处理,下面是不同返回值所代表的含义:

EVAL_BODY_INCLUDE:把Body读入存在的输出流中,doStartTag()函数可用

EVAL_PAGE:继续处理页面,doEndTag()函数可用

SKIP_BODY:忽略对Body的处理,doStartTag()和doAfterBody()函数可用

SKIP_PAGE:忽略对余下页面的处理,doEndTag()函数可用

EVAL_BODY_TAG:已经废止,由EVAL_BODY_BUFFERED取代

EVAL_BODY_BUFFERED:申请缓冲区,

由setBodyContent()函数得到的BodyContent对象来处理tag的body,

如果类实现了BodyTag,那么doStartTag()可用,否则非法

2、如果我们需要对body里面的内容进行循环处理,我们自定义的标签解析类需要实现BodyTag接口或者继承BodyTagSupport类

3、在我们自定义的tld文件中,需要注意attribute元素下的rtexprvalue(Run-time Expression value)元素的值,如果该值为true,表示该属性的值可以通过直接指定或者

通过表达式来指定,如果该值为false,则表示该属性的值必须直接指定。

以上就是自定义标签的基本步骤,我今天在做的过程中借鉴了jstl的实现过程以及上网找了一些资料。我觉得这种方式效率很高,如果大家还有什么更加高效的方法,

可以分享出来,大家一起进步!我们下期再见!

JSP自定义标签库

时间: 2024-10-06 15:45:36

JSP自定义标签库的相关文章

JSP自定义标签的使用简化版

在jsp中 如果不想页面中出现java代码 这个时候就需要使用到jsp的自定义标签库技术了 自定义标签库 能够有效的减少jsp中java代码的出现 使其更加自然的像html页面一样 如果要使用jsp自定义标签库技术顺着下列步骤做个demo就能理解个大概 首先在项目下WEB-INF下创建一个tld文件 用于说明这个自定义标签库 然后打开自己曾经导入过的jar包,并且保证该包在现行环境下能够使用 找到包中的WEB-INF文件可以看到一个c.tld文件 打开此文件 可以看到列如 <?xml versi

jsp的标签库和自定义标签

1.jstl标签库 JSP标准标签库(JSTL)是一个JSP标签集合,它封装了JSP应用的通用核心功能. JSTL支持通用的.结构化的任务,比如迭代,条件判断,XML文档操作,国际化标签,SQL标签. 除了这些,它还提供了一个框架来使用集成JSTL的自定义标签. 根据JSTL标签所提供的功能,可以将其分为5个类别. 核心标签 格式化标签 SQL 标签(过时) XML 标签(过时) JSTL 函数 1.1使用taglib指令导入标签库 ,除了JSP动作标签外,使用其他第三方的标签库都需要:  <%

java jsp自定义标签

自定义标签开发步骤 1)编写一个普通的java类,继承SimpleTagSupport类,叫标签处理器类 package gz.itcast; import java.io.IOException; import javax.servlet.jsp.JspException; import javax.servlet.jsp.tagext.SimpleTagSupport; public class iftag extends SimpleTagSupport { private boolean

JSP自定义标签开发入门《转》

JSP自定义标签开发入门 一般情况下开发jsp自定义标签需要引用以下两个包 import javax.servlet.jsp.*; import javax.servlet.jsp.tagext.*; 首先我们需要大致了解开发自定义标签所涉及到的接口与类的层次结构(其中SimpleTag接口与SimpleTagSupport类是JSP2.0中新引入的). 目标1:自定义一个用表格显示用户信息的简单标签 效果图: 在jsp页面使用此自定义标签: 假设我们有一个UserInfo的javabean,那

自定义标签库开发与el表达式

1.自定义标签库的开发自定义标签库主要用于移除jsp页面中的java 代码. 步骤一:编写一个实现Tag接口的类(建议继承TagSupport),把java代码一直到这个类中. package cn.soldier.tag; import java.io.IOException; import javax.servlet.jsp.JspException;import javax.servlet.jsp.tagext.TagSupport; public class viewIP extends

Java jsp 自定义标签

1 自定义标签 1.1 引入 需求: 向浏览器输出当前客户的IP地址 (只能使用jsp标签) 1.2 第一个自定义标签开发步骤 1)编写一个普通的java类,继承SimpleTagSupport类,叫标签处理器类 /** * 标签处理器类 * @author APPle * 1)继承SimpleTagSupport * */ public class ShowIpTag extends SimpleTagSupport{ private JspContext context; /** * 传入p

一个简单的jsp自定义标签

学到了一个简单的jsp自定义标签,后面有更多的例子,会更新出来: 例子1: 步骤: 1.编写标签实现类: 继承javax.servlet.jsp.tagext.SimpleTagSupport; 重写doTag,实现在网页上输出: 2.在web-inf目录或其子目录下,建立helloword.tld文件,即自定义标签的说明文件 注意:标签处理类必须放在包中,不能是裸体类:不需要修改web.xml: //tld: tag lib description 标签库描述 java代码: package

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

一.自定义标签的作用 自定义标签主要用于移除Jsp页面中的java代码. 二.自定义标签开发和使用 2.1.自定义标签开发步骤 1.编写一个实现Tag接口的Java类(标签处理器类) 1 package me.gacl.web.tag; 2 3 import java.io.IOException; 4 5 import javax.servlet.http.HttpServletRequest; 6 import javax.servlet.jsp.JspException; 7 import

JSP自定义标签开发入门

一般情况下开发jsp自定义标签需要引用以下两个包 import javax.servlet.jsp.*; import javax.servlet.jsp.tagext.*; 首先我们需要大致了解开发自定义标签所涉及到的接口与类的层次结构(其中SimpleTag接口与SimpleTagSupport类是JSP2.0中新引入的). 目标1:自定义一个用表格显示用户信息的简单标签 效果图: 在jsp页面使用此自定义标签: 假设我们有一个UserInfo的javabean,那么在JSP页面使用此标签只