当前位置: 首页>前端>正文

JSTL标签与自定义标签

目录

1、JSP动作标签

1.1  标签

1.2 标签

1.3 标签

2 、JSTL标签(经常用)

2.1 JSTL标签库概述

2.2 JSTL的作用

2.3 core:核心标签库  

2.3.1 标签

2.3.2 标签

2.3.3  标签

3.3.4 标签       

2.3.5 标签

2.3.6 + + 标签

2.3.7

2.3.8 标签    

2.3.9 标签   

2.3.10 标签    

2.4 EL函数库的使用

3、自定义标签

3.1 自定义标签简介

3.2 SimpleTag方法介绍

3.3 SimpleTag接口方法的执行顺序

3.4 使用自定义标签

3.5 案例


1、JSP动作标签

        虽然我们希望JSP页面仅用作数据显示模块,不要嵌套任何java代码引入任何业务逻辑,但在实际开发中不引入一点业务逻辑是不可能的,但引入业务逻辑会导致页面出现难看java代码,怎么办?
    Sun公司允许用户开发自定义标签封装页面的java代码,以便jsp页面不出现一行java代码。当然Sun公司在jsp页面中也内置了一些标签(这些标签叫做jsp标签/动作),开发人员使用这些标签可以完成页面的一些常用业务逻辑。
        JSP标签也称之为Jsp Action(JSP动作)元素,它用于在JSP页面中提供业务逻辑功能。

        JSP常用标签
            <jsp:include>标签  
            <jsp:forward>标签  
            <jsp:param>标签  


1.1  <jsp:include>标签

        <jsp:include>标签用于把另外一个资源的输出内容插入进当前JSP页面的输出内容之中,这种在JSP页面执行时的引入方式称之为动态引入。
语法:
    <jsp:include page="relativeURL | <%=expression%>" flush="true|false" />
        page属性用于指定被引入资源的相对路径,它也可以通过执行一个表达式来获得。
flush属性指定在插入其他资源的输出内容时,是否先将当前JSP页面的已输出的内容刷新到客户端,默认为false。

        <jsp:include>与include指令的比较
      <jsp:include>标签是动态引入, <jsp:include>标签涉及到的2个JSP页面会被翻译成2个servlet,这2个servlet的内容在执行时进行合并。 
        而include指令是静态引入,涉及到的2个JSP页面会被翻译成一个servlet,其内容是在源文件级别进行合并。
        不管是<jsp:include>标签,还是include指令,它们都会把两个JSP页面内容合并输出,所以这两个页面不要出现重复的HTML全局架构标签,否则输出给客户端的内容将会是一个格式混乱的HTML文档。

        <jsp:include>标签:使用page属性指定被引入资源。
        include指令:使用file属性指定被引入资源。


1.2 <jsp:forward>标签

        <jsp:forward>标签用于把请求转发给另外一个资源。
        语法:
       <jsp:forward page="relativeURL | <%=expression%>" /> 
        page属性用于指定请求转发到的资源的相对路径,它也可以通过执行一个表达式来获得。

1.3 <jsp:param>标签

        当使用<jsp:include>和<jsp:forward>标签引入或将请求转发给其它资源时,可以使用<jsp:param>标签向这个资源传递参数。
 语法1:
    <jsp:include page="relativeURL | <%=expression%>">
        <jsp:param name="parameterName" value="parameterValue|<%= expression %>" />
    </jsp:include>

语法2:
    <jsp:forward page="relativeURL | <%=expression%>">
        <jsp:param name="parameterName" value="parameterValue|<%= expression %>" />
    </jsp:include>
        <jsp:param>标签的name属性用于指定参数名,value属性用于指定参数值。在<jsp:include>和<jsp:forward>标签中可以使用多个<jsp:param>标签来传递多个参数。

