Java精选笔记_JSTL(JSP标准标签库)

JSTL（JSP标准标签库）

JSTL入门

JavaServer Pages Standard Tag Library：JSP标准标签库
在JSP中可以通过Java代码来获取信息，但是过多的Java代码会使JSP页面非常复杂。为此，Sun公司制定了一套标准标签库JSTL。

什么是JSTL

标准标签库。这个标签库是由5个不同功能的标签库共同组成
标签名                              URI                                                                前缀                                      范例
Core(核心)            http://java.sun.com/jsp/jstl/core             c                                      <c:tagname>
XML                             http://java.sun.com/jsp/jstl/xml                         x                                       <x:tagname>
Internationalization(国际化)             http://java.sun.com/jsp/jstl/fmt        fmt       <fmt:tagname>
Functions(函数)                  http://java.sun.com/jsp/jstl/functions                fn           <fn:tagname>
SQL(关系型数据库)       http://java.sun.com/jsp/jstl/sql                                 sql         <sql:tagname>




标签库                                   标签库的URI                              前缀
Core                 http://java.sun.com/jsp/jstl/core         c
I18N                   http://java.sun.com/jsp/jstl/fmt           fmt
SQL                   http://java.sun.com/jsp/jstl/sql            sql
XML                   http://java.sun.com/jsp/jstl/xml             x
Functions     http://java.sun.com/jsp/jstl/functions        fn


Core是一个核心标签库，它包含了实现Web应用中通用操作的标签。
I18N是一个国际化/格式化标签库，它包含实现Web应用程序的国际化标签和格式化标签。
SQL是一个数据库标签库，它包含了用于访问数据库和对数据库中的数据进行操作的标签。
XML是一个操作XML文档的标签库，它包含对XML文档中的数据进行操作的标签。
Function是一个函数标签库，它提供了一套自定义EL函数，包含了JSP网页制作者经常要用到
的字符串操作。

是一个JSP标签的集合，用于简化JSP程序的开发，并使JSP程序更易于维护和管理。

安装和测试JSTL

下载地址为http://tomcat.apache.org/taglibs/standard/，文件名为jakarta-taglibs-standard-1.1.2.zip
在lib目录下有两个JAR包：jstl.jar和standard.jar，这两个文件即为所需要的JSTL标签库
如果要在JSP页面中使用核心库的标签，需要用taglib指令指明这个标签库的路径
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>

JSTL中的Core标签库

表达式操作标签

<c:out>标签

可以将一段文本内容或表达式的结果输出到客户端。
功能与JSP传统的<%=表达式%>相类似
语法1：没有标签体的情况
<c:out value="value" [default="defaultValue"] [escapeXml="{true|false}"]/>


语法2：有标签体的情况，在标签体中指定输出的默认值
<c:out value="value" [escapeXml="{true|false}"]>
    defaultValue 
</c:out>
value属性：用于指定输出的文本内容，可为常量值或表达式
default属性：用于指定当value属性为null时所输出的默认值，该属性是可选的（方括号中的属性都是可选的）   
escapeXml属性：用于指定是否将>、<、&、'、" 等特殊字符进行HTML编码转换后再进行输出，默认值为true。需要注意的是，只有当value属性值为null时，<c:out>标签才会输出默认值，如果没有指定默认值，则默认输出空字符串。

<c:set>标签

用于设置域对象属性的值，或者设置对象中用于存储数据的Map对象、JavaBean对象属性的值
语法1：使用value属性设置域对象某个属性的值
    <c:set value="value" var="varName" [scope="{page|request|session|application}"]/>
