码迷,mamicode.com
首页 > Web开发 > 详细

Servlet和JSP之自定义标签学习

时间:2018-02-24 10:48:28      阅读:229      评论:0      收藏:0      [点我收藏+]

标签:and   1.0   复制   类型   jsp页面   定义   exp   mvc   instance   

    此文章会讲述简单标签处理器,因为经典自定义标签处理器没有简单标签处理器方便使用,故在此不进行描述。

         参考:慕课网的《JSP自定义标签》视频;

    《Servlet、JSP和Spring MVC初学指南》的第六章;

    IBM的《利用 JSP 2 提供的 SimpleTagSupport 开发自定义标签》;

    菜鸟教程的JSP自定义标签文章。  


       自定义标签  

  自定义标签

         自定义标签就是将方法封装到自定义标签处理类中,然后使用方法与JSTL标签来达到,解决JSP中JavaBean的展现与业务实现分离问题。自定义标签提供了在JavaBean中所不能实现的便利,其中就包括,自定义标签允许访问JSP中隐藏的对象及它们的属性。

         自定义标签的实现,叫做标签处理器,而简单标签处理器是指实现SimpleTag接口(或继承SimpleTagSupport类)实现的标签处理器,经典标签处理器是指实现BodyTag接口(或继承BodyTagSupport类)等实现的标签处理器。

 

  自定义标签的继承结构

    JSP<----Tag <----IterationTag<----TagSupport<----BodyTagSupport<-----BodyTag

    JSP<----SimpleTag<-----SimpleSupportTag

 

         简单标签处理器

         简单标签处理器有简单的生命周期,SimpleTag接口中用于标签触发的方法只有一个------doTag,并且该方法只会执行一次。业务逻辑、遍历及页面内容操作都在这里实现。简单标签处理器中的页面内容都在JspFragment类的实例中体现。

 

         简单标签的生命周期如下:

 

1)       JSP容器通过简单标签处理器的无参数构造器创建它的实例,因此,简单标签处理器必须有无参数构造器(一般不用自己写, 用系统默认的就可以了)。

2)       JSP容器通过setJspContext的方法,传入JspContext对象:该对象中最重要的方法是getOut(),它能返回JspWriter,通过JspWriter就可以把响应返回前端了。

3)       如果自定义标签被另一个自定义标签所嵌套,JSP容器就会调用setParent的方法。

4)       JSP容器调用该标签中所定义的每个属性的Set方法。

5)       如果需要处理页面内容,JSP容器还会调用SimpleTag接口的setJspBody方法,把使用JspFragment封装的页面内容传过来。当然,如果没有页面内容,那么JSP容器不会调用该方法。

 

  接下来是SimpleTag接口的详解

 

方法

说明

doTag()方法

是核心方法,用于编写标签处理逻辑。

setParent(JspTag)方法

将父标签处理器对象传递给标签处理器。

getParent()方法

获取当前标签的父标签对象。

setJspContext(JspContext)方法

将JSP页面的pageContext对象传递给标签处理器对象。

setJspBody(JspFragment)方法

将代表当前标签体的JspFragment对象传递给标签处理器对象。(JspFragment中的invoke(Writer)方法用于执行JspFragment对象所代表的代码段)

  

  是不是看着上面的一大串文字,有点懵?没事儿,下面就是关于实现SimpleTagSupport类(跟实现SimpleTag接口的功用类似)的例子。

  首先需要准备一个SimpleTag的.tld文件,用于注册自定义标签,这个文件是在apache-tomcat文件里面,一般地址是在E:\apache-tomcat-6.0.39\webapps\examples\WEB-INF\jsp里面,名称是jsp2-example-taglib.tld

  用一个显示当前时间的jsp页面来做为第一个例子:

 

  自定义标签的创建步骤

1)       创建标签处理类

package com.ny.tag2;
import java.io.IOException;
import java.text.SimpleDateFormat;
import java.util.Date;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.SimpleTagSupport;

public class DisplayInfo extends SimpleTagSupport{

    @Override
    public void doTag() throws JspException, IOException {
        SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd  HH:mm:ss");
        String dateStr = simpleDateFormat.format(new Date());
        JspWriter jspWriter = getJspContext().getOut();
        jspWriter.write(dateStr);
    }
}

 

2)       创建标签库文件

  在WEB-INF目录下创建一个.tld文件(如nyTag.tld),然后打开jsp2-example-taglib.tld文件,里面有我们需要的taglib配置,打开这个文件之后找到下面的代码段,复制到nyTag.tld中。

  如果tid文件位于WEB-INF文件下面,Tomcat会自动加载tld文件中的标签库。如果位于其他位置,其实也可以在web.xml中配置。

<?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">
    <description>A tag library exercising SimpleTag handlers.        </description>
    <tlib-version>1.0</tlib-version>
    <short-name>SimpleTagLibrary</short-name>
    <uri>/SimpleTagLibrary</uri>
</taglib>

 

3)       在标签库文件中注册标签

<?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">
    <description>A tag library exercising SimpleTag handlers.        </description>
    <tlib-version>1.0</tlib-version>
    <short-name>ny</short-name>
    <uri>/ny-tag</uri>
    <tag>
        <name>dateInfo</name>
        <tag-class>com.ny.tag2.DisplayInfo</tag-class>
        <body-content>empty</body-content>
    </tag>
</taglib>

① <short-name>:指明推荐使用的prefix(这个属性会在jsp页面中引入标签的时候出现)。

② <uri>:指明引用这个标签库时使用的uri(注意哦是uri不是url)。

③ <tag>:指明要定义标签的信息。

其中,tag可以设置的属性如下:

 

属性

说明

name

定义属性的名称,每个标签的属性名称必须是唯一的。

tag-class

指定映射的Java类。

required

指定属性是否是必须的或者可选的,如果是必须的就设置为true。

rtexprvalue

声明在运行表达式时,标签属性是否有效,有效则为true。

type

定义该属性的Java类类型,默认指定为String。

decription

描述信息

fragment

如果声明了该属性,属性值将被视为一个JspFragment。

bodycontent

指明标签体的限定,可以有以下几种取值(想了解更多可以在”参考”中查找到):a) empty:指定该标签只能作用空标签使用;b) scriptless:指定该标签的标签体可以是静态HTML元素、表达式语言,但不允许出现JSP脚本。

 

4)       在页面中引入标签库

 

<%@ taglib prefix="ny" uri="/ny-tag"%>

 

 

 

5)       在页面中使用标签

 

<body>
    <imooc:dateInfo/>
</body>

 

  

  所以JSP页面中的代码就是:

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@ taglib prefix="imooc" uri="/imooc-tag2" %>
<!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>
    <imooc:dateInfo/>
</body>
</html>

  

  是不是感觉还挺简单的呢? 其实自定义标签的用法不止这些哦,加油吧!

 

Servlet和JSP之自定义标签学习

标签:and   1.0   复制   类型   jsp页面   定义   exp   mvc   instance   

原文地址:https://www.cnblogs.com/NYfor2018/p/8463776.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!