如何查找JSP页面中的错误
       JSP页面中的JSP语法格式有问题,导致其不能被翻译成Servlet源文件,JSP引擎将提示这类错误发生在JSP页面中的位置(行和列)以及相关信息。
       JSP页面中的JSP语法格式没有问题,但被翻译成的Servlet源文件中出现了Java语法问题,导致JSP页面翻译成的Servlet源文件不能通过编译,JSP引擎也将提示这类错误发生在JSP页面中的位置(行和列)以及相关信息。
      JSP页面翻译成的Servlet程序在运行时出现异常,这与普通Java程序的运行时错误完全一样,Java虚拟机将提示错误发生在Servlet源文件中的位置(行和列)以及相关信息。

2 、JSTL标签(经常用)

2.1 JSTL标签库概述

        JSTL是sun公司开发的一套标签库,使用JSTL可以在页面中实现一些简单的逻辑,从而替换页面中的脚本代码。
        在页面中使用JSTL标签需完成以下2个步骤:
        1、导入jstl.jar和standerd.jar这两个JSTL的jar文件。
        2、在JSP页面中使用<%@ tablib url=“”  prifix=“” %>元素导入标签库。

2.2 JSTL的作用

可维护性:
            简化Jsp的页面编程
            使得jsp页面的开发尽可能少的依赖java脚本
可重用性
            以标签的形式封装页面开发的功能

标签库

标签库

URI

前缀

Core

http://java.sun.com/jsp/jstl/core

c

XML processing

http://java.sun.com/jsp/jstl/xml

x

I18N formatting

http://java.sun.com/jsp/jstl/fmt

fmt

Database access

http://java.sun.com/jsp/jstl/sql

sql

Functions

http://java.sun.com/jsp/jstl/functions

fn

2.3 core:核心标签库  

        用途:在JSTL中,一般用途的标签主要是指具有输出,设置变量, 和错误处理等功能的标签,他们在jsp中使用比较频繁,
功能主要包括:

范围对象/变量的管理

<c:out><c:set> 、 <c:remove> 、 <c:catch>

条件的判断

<c:if> <c:choose> <c:when> <c:otherwise>

循环迭代

<c:forEach> 、 <c:forTokens>

url

<c:import> 、 <c:url> 、 <c:redirect> 、 <c:param>

2.3.1 <c:set>标签

        功能:这个标签用于在某个范围(page,request,session,application)里面设置特定的值(默认为page),或者设置某个已经存在的javabean的属性。
语法:
        <c:set value=”value” var=”varName”  [scope= “{page|request|session|application}”]/ >
        <c:set value=”value” target=”target” property=”propertyName”/ >

属性名

是否支持EL

属性类型

value

true

Object

用于指定属性值

var

false

String

用于指定要设置的Web域属性的名称

scope

false

String

用于指定属性所在的Web

target

true

Object

用于指定要设置属性的对象,这个对象必须是JavaBean对象或java.util.Map对象

property

true

string

用于指定当前要为对象设置的属性名称

案例:
 JSTL标签与自定义标签,第1张

2.3.2 <c:out>标签

语法:
        <c:out value=”value” [escapeXml]=”{true|false}” [default=”defaultValue”]/>

属性名

是否支持EL

属性类型

value

true

Object

指定要输出的内容

escapeXml

true

Boolean

指定是否将><&'" 等特殊字符进行HTML编码转换后再进行输出。默认值为true

default

true

Object

指定如果value属性的值为null/””时所输出的默认值

2.3.3  <c:remove>标签

<c:remove>标签用于删除各种Web域中的属性。
    其语法格式如下:

    <c:remove var="varName"     
            [scope="{page|request|session|application}"] />

3.3.4 <c:catch>标签       

        <c:catch>标签用于捕获嵌套在标签体中的内容抛出的异常,其语法格式如下:<c:catch [var="varName"]>nested actions</c:catch>

属性名

是否支持EL

属性类型

value

true

Object

指定要输出的内容

escapeXml

true

Boolean

指定是否将><&'" 等特殊字符进行HTML编码转换后再进行输出。默认值为true

default

true

Object

指定如果value属性的值为null/””时所输出的默认值

2.3.5 <c:if>标签

语法:

JSTL标签与自定义标签,第2张

属性名

是否支持EL

属性类型

test

true

boolean

决定是否处理标签体中的内容的条件表达式

var

false

String

用于指定将test属性的执行结果保存到某个Web域中的某个属性的名称

