什么是JSTL
- STL是apache对EL表达式的扩展(也就是说JSTL依赖EL),JSTL是标签语言!JSTL标签使用以来非常方便,它与JSP动作标签一样,只不过它不是JSP内置的标签,需要我们自己导包,以及指定标签库而已!
- 如果你使用MyEclipse开发JavaWeb,那么在把项目发布到Tomcat时,你会发现,MyEclipse会在lib目录下存放jstl的Jar包!如果你没有使用MyEclipse开发那么需要自己来导入这个JSTL的Jar包:下载jstl-1.2.jar。
JSTL标签库
JSTL一共包含四大标签库:
core:核心标签库,我们学习的重点;
fmt:格式化标签库,只需要学习两个标签即可;
sql:数据库标签库,不需要学习了,它过时了;
xml:xml标签库,不需要学习了,它过时了。
使用taglib指令导入标签库
除了JSP动作标签外,使用其他第三方的标签库都需要:
- 导包;
- 在使用标签的JSP页面中使用taglib指令导入标签库;
下面是导入JSTL的core标签库:
<%@ taglib prefix="c" uri="http://java.sun.com/jstl/core" %>
- prefix= “c”:指定标签库的前缀,这个前缀可以随便给值,但大家都会在使用core标签库时指定前缀为c;
- uri= “http://java.sun.com/jstl/core“:指定标签库的uri,它不一定是真实存在的网址,但它可以让JSP找到标签库的描述文件;
core标签库常用标签
1、out和set
out
out标签中escapeXml默认的属性值为true也是就是,也就是说不用写escapeXml也可以自动转义”<”,”>”等符号。
set标签中不写scope时,默认在page域也就是pageContext域中添加数据。
2.remove
3.url
当url要保存变量到域中时,域有以下几个page,request,session,application
4.if
if标签的test属性必须是一个boolean类型的值,如果test的值为true,那么执行if标签的内容,否则不执行。
<c:set var="a" value="hello"/> //在page域中创建名为a的变量
<c:if test="${not empty a }">//判断a变量不为null,没有指定域,表示全域查找
<c:out value="${a }"/>
</c:if>
5.choose
choose标签对应Java中的if/else if/else结构。when标签的test为true时,会执行这个when的内容。当所有when标签的test都为false时,才会执行otherwise标签的内容。
<c:set var="score" value="${param.score }"/>
<c:choose>
//第一个when相当于if,剩下的when相当于else if,最后的otherwise相当于else
<c:when test="${score > 100 || score < 0}">错误的分数:${score }</c:when>
<c:when test="${score >= 90 }">A级</c:when>
<c:when test="${score >= 80 }">B级</c:when>
<c:when test="${score >= 70 }">C级</c:when>
<c:when test="${score >= 60 }">D级</c:when>
<c:otherwise>E级</c:otherwise>
</c:choose>
6.forEach
forEach是循环标签,forEach标签有多种两种使用方式:
- 使用循环变量,指定开始和结束值,类似for(int i = 1; i <= 10; i++) {};
- 循环遍历集合,类似for(Object o : 集合);
循环变量方式:
1.
<c:set var="sum" value="0" />
<c:forEach var="i" begin="1" end="10">
<c:set var="sum" value="${sum + i}" />
</c:forEach>
<c:out value="sum = ${sum }"/>
2.
<c:set var="sum" value="0" />
<c:forEach var="i" begin="1" end="10" step ="2">
<c:set var="sum" value="${sum + i}" />
</c:forEach>
<c:out value="sum = ${sum }"/>
遍历集合或数组方式:
<%
String[] names = {"zhangSan", "liSi", "wangWu", "zhaoLiu"};
pageContext.setAttribute("ns", names);
%>
<c:forEach var="item " items="${ns } ">
<c:out value="name: ${item } "/><br/>//item这个数据是保存在pageScope里面的。
</c:forEach>
遍历List
<%
List<String> names = new ArrayList<String>();
names.add("zhangSan");
names.add("liSi");
names.add("wangWu");
names.add("zhaoLiu");
pageContext.setAttribute("ns", names);
%>
<c:forEach var="item" items="${ns }"> //item这个数据是保存在pageScope里面的。
<c:out value="name: ${item }"/><br/>//与遍历数组没有区别!
</c:forEach>
遍历Map
<%
Map<String,String> stu = new LinkedHashMap<String,String>();
stu.put("number", "N_1001");
stu.put("name", "zhangSan");
stu.put("age", "23");
stu.put("sex", "male");
pageContext.setAttribute("stu", stu);
%>
<c:forEach var="item " items="${stu }">//因为遍历的是Map,所以每一项是Entry类型
<c:out value="${item.key }: ${item.value } "/><br/>//获取Entry的key和value
</c:forEach>
forEach标签还有一个属性:varStatus,这个属性用来指定接收“循环状态”的变量名,例如:<forEach varStatus=”vs” …/>,这时就可以使用vs这个变量来获取循环的状态了。
- count:int类型,当前以遍历元素的个数,也可以理解为第几次循环。;
- index:int类型,当前元素的下标;
- first:boolean类型,是否为第一个元素;
- last:boolean类型,是否为最后一个元素;
- current:Object类型,表示当前遍历的元素。
<c:forEach var="item" items="${ns }" varStatus="vs" >//把循环状态赋给vs
<c:if test="${vs.first } ">第一行:</c:if>//如果是第一行,那么${vs.first}为true
<c:if test="${vs.last } ">最后一行:</c:if>//如果是最后一行,那么${vs.last}为true
<c:out value="第${vs.count } 行: "/>//返回行数,从1开始,也可以叫做第几层循环
<c:out value="[${vs.index } ]: "/>//返回下标,从0开始
<c:out value="name: ${vs.current } "/><br/>//当前项,与${item}相同
</c:forEach>
//vs这个数据是保存在pageScope里面的。
fmt标签库常用标签
fmt标签库是用来格式化输出的,通常需要格式化的有时间和数字。
格式化时间:
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
......
<%
Date date = new Date();
pageContext.setAttribute("d", date);
%>
<fmt:formatDate value="${d }" pattern="yyyy-MM-dd HH:mm:ss "/>//value的传入值必须为Date对象。
格式化数字:
<%
double d1 = 3.5;
double d2 = 4.4;
pageContext.setAttribute("d1", d1);
pageContext.setAttribute("d2", d2);
%>
<fmt:formatNumber value="${d1 }" pattern="0.00 "/><br/>//必须且仅能保留两位小数,如果大于两位,那么只保留两位,并四舍五入,如果小于两位,那么使用0补足两位。
<fmt:formatNumber value="${d2 }" pattern="#.## "/>//最多显示两位,如果小于两位,那么有几位保留几位,不会用0补足。大于两位,只保留两位,并四舍五入!
自定义标签
1、自定义标签的步骤
其实我们在JSP页面中使用标签就等于调用某个对象的某个方法一样,例如:<c:if test=””>,这就是在调用对象的方法一样。自定义标签其实就是自定义类一样!
- 定义标签处理类:必须是Tag或SimpleTag的实现类;
- 编写标签库描述符文件(TLD);
SimpleTag接口是JSP2.0中新给出的接口,用来简化自定义标签,所以现在我们基本上都是使用SimpleTag。
Tag是老的,传统的自定义标签时使用的接口,现在不建议使用它了。
2、SimpleTag接口介绍
SimpleTag接口内容如下:
- void doTag():标签执行方法;
- JspTag getParent():获取父标签;
- void setParent(JspTag parent):设置父标签
- void setJspContext(JspContext context):设置PageContext
- void setJspBody(JspFragment jspBody):设置标签体对象;
请记住,万物皆对象!在JSP页面中的标签也是对象!你可以通过查看JSP的“真身”清楚的知道,所有标签都会变成对象的方法调用。标签对应的类我们称之为“标签处理类”!
标签的生命周期:
- 当容器(Tomcat)第一次执行到某个标签时,会创建标签处理类的实例;
- 然后调用setJspContext(JspContext)方法,把当前JSP页面的pageContext对象传递给这个方法;
- 如果当前标签有父标签,那么使用父标签的标签处理类对象调用setParent(JspTag)方法;
- 如果标签有标签体,那么把标签体转换成JspFragment对象,然后调用setJspBody()方法;
- 每次执行标签时,都调用doTag()方法,它是标签处理方法。
所以getParent()方法就不是生命周期方法。服务器也不会调用,只会在doTag()方法之前调用相关的set方法。如setJspContext(),setJspBody(),setParent(),setxxx属性(xxx属性为标签中的属性)等。
public class HelloTag implements SimpleTag {
private JspTag parent;//跟父标签有关
private PageContext pageContext;//父类传进来的本质就是PageContext,但Tomcat把它用的JspContext接收的。
private JspFragment jspBody;//跟运行EL表达式,子标签又有关,和普通字符串也有关。想要执行标签体,直接jspBody.invoke(输出流);就行了!(EL,字符串会被执行,执行子标签还不知道,没学过。)
public void doTag() throws JspException, IOException {
pageContext.getOut().print("Hello Tag!!!");
}
public void setParent(JspTag parent) {
this.parent = parent;
}
public JspTag getParent() {
return this.parent;
}
public void setJspContext(JspContext pc) {
this.pageContext = (PageContext) pc;//这里作了强转的
}
public void setJspBody(JspFragment jspBody) {
this.jspBody = jspBody;
}
}
3、标签库描述文件(TLD)
标签库描述文件是用来描述当前标签库中的标签的!标签库描述文件的扩展名为tld,你可以把它放到WEB-INF下,这样就不会被客户端直接访问到了。
<?xml version="1.0" encoding="UTF-8"?>
<taglib version="2.0" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xml="http://www.w3.org/XML/1998/namespace"
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 ">
<tlib-version>1.0</tlib-version> //指定当前标签库的版本
<short-name>itcast</short-name> //指定当前标签库的简称,这个名称无所谓了,随便起。
<uri>http://www.itcast.cn/tags</uri> //指定标签库的uri
<tag> //部署一个标签!一个<tag>表示一个标签。
<name>hello</name> //指定标签的名称
<tag-class>tag.HelloTag</tag-class> //指定标签处理类
<body-content>empty</body-content> //指定标签体内容类型为空类型,即没有标签体。
</tag>
</taglib>
4、使用标签
在页面中使用标签分为两步:
- 使用taglib导入标签库;
- 使用标签;
<%@ taglib prefix="it" uri="/WEB-INF/hello.tld" %>
......
<it:hello/>
自定义标签进阶
继承SimpleTagSupport
继承SimpleTagSuppport要比实现SimpleTag接口方便太多了,现在你只需要重写doTag()方法,其他方法都已经被SimpleTagSuppport完成了。
public class HelloTag extends SimpleTagSupport {
public void doTag() throws JspException, IOException {
//注意下面的输出是用的父类获取输出流的,即pageContext的getOut()就是用的它父类的。
this.getJspContext().getOut().write("<p>Hello SimpleTag!</p>") ;//向页面输出!注意,不能向页面输出<%%>东西!
}
}
有标签体的标签
我们先来看看标签体内容的可选值:
<body-content>元素的可选值有:
- empty:无标签体。
- JSP:传统标签支持它,SimpleTag已经不再支持使用<body-content>JSP</body-content>。标签体内容可以是任何东西:EL、JSTL、<%=%>、<%%>,以及html;
- scriptless:标签体内容不能是Java脚本,但可以是EL、JSTL(也就是动态标签,我们现在写的就是动态标签,html标签不是动态标签),字符串,html等(html也可以被当做字符串)。在SimpleTag中,如果需要有标签体,那么就使用该选项;
- tagdependent:标签体内容不做运算,由标签处理类自行处理,无论标签体内容是EL、JSP、JSTL,都不会做运算。这个选项几乎没有人会使用!
自定义有标签体的标签需要:
- 获取标签体对象:JspFragment jspBody = getJspBody();;
- 把标签体执行内容结果输出到页面:jspBody.invoke(null);
- tld中指定标签内容类型:scriptless。
标签处理类:
public class HelloTag extends SimpleTagSupport {
public void doTag() throws JspException, IOException {
PageContext pc = (PageContext) this.getJspContext();
HttpServletRequest req = (HttpServletRequest) pc.getRequest();
String s = req.getParameter("exec");
if(s != null && s.endsWith("true")) {
JspFragment body = this.getJspBody() ;//获取当前标签的标签体对象
body.invoke (null);//向页面输出标签体内容。当参数为null时,默认输出到浏览器,当然也可以写getJspContext().getOut()获取的对象传进去。
}
}
}
tld进行的配置:
<tag>
<name>hello</name>
<tag-class>tags.HelloTag</tag-class>
<body-content>scriptless</body-content> //指定标签体内容为scriptless,即标签体内容可以是正常的html,也可以是EL或JSTL,或者字符串。
</tag>
<itcast:hello>
<h1>哈哈哈~</h1>
</itcast:hello>
不执行标签下面的页面内容
如果希望在执行了自定义标签后,不再执行JSP页面下面的东西,那么就需要在doTag()方法中使用SkipPageException。(Skip的意思是“忽略”)
标签处理类:
public class SkipTag extends SimpleTagSupport {
public void doTag() throws JspException, IOException {
this.getJspContext().getOut().print("<h1>只能看到我!</h1>");
throw new SkipPageException();
}
}
tld中的配置:
<tag>
<name>skip</name>
<tag-class>tags.SkipTag</tag-class>
<body-content>empty</body-content>
</tag>
JSP页面使用(必须在页面用taglib指令导入tld后才可以使用):
<itcast:skip/>
<h1>看不见我!</h1>
其实这种不执行标签下面的页面内容的本质是,在jsp被翻译成servlet文件之后,它会被一个try-catch包含住,而且catch里面有专门处理这个SkipPageException异常,所以当抛出这个异常后,catch就会捕获住,这样也就不会在执行下面的内容了。
带有属性的标签
一般标签都会带有属性,例如<c:if test=””>,其中test就是一个boolean类型的属性。完成带有属性的标签需要:
- 在处理类中给出JavaBean属性(提供get/set方法);然而我们一般只会使用set方法,而不会使用get方法,我们只关心数据传进来后,直接使用,而不在外界取出来。所以一般我们只写set方法。而set方法不是我们调用,而是服务器Tomcat自己调用,而且在doTag()方法前,自己调用。
- 在TLD中配置相关属性。
标签处理类:
public class IfTag extends SimpleTagSupport {
private boolean test;
public boolean isTest() {//这个方法一般不写。写了也没多大用。
return test;
}
public void setTest (boolean test) {//该方法会在doTag()之前被调用,传入属性值。
this.test = test;
}
@Override
public void doTag() throws JspException, IOException {
if(test) {//如果test为true,执行标签体内容,否则什么都不做。
this.getJspBody().invoke(null);
}
}
}
tld中的配置:
<tag>
<name>if</name>
<tag-class>tag.IfTag</tag-class>
<body-content>scriptless</body-content>
<attribute> //声明属性
<name>test</name> //属性名称为test
<required>true</required> //为true表示属性是必须的,为false表示属性为可选的。
<rtexprvalue>true</rtexprvalue> //为true表示属性值可以为EL或JSTL,否则表示只能是常量(true,false,如果为常量那就没意思了。即if(true)。。。)。
</attribute>
</tag>
使用:
<%
pageContext.setAttribute("one", true);
pageContext.setAttribute("two", false);
%>
<it:if test="${one }">xixi</it:if> //可以看到xixi
<it:if test="${two }">haha</it:if> //不会执行haha
<it:if test="true">hehe</it:if> //可以看到hehe