语法2：标签体设置指定域中某个属性的值
    <c:set var="varName" [scope="{page|request|session|application}]>
         body content
    </c:set>
语法3：使用value属性设置某个域对象属性的值
    <c:set var="varName" value="value" target="target" property=" protertyName "/>
语法4：使用标签体设置某个对象属性的值 
    <c:set var="varName" target="target" property="protertyName">
       body content
    </c:set>
    value属性：用于设置属性的值
    var属性：用于指定要设置的域对象属性的名称
    scope属性：用于指定属性所在的域对象
    target属性：用于指定要设置属性的对象，这个对象必须是JavaBean对象或Map对象
    property属性：用于指定要为当前对象设置的属性名称

<c:remove>标签

一般和<c:set>标签配套使用，两者是相对应的
专门用于删除各种域对象的属性
<c:remove var="varName" [scope="{page|request|session|application}"] />
var属性：用于指定要删除的属性名称
scope属性：用于指定要删除属性所属的域对象，它们的值都不能接受动态值。实际上<c:remove>标签与<c:set>标签将value属性的值设置为null（<c:set value="null" var="varName"/>）的作用是相同的

<c:catch>标签

功能和Java程序中try{}catch{}语句功能很类似，用于捕获嵌套在<c:catch>标签体中出现的异常
    <c:catch [var="varName"]>
        Nested actions
    </c:catch>

流程控制标签

<c:if>标签

作用和Java程序中的if语句作用相同，专门用于完成JSP页面中的条件判断
语法1：没有标签体的情况
    <c:if test="testCondition" var="resulst" [scope="{page|request|session|application}"]/>


语法2：有标签体的情况，在标签体中指定要输出的内容
    <c:if test="testCondition" var="resulst" [scope="{page|request|session|application}"]>
        body content
    </c:if>
    test属性：用于设置逻辑表达式
    var属性：用于用于指定逻辑表达式中变量的名字
    scope属性：用于指定var变量的作用范围，默认值为page。如果属性test的计算结果为true，那么标签体将被执行，否则标签体不会执行。

<c:choose>标签

用于指定多个条件选择的组合边界，它必须与<c:when>、<c:otherwise>标签一起使用，就相当于Java程序中的switch条件语句
<c:choose>标签不含任何属性，在它的标签体中只能嵌套一个或多个<c:when>标签和零个或一个<c:otherwise>标签，并且同一个<c:choose>标签中所有的<c:when>子标签必须出现在<c:otherwise>子标签之前
    <c:choose>
        Body content(<when> and <otherwise> subtags)
    </c:choose>

<c:when>标签

只有一个test属性，该属性的值为布尔类型。test属性支持动态值，其值可以是一个条件表达式，如果条件表达式的值为true，就执行这个<c:when>标签体的内容
    <c:when test="testCondition">
   Body content
    </c:when>

<c:otherwise>

没有属性，它必须作为<c:choose>标签最后分支出现，当所有的<c:when>标签的test条件都不成立时，才执行和输出<c:otherwise>标签体的内容
    <c:otherwise>
        conditional block
    </c:otherwise>

迭代操作标签

<c:forEach>标签

专门用于迭代集合对象中的元素，如Set、List、Map、Collection、Iterator、String数组等，并且能重复执行标签体中的内容
语法1：迭代包含多个对象的集合
    <c:forEach [var="varName"] items="collection" [varStatus="varStatusName"]
    [begin="begin"] [end="end"] [step="step"]>
        body content
    </c:forEach>
语法2：迭代指定范围内的集合
    <c:forEach [var="varName"] [varStatus="varStatusName"] begin="begin" end="end" [step="step"]>
        body content
    </c:forEach>


var属性：用于指将当前迭代到的元素保存到page域中的名称
items属性：必写，用于指定将要迭代的集合对象，一般和EL表达式连用。
varStatus属性：用于指定当前迭代状态信息的对象保存到page域中的名称
begin属性：用于指定从集合中第几个元素开始进行迭代，begin的索引值从0开始，如果没有指定items属性，就从begin指定的值开始迭代，直到迭代结束为止
end：循环的结束位置，end的取值不能小于begin
step属性：用于指定迭代的步长，即迭代因子的增量

<c:forTokens>标签

与<c:forEach>标签类似，都可以完成迭代功能，只不过<c:forTokens>标签用于迭代字符串中用指定分隔符分隔的子字符，并且能重复执行标签体
<c:forTokens items="StringOfTokens" delims="delimiters" 
[var="varName"] [varStatus="varStatusName"]
[begin="begin"] [end="end"] [step="step"]>
         body content
</c:forTokens>
items属性：用于指定将要分隔的字符串
delims属性：用于指定具体的分隔符，可以是一个或多个
var属性：用于指当前迭代的元素保存到page域中的属性名称
varStatus属性：用于指定当前迭代状态信息的对象保存到page域中的属性名称
begin属性：用于指定从集合中第几个元素开始进行迭代
step属性：用于指定迭代的步长，即迭代因子的增量

URL相关的标签

<c:import>标签

用来引入某个URL指向的网页内容到当前JSP网页中。它和传统的JSP标记<jsp:include>相类似，但是有所不同：<jsp:include>标签只能使用来包括该应用中的其他文件，而<c:import>则还可以包含外部站点中的静态文件，所以它的功能更加的强大。


网页内容以String对象的形式输出
<c:impert url="url" [context="context"][var="var"]
[scope="{page|request|session|application}"][charEncoding="charEncoding"]>
...
</c:import>


以Reader
<c:import url="url" [context="context"] varReader="varreader" [charEncoding="charencoding"]>
...
</c:import>
url String 需要导入的网页URL
context String url指定为其他网站的某个URL时，本地网站的路径
var String 存储导入文件内容的变量
scope String 变量var的作用域
charEncoding String 导入文件的字符集

varReader String 用来读取导入文件内容的Reader对象

<c:redirect>标签

用于将请求重定向到其它的Web资源，就相当于在Java程序中执行了response.sendRedirect()方法
语法1：没有标签体的情况
<c:redirect url="value" [context="context"]/>


语法2：有标签体的情况，在标签体中指定重定向时的参数
<c:redirect url="value" [context="context"]>
    <c:patam name="name" value="value"/>
</c:redirect>


url属性：用于指定指定要转发或重定向到目标资源的URL地址，可以使用相对路径和绝对路径
context属性：用于指定重定向到同一个服务器中其它Web应用的名称

<c:param>标签

用于在URL地址中附加参数，它通常嵌套在<c:url>标签内使用
是和<c:redirect>标签一起使用的，它用来进行参数值的传递
语法1：使用value属性指定参数的值
<c:param name="name" value="value"/>
语法2：在标签体中指定参数的值
<c:param name="name">
parameter value
</c:param>
name属性：用于指定参数的名称
value属性：用于指定参数的值，当使用<c:praram>标签为一个URL地址附加参数时，它会自动对参数值进行URL编码，例如，如果传递的参数值为“中国”，则将其转换为“%e4%b8%ad%e5%9b%bd”后再附加到URL地址后面，这也是使用<c:param>标签的最大好处。

<c:url>标签

可以在JSP页面中构造一个新的URL地址，实现URL的重写
语法1：没有标签实体的情况
<c:url value="value" [context="context"] [var="varName"]
[scope="{page|request|session|appliction}"] />
语法2：有标签实体的情况，在标签体中指定构造URL参数
<c:url value="value" [context="context"] [var="varName"]
[scope="{page|request|session|appliction}"]>
<c:param>标签
</c:url>
value属性：用于指定构造的URL
context属性：用于指定导入同一个服务器下其它Web应用的名称
var属性：用于指定将构造的URL地址保存到域对象的属性名称

scope属性：用于指定将构造好的URL保存到域对象中

XML操作标签库

在Java中可以使用SAX或者DOM等API接口来操作XML文档，尽管这种操作功能非常强大而且灵活，但是要很快熟练掌握是有相当大难度的
在JSTL中提供了一组专门处理XML文档的标签，这些标签所提供的功能尽管非常有限，但是已经可以满足基本的XML文档处理需要，而且这些标签学习起来明显比掌握复杂的API接口要容易
如果要在JSP页面中使用XML操作标签库的标签，需要用taglib指令指明这个标签库的路径为
<%@ taglib="x" uro="http://java.sun.com/jsp/jstl/xml" %>

核心操作标签

<x:parse>
可以用来解析一个XML文档
以String或Reader对象指定XML
<x:parse> {doc="xmldocument"|xml="xmldocument"}
{var="var" [scope="scope"]|varDom="var" [scopeDom="scopedom"]}
[systemId="systemid"]
[filter="filter"] />
以body内容指定XML
<x:parse>{var="var" [scope="scope"]|varDom="var" [scopeDom="scope"]}
[systemId="systemid"][filter="filter"]>
    XML document to parse
</x:parse>
doc String or Reader 需要解析的XML文件
xml String or Reader 同doc属性，现已不再使用
var String 用于存储解析后XML文件的范围变量名
scope String 范围变量var的作用域
varDom String 用于存储解析后XML文件的范围变量名
scopeDom String 范围变量varDom的作用域
systemId String 用于解析XML文件的路径
filter org.xml.sax.XMLFilter 解析XML文件时使用在XML文件的过滤器
使用<x:parse>把一个XML文档解析以后，就可以使用<x:out>标签输出XML节点的值


<x:out>


<x:out>标签用于计算XPath表达式，然后把查找到的元素进行输出。XPath标准是用来对XML文档各部分数据进行定位的语言。
<x:out select="xpathexpression"[escapeXml="{true|false}"]/>
select值表示需要执行的Xpath表达式、escapeXml表示输出字符串中是否要转换成对应的代码
<x:set>
用来把XPath表达式处理的结果存储到某个范围变量中。与<c:set>标签不同之处在于<x:set>标签是把XML中某个节点的内容赋值到一个变量中。
<x: select="xpathexpression" var="varname" scope=["{page|request|session|application}"] />

流程控制标签

包含<x:if>、<x:choose>、<x:when>、<x:otherwise>及<x:forEach>标签
功能和用法和核心标签库对应的标签非常类似

转换操作标签

包含<x:transform>标签和<x:param>标签。

<x:param>标签的作用和用法也与<c:param>标签类似
<x:transform>标签
在网络应用程序中，经常需要通过XSL样式表对一篇XML文件执行转换
<x:transform xml="expression" xslt="expression" var="name" scope="scope" xmlSystemId="expression" xsltSystemId="expression">

<x:param name="expression" value="expression"/>

JSTL数据库标签库

如果要在JSP页面中使用数据库标签库的标签，需要用taglib指令指明这个标签库的路径为

<%@ taglib prefix="sql" uri="http://java.sun.com/jsp/jstl/sql" %>

建立数据源连接标签

<sql:setDataSource>
用来建立数据库连接
使用已存在的数据源连接数据库
<sql:setDataSource dataSource="dataSource"
[var="varName"]
[scope="{page|request|session|application}"] />


使用JDBC方式连接数据库
<sql:setDataSource driver="driverName" url="URL" [user="userName"][password="password"][var="varName"][scope="{page|request|session|application}"] />

数据库操作标签

<sql:query>标签

执行数据库中的查询操作

<sql:query var="varName" dataSource="dataSource" [maxRows="max"][startRow="start"][scope="page|request|session|application"] />

<sql:param>标签

向<sql:query>标签的SQL语句中传递参数
无本体内容
<sql:param value="value">
有本体内容
<sql:param>value</sql:param>

<sql:update>标签

对数据库进行插入、更新和删除操作
<sql:update sql="SQL语句" dataSource="dateSource" [var="varName"][scope="{page|request|session|application}"] />

<sql:dateParam>标签

和<sql:param>标签的功能和用法完全相同，不同之处是<sql:dateParam>标签是用来设置日期格式的参数
<sql:dataParam value="value"[type="{timestamp|time|date}"] />

<sql:transaction>标签

数据库操作的事务处理
<sql:transaction [dataSource="dataSource"][isolation="{read_uncommitted|read_committed|repeatable_read|serializable}"]>
数据库操作
</sql:transaction>

JSTL中的Functions标签库

为了简化JSP页面中对字符串的操作，JSTL的Functions标签库中提供了一套自定义EL函数，这套自定义EL函数包括了JSP页面制作者经常要用到的字符串操作。
如果要在JSP页面中使用函数标签库的标签，需要用taglib指令指明这个标签库的路径为

<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions"%>

fn:toLowerCase函数与toUpperCase函数

fn:toLowerCase函数    用于将一个字符串中包含的所有字符转换为小写形式
fn:toLowerCase(String source)
fn:toUpperCase函数    用于将一个字符串中包含的所有字符转换为大写形式
fn:toUpperCase(String source) 


fn:trim函数
用于删除一个字符串中开头和末尾的空格

fn:trim(String source) 

fn:escapeXml函数
专门用于将字符串中的“<”、“>”、“"”、“&”等特殊字符进行转义

fn:escapeXml(String source) 

fn:length函数
用于返回字符串中字符的个数，或者集合和数组中元素的个数

fn:length(source) 

fn:split函数
按照指定的分隔符，将一个字符串分割成字符串数组，并将这个字符串数组返回

fn:split(String source,String delimiter) ? String[]

fn:join函数
通过指定的分隔符，将一个字符串数组中的所有元素合并为一个字符串
fn:join(String  source[], String spearator) ? String


fn:indexOf函数
用于返回指定字符串在一个字符串中第一次出现的索引
fn:indexOf(String source,String target) ? int


fn:contains函数
专门用于判断一个字符串中是否包含指定的字符串
fn:contain(String source,String target) ? boolean


fn:containsIgnoreCase函数
专门用于检测一个字符串中是否包含指定的字符串
fn:containsIgnoreCase(String source,String target) ? boolean


fn:startsWith函数与fn:endsWith函数

fn:startsWith函数
用于判断一个字符串是否以指定字符串开始
fn:startsWith(String source,String target) 
fn:endsWith函数
用于判断一个字符串是否以指定字符串结束
fn:endsWith(String source,String target) 


fn:replace函数
将一个字符串中包含的指定字符串替换为其它字符串，并返回替换后的字符串
    fn:replace(String source,String before,String after)   String
    fn:substring、fn:substringAfter与fn:substringBefore函数
    fn:substring函数用于截取一个字符串中指定子字符串并返回截取到的子字符串
    fn:substring(String source,int beginIndex,int endIndex)   String
    fn:substringBefore函数用于截取并返回指定字符串之前的子字符串
    fn:substringBefore(String source,String target)   String
    fn:substringAfter函数用于截取并返回指定字符串之后的子字符串
    fn:substringAfter(String source,String target)   String
    fn:contains (string, substring) 如果参数string中包含参数substring，返回true
    fn:containsIgnoreCase(string,substring) 如果参数string中包含参数substring（忽略大小写），返回true
    fn:endsWith(string, suffix) 如果参数 string 以参数suffix结尾，返回true
    fn:escapeXml(string) 将有特殊意义的XML(HTML)转换为对应的XML character entity code，并返回
    fn:indexOf(string, substring) 返回参数substring在参数string中第一次出现的位置
    fn:join(array, separator) 将一个给定的数组array用给定的间隔符separator串在一起，组成一个新的字符串并返回
    fn:length(item) 返回参数item中包含元素的数量。参数Item类型是数组、collection或者String。如果是String类型,返回值是String中的字符数
    fn:replace(string, before, after) 返回一个String对象。用参数after字符串替换参数string中所有出现参数before字符串的地方，并返回替换后的结果
    fn:split(string, separator) 返回一个数组，以参数separator 为分割符分割参数string，分割后的每一部分就是数组的一个元素
    fn:startsWith(string, prefix) 如果参数string以参数prefix开头，返回true
    fn:substring(string, begin, end) 返回参数string部分字符串, 从参数begin开始到参数end位置，包括end位置的字符
    fn:substringAfter(string, substring) 返回参数substring在参数string中后面的那一部分字符串
    fn:substringBefore(string, substring) 返回参数substring在参数string中前面的那一部分字符串
    fn:toLowerCase(string) 将参数string所有的字符变为小写，并将其返回
    fn:toUpperCase(string) 将参数string所有的字符变为大写，并将其返回