scope

false

String

指定将test属性的执行结果保存到哪个Web域中

例子
JSTL标签与自定义标签,第3张

2.3.6 <c:choose> + <c:when> + <c:otherwise>标签

<c:when>,<c:otherwise>作为<c:choose>的子标记
例子:
JSTL标签与自定义标签,第4张

2.3.7 <c:forEach>

语法:
 JSTL标签与自定义标签,第5张

属性名

是否支持EL

属性类型

var

false

String

指定将当前迭代到的元素保存到page这个Web域中的属性名称

items

true

任何支持的类型

将要迭代的集合对象

varStatus

false

String

指定将代表当前迭代状态信息的对象保存到page这个Web域中的属性名称

begin

true

int

如果指定items属性,就从集合中的第begin个元素开始进行迭代,begin的索引值从0开始编号;如果没有指定items属性,就从begin指定的值开始迭代,直到end值时结束迭代

end

true

int

参看begin属性的描述

step

true

int

指定迭代的步长,即迭代因子的迭代增量

varStatus属性说明

current

getCurrent()

当前这次迭代的(集合中的)项

index

getIndex()

当前这次迭代从 0 开始的迭代索引

count

getCount()

当前这次迭代从 1 开始的迭代计数

first

 isFirst()

用来表明当前这轮迭代是否为第一次迭代的标志

last

isLast()

用来表明当前这轮迭代是否为最后一次迭代的标志 

begin 

getBegin()

begin 属性值

end

 getEnd()

end 属性值

step 

getStep()

step 属性值

   例子:
 JSTL标签与自定义标签,第6张

2.3.8 <c:param>标签    

        在JSP页面进行URL的相关操作时,经常要在URL地址后面附加一些参数。<c:param>标签可以嵌套在<c:import>、<c:url>或<c:redirect>标签内,为这些标签所使用的URL地址附加参数。        <c:param>标签在为一个URL地址附加参数时,将自动对参数值进行URL编码,例如,如果传递的参数值为“中国”,则将其转换为“%d6%d0%b9%fa”后再附加到URL地址后面,这也就是使用<c:param>标签的最大好处。 

http://localhost:808/servlet/MyServlet?name=“中国”
示例:<c:param name=“name” value=“中国" />

2.3.9 <c:url>标签   

        <c:url>标签用于在JSP页面中构造一个URL地址,其主要目的是实现URL重写。URL重写就是将会话标识号以参数形式附加在URL地址后面。

属性名

是否支持EL

属性类型

value

true

String

指定要构造的URL/表示day15

var

false

String

指定将构造出的URL结果保存到Web域中的属性名称

scope

false

String

指定将构造出的URL结果保存到哪个Web域中

2.3.10 <c:redirect>标签    

        <c:redirect>标签用于将当前的访问请求转发或重定向到其他资源,它可以根据url属性所指定的地址,执行类似<jsp:forward>这个JSP标准标签的功能,将访问请求转发到其他资源;或执行response.sendRedirect()方法的功能,将访问请求重定向到其他资源。

属性名

是否支持EL

属性类型

url

true

String

指定要转发或重定向到的目标资源的URL地址

2.4 EL函数库的使用

        1)由于在JSP页面中显示数据时,经常需要对显示的字符串进行处理,SUN公司针对于一些常见处理定义了一套EL函数库供开发者使用。
        2)这些EL函数在JSTL开发包中进行描述,因此在JSP页面中使用SUN公司的EL函数库,需要导入JSTL开发包,并在页面中导入EL函数库,如下所示:
        3)在页面中使用JSTL定义的EL函数:
        <%@taglib uri="http://java.sun.com/jsp/jstl/functions" prefix="fn"%>

fn:toLowerCase
        fn:toLowerCase函数将一个字符串中包含的所有字符转换为小写形式,并返回转换后的字符串,它接收一个字符串类型的参数,例如 
        •    fn:toLowerCase("Www.IT315.org") 的返回值为字符串“www.it315.org”
        •    fn:toLowerCase("")的返回值为空字符串

