首页 > 代码库 > JSTL
JSTL
JSTL简介
JSP虽然为我们提供了EL表达式用来替代JSP表达式,但是由于EL表达式仅仅具有输出功能,而不替代页面中的JSP脚本片段。
为了方便开发使用Sun公司又定义了一套通用的标签库名为JSTL(JSP Tag Standard Tag Library),里面定义很多我们开发中常用的方法,方便我们使用。
JSTL的标准由Sun公司定制,Apache的Jakarta小组负责实现。
JSTL由5个不同功能的标签库组成。
使用JSTL
使用JSTL必须在项目中导入两个jar包
taglibs-standard-impl-1.2.1.jar
taglibs-standard-spec-1.2.5.jar
然后还需要在JSP页面中通过taglib标签引入标签库。
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
prefix用来指定前缀名,我们通过该名来使用JSTL
uri相当于库的唯一标识,因为JSTL由多个不同的库组成,使用该属性指定要导入哪个库。
使用JSTL
<c:out value="http://www.mamicode.com/hello"></c:out>
这个例子标识,调用前缀为c的标签的out方法,向页面中输出value属性中的字符串。
JSTL的使用非常像html标签。
标签库
JSTL由五个不同功能的标签库组成。
功能范围 |
URI |
前缀 |
核心 |
http://java.sun.com/jsp/jstl/core |
c |
格式化 |
http://java.sun.com/jsp/jstl/fmt |
fmt |
函数 |
http://java.sun.com/jsp/jstl/functions |
fn |
数据库(不使用) |
http://java.sun.com/jsp/jstl/sql |
sql |
XML(不使用) |
http://java.sun.com/jsp/jstl/xml |
x |
核心标签(Core Tags)
Core标签库,包括了我们最常用的标签。
要使用Core标签库需要在JSP页面中加入:
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<c:out>
<c:out>用于计算一个表达式并将结果输出到当前页面。
功能类似于JSP表达式<%= >和EL表达式${}
可以设置的属性
value
作用:要输出的值
参数类型:Object
default
作用:当value为null时显示的默认值。
参数类型:Object
escaXml
作用:是否对特殊字符进行转义。
参数类型:boolean
例:<c:out value="http://www.mamicode.com/${user.name}" default="" escapeXml="true"></c:out>
<c:set>
<c:set>用于添加或修改域中的属性
可以设置的属性:
value
作用:要设置的值
参数类型:Objec
var
作用:表示域中存放的属性名。
参数类型:String
scope
作用:指定域(pageContext、request、session、application),若不指定则为pageContext
参数类型:String
target
作用:要修改的域对象的属性名(必须是JavaBean或者Map)
参数类型:Object
property
作用:指定要修改的对象的属性名
参数类型:String
例
设置属性:
<c:set var="key" http://www.mamicode.com/value="value" scope="request"></c:set>
修改属性:
<c:set property="name" target="${user}" value="http://www.mamicode.com/孙悟空"></c:set>
<c:remove>
<c:remove>用于移除域中的属性
可以设置的属性:
var
作用:设置要移除的属性的名字
类型:String
scope
作用:设置要移除属性所在的域,若不指定则删除所有域中的对应属性
参数类型:String
例:
移除所有域中key属性:<c:remove var="key"/>
移除request中的key属性: <c:remove var="key" scope="request"/>
<c:if>
<c:if>用于实现if语句的判断功能
可设置的属性
test
作用:设置if判断的条件,用于判断标签体是否被执行
参数类型:boolean
var
作用:用于指定接收判断结果的变量名
参数类型:boolean
scope
作用:指定判断结果保存到哪个域
参数类型:String
例:
<c:if test="${empty user }" var="isUserEmpty" scope="request"> 用户为空 </c:if>
<c:choose>、<c:when>、<c:otherwise>
<c:choose>、<c:when>、<c:otherwise>三个标签配合使用,功能类似于Java中的if/else
<c:choose>是<c:when>和<c:otherwise>的父标签
<c:when>的属性
test
作用:用于设置判断条件,若正确则c:when中的代码执行,否则不执行
参数类型:boolean
<c:otherwise>
作用:如果所有的<c:when>都没有执行则执行<c:otherwise>的标签体
例:
<c:forEach>
<c:choose> <c:when test="${param.age>=18 }"> 您已经成年 </c:when> <c:otherwise> 您未成年 </c:otherwise> </c:choose>
<c:forEach>用于对多个对象的集合进行迭代,重复执行标签体,或者重复迭代固定的次数。
可设置属性:
var
作用:设置遍历出对象的名称
参数类型:String
items
作用:指定要遍历的集合对象
参数类型:数组、字符串和各种集合
varStatus
作用:指定保存迭代状态的对象的名字,该变量引用的是一个LoopTagStatus类型的对象,通过该对象可以获得一些遍历的状态:
count
index
first
last
name
参数类型:String
begin
作用:指定遍历的开始位置
参数类型:int
end
作用:指定遍历的结束位置
参数类型:int
step
作用:迭代的步长
参数类型:int
例:
<c:forEach items="${list}" var="user" begin="0" end="4" step="2" varStatus="vs">
${vs.index} -- ${user.name } -- ${user.age }<br />
</c:forEach>
<c:url>
<c:url>主要用来重写URL地址
可设置的属性:
value
作用:设置要处理的URI地址,注意这里要以/开头
可接受参数:String
var
作用:修改后存储到域对象中的uri属性名。
可接受参数:String
scope
作用:设置修改后uri存放的域
可接受参数:String
例:
使用相对路径:
<c:url value="http://www.mamicode.com/index.jsp" var="uri" scope="request"> <c:param name="name" value="http://www.mamicode.com/张三"></c:param> </c:url>
会生成如下地址:index.jsp?name=%E5%BC%A0%E4%B8%89
使用绝对路径会自动在路径前加上项目名:
<c:url value="http://www.mamicode.com/index.jsp" var="uri" scope="request"> <c:param name="name" value="http://www.mamicode.com/张三"></c:param> </c:url>
会生成如下地址:/Test_JSTL/index.jsp?name=%E5%BC%A0%E4%B8%89
<c:redirect>
<c:redirect>主要用于将请求重定向到另一个资源地址
可设置的属性:
uri
作用:指定要重定向到的目标地址,注意这里指定绝对路径会自动加上项目名
参数类型:String
例:
<c:redirect url="/target.jsp"></c:redirect>
JSTL函数(JSTL Functions)
函数标签库是在JSTL中定义的标准的EL函数集。
函数标签库中定义的函数基本上都是对字符串的操作。
引入:
<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>
fn:contains和fn:containsIgnoreCase
作用:用于判断字符串中是否包含指定字符串,containsIgnoreCase忽略大小写。
语法:fn:contains(string,subString) à boolean
参数和返回值:
参数 |
类型 |
作用 |
string |
String |
源字符串 |
subString |
String |
要查找的字符串 |
返回值 |
boolean |
若string中包含subString则返回true,否则返回false |
例:
${fn:contains("hello","HE")} -->false
${fn:containsIgnoreCase("hello","HE")} --> true
fn:startsWith和fn:endsWith
作用:判断一个字符串是否以指定字符开头(startsWith)或结尾(endsWith)
语法:fn:startsWith(string , prefix) à boolean
fn:endsWith(string,suffix) à boolean
参数和返回值:
参数 |
类型 |
作用 |
string |
String |
源字符串 |
prefix 或 suffix |
String |
要查找的前缀或后缀字符串 |
返回值 |
boolean |
符合要求返回true,否则返回false |
例:${fn:startsWith("hello","he") } -->true
${fn:endsWith("hello","he") } --> false
fn:indexOf
作用:在一个字符串中查找指定字符串,并返回第一个符合的字符串的第一个字符的索引。
语法:fn:indexOf(string,subString) à int
参数和返回值:
参数 |
类型 |
作用 |
string |
String |
源字符串 |
subString |
String |
要查找的字符串 |
返回值 |
int |
若在string中找到subString则返回第一个符合的索引,若没有符合的则返回-1 |
例:${fn:indexOf("hello",‘e‘) } -->1
fn:replace
作用:将一个字符串替换为另外一个字符串,并返回替换结果
语法:fn:replace(str , beforeSubString , afterSubString) à String
参数和返回值:
参数 |
类型 |
作用 |
str |
String |
源字符串 |
beforeSubString |
String |
被替换的字符串 |
afterSubString |
String |
要替换的新字符串 |
返回值 |
String |
替换后的字符串 |
例:${fn:replace("hello","llo",‘e‘) } -->hee
fn:substring
作用:截取字符串
语法:fn: substring (str , beginIndex , endIndex) à String
参数和返回值:
参数 |
类型 |
作用 |
str |
String |
源字符串 |
beginIndex |
int |
开始位置索引(包含该位置) |
endIndex |
int |
结束位置索引(不包含自身) |
返回值 |
String |
返回截取的字符串 |
例:${fn:substring("hello",1,3) } -->el
fn:substringBefore和fn:substringAfter
作用:返回一个字符串指定子串之前(substringBefore)之后(substringAfter)的字符串
语法:fn: substringBefore(string,subString) à String
fn: substringAfter (string,subString) -->String
参数和返回值:
参数 |
类型 |
作用 |
str |
String |
源字符串 |
subString |
int |
指定str中的一个子串,该串之前或之后的字符串将被返回。 |
返回值 |
String |
返回截取的字符串 |
例: ${fn:substringBefore("hello","l") }--> he
${fn:substringAfter("hello","l") } --> lo
fn:split
作用:将一个字符串拆分成字符串数组。
语法:fn:split(string,delimiters) -->String
参数和返回值:
参数 |
类型 |
作用 |
str |
String |
要被拆分的字符串 |
delimiters |
String |
指定根据什么内容拆分字符串 |
返回值 |
String[] |
返回拆分后的字符串数组 |
例:${fn:split("a-b-c-d-e-f-g","-")} à 返回一个数组对象[a,b,c,d,e,f,g]
fn:join
作用:将数组中所有元素连接成一个字符串
语法:fn:join(array,sparator) à String
参数和返回值:
参数 |
类型 |
作用 |
str |
String |
要被拆分的字符串 |
sparator |
String |
在结果中每个元素之间的分隔符 |
返回值 |
String[] |
拼接之后的结果 |
例:
<% String[] strs = new String[]{"a","b","c","d","e","f"}; pageContext.setAttribute("strs", strs); %> ${fn:join(strs,‘-‘) } |
返回:a-b-c-d-e-f
fn:toLowerCase和fn:toUpperCase
作用:将字符串都转换成大写(toUpperCase)或小写(toLowerCase)字符
语法:
fn: toLowerCase (str) --> String
fn: toUpperCase(str) -->String
参数和返回值:
参数 |
类型 |
作用 |
str |
String |
源字符串 |
返回值 |
String |
转换为大写或小写的字符串 |
例: ${fn:toLowerCase("ABCDEFG") } -->abcdefg
${fn:toUpperCase("abcdefg") } -->ABCDEFG
fn:trim
作用:去掉字符串的前后空格
用法:fn:trim(str) à String
参数和返回值:
参数 |
类型 |
作用 |
str |
String |
源字符串 |
返回值 |
String |
去掉前后空格的结果 |
例:${fn:trim(" hello ") } --> hello
fn:length
作用:返回集合或者字符串的长度
用法:fn:trim(input) à int
参数和返回值:
参数 |
类型 |
作用 |
input |
String、集合、数组 |
要计算长度的目标 |
返回值 |
int |
集合或字符串的长度 |
例:${fn:length("hello") }--> 5
JSTL