fn:toUpperCase
        fn:toUpperCase函数将一个字符串中包含的所有字符转换为大写形式,并返回转换后的字符串,它接收一个字符串类型的参数。例如:
        •    fn:toUpperCase("Www.IT315.org") 的返回值为字符串“WWW.IT315.ORG”
        •    fn:toUpperCase("")的返回值为空字符串

fn:trim
        fn:trim函数删除一个字符串的首尾的空格,并返回删除空格后的结果字符串,它接收一个字符串类型的参数。需要注意的是,fn:trim函数不能删除字符串中间位置的空格。
        •    例如,fn:trim("   www.it315.org  ") 的返回值为字符串“www.it 315.org”。

fn:length
        fn:length函数返回一个集合或数组大小,或返回一个字符串中包含的字符的个数,返回值为int类型。fn:length函数接收一个参数,这个参数可以是<c:forEach>标签的items属性支持的任何类型,包括任意类型的数组、java.util.Collection、java.util.Iterator、java.util.Enumeration、java.util.Map等类的实例对象和字符串。
        如果fn:length函数的参数为null或者是元素个数为0的集合或数组对象,则函数返回0;如果参数是空字符串,则函数返回0。 

fn:contains
        fn:contains函数检测一个字符串中是否包含指定的字符串,返回值为布尔类型。fn:contains函数在比较两个字符串是否相等时是大小写敏感的。
        fn:contains函数接收两个字符串类型的参数,如果第一个参数字符串中包含第二个参数字符串,则fn:contains函数返回true,否则返回false。如果第二个参数的值为空字符串,则fn:contains函数总是返回true。实际上,fn:contains(string, substring)等价于fn:indexOf(string, substring) != -1。
忽略大小的EL函数:fn:containsIgnoreCase 

3、自定义标签

3.1 自定义标签简介

        自定义标签主要用于移除Jsp页面中的<%java%>代码。

        快速入门:使用自定义标签输出客户机IP

         移除jsp页面中的java代码,只需要完成两个步骤:
            实现SimpleTag接口/SimpleTagSupport类,重写doTag()方法。
            编写标签库描述符(tld)文件,在tld文件中对自定义标签进行描述,并放置在WEB-INF/目录下。
            完成以上操作,即可在JSP页面中导入和使用自定义标签。

        查看SimpleTag接口api文档,分析自定义标签的执行流程。

        自定义标签描述
        SUN公司为降低标签技术的学习难度,在JSP 2.X中定义了一个更为简单、便于编写和调用的SimpleTag接口来实现标签的功能。实现SimpleTag接口的标签通常称为简单标签。简单标签共定义了5个方法:
            setJspContext方法
            setParent和getParent方法
            setJspBody方法
            doTag方法

3.2 SimpleTag方法介绍

setJspContext方法
            用于把JSP页面的pageContext对象传递给标签处理器对象 
setParent方法
            用于把父标签处理器对象传递给当前标签处理器对象 
getParent方法
            用于获得当前标签的父标签处理器对象 
setJspBody方法
            用于把代表标签体的JspFragment对象(即标签体内容)传递给标签处理器对象 
doTag方法
            用于完成所有的标签逻辑,包括输出、迭代、修改标签体内容等。在doTag方法中可以抛出javax.servlet.jsp.SkipPageException异常,用于通知WEB容器不再执行JSP页面中位于结束标记后面的内容。

3.3 SimpleTag接口方法的执行顺序

 当web容器开始执行标签时,会调用如下方法完成标签的初始化
            WEB容器调用标签处理器对象的setJspContext方法,将代表JSP页面的pageContext对象传递给标签处理器对象。
            WEB容器调用标签处理器对象的setParent方法,将父标签处理器对象传递给这个标签处理器对象。注意,只有在标签存在父标签的情况下,WEB容器才会调用这个方法。
            如果调用标签时设置了属性,容器将调用每个属性对应的setter方法把属性值传递给标签处理器对象。如果标签的属性值是EL表达式或脚本表达式,则WEB容器首先计算表达式的值,然后把值传递给标签处理器对象。
            如果简单标签有标签体,容器将调用setJspBody方法把代表标签体的JspFragment对象传递进来。

执行标签时:
        容器调用标签处理器的doTag()方法,开发人员在方法体内通过操作JspFragment对象,就可以实现是否执行、迭代、修改标签体的目的。

JspFragment类
        javax.servlet.jsp.tagext.JspFragment类是在JSP2.0中定义的,它的实例对象代表JSP页面中的一段符合JSP语法规范的JSP片段,这段JSP片段中不能包含JSP脚本元素,即<%%>。

        WEB容器在处理简单标签的标签体时,会把标签体内容用一个JspFragment对象表示,并调用标签处理器对象的setJspBody方法把JspFragment对象传递给标签处理器对象。JspFragment类中只定义了两个方法,如下所示:

getJspContext方法:用于返回代表调用页面的JspContext对象.

public abstract void invoke(java.io.Writer out) :用于执行JspFragment对象所代表的JSP代码片段
        参数out用于指定将JspFragment对象的执行结果写入到哪个输出流对象中,如果传递给参数out的值为null,则将执行结果写入到JspContext.getOut()方法返回的输出流对象中。(简而言之,可以理解为写给浏览器)

invoke方法详解
        JspFragment.invoke方法可以说是JspFragment最重要的方法,利用这个方法可以控制是否执行和输出标签体的内容、是否迭代执行标签体的内容或对标签体的执行结果进行修改后再输出。例如:
            在标签处理器中如果没有调用JspFragment.invoke方法,其结果就相当于忽略标签体内容;
            在标签处理器中重复调用JspFragment.invoke方法,则标签体内容将会被重复执行;
            若想在标签处理器中修改标签体内容,只需在调用invoke方法时指定一个可取出结果数据的输出流对象(例如StringWriter),让标签体的执行结果输出到该输出流对象中,然后从该输出流对象中取出数据进行修改后再输出到目标设备,即可达到修改标签体的目的。  

3.4 使用自定义标签

    控制标签体内容是否执行
    控制标签后内容是否执行
    控制标签体内容复重执行
    控制标签体内容改变
    控制标签体内容复重执行,复重次数由标签属性决定

开发带属性的标签
       自定义标签可以定义一个或多个属性,这样,在JSP页面中应用自定义标签时就可以设置这些属性的值,通过这些属性为标签处理器传递参数信息,从而提高标签的灵活性和复用性。

        要想让一个自定义标签具有属性,通常需要完成两个任务:
        在标签处理器中编写每个属性对应的setter方法
        在TLD文件中描述标签的属性

        为自定义标签定义属性时,每个属性都必须按照JavaBean的属性命名方式,在标签处理器中定义属性名对应的setter方法,用来接收JSP页面调用自定义标签时传递进来的属性值。 例如属性url,在标签处理器类中就要定义相应的setUrl(String url)方法。

        在标签处理器中定义相应的set方法后,JSP引擎在解析执行开始标签前,会调用setter属性方法,为标签设置属性。

在TLD中描述标签属性

元素名

是否必须指定

描     

description

用于指定属性的描述信息。

name

用于指定属性的名称。属性名称是大小写敏感的,并且不能以jsp_jspjavasun开头。

required

用于指定在JSP页面中调用自定义标签时是否必须设置这个属性。其取值包括true和false,默认值为false,true表示必须设置,否则可以设置也可以不设置该属性。

rtexprvalue

rtexprvalueruntime expression value(运行时表达式)的英文简写,用于指定属性值是一个静态值或动态值。其取值包括truefalse,默认值为false,false表示只能为该属性指定静态文本值,例如"123";true表示可以为该属性指定一个JSP动态元素,动态元素的结果作为属性值,例如JSP表达式<%=value %>。

type

用于指定属性值的Java类型。

3.5 案例

使用标签控制页面逻辑案例:
    开发防盗链标签[request.getHeader(“referer”)]
    开发仿<c:if>标签
    开发仿<c:if><c:else><c:else>。。。标签
    开发仿<c:forEach>Collection/Map
    开发html转义标签(webapps\examples\WEB-                       INF\classes\util)
    打包标签库(jar和war)


https://www.xamrdz.com/web/2u61936578.html

相关文章: