Taglib 伪指令
输出<c:out>
语法:
说明:
该标记对由其 value 属性指定的表达式进行求值,然后打印结果。如果指定了可选属性 default,那么,在对 value 属性的表达式求值所得结果为 null 或空 String 的情况下,<c:out> 将打印其值。
escapeXml 属性也是可选的。它控制当用 <c:out> 标记输出诸如“<”、“>”和“&”之类的字符(在 HTML 和 XML 中具有特殊意义)时是否应该进行转义。如果将 escapeXml 设置为 true,则会自动将这些字符转换成相应的 XML 实体(此处提到的字符分别转换成 <、> 和 &)。
例:
赋值<c:set>
语法:
说明:
<c:set> 操作提供基于标记的机制来创建和设置限制了作用域的变量。其中 var 属性指定了限制了作用域的变量的名称,scope 属性表明了该变量驻留在哪个作用域中,value 属性指定了分配给该变量的值。如果指定变量已经存在,则简单地将所指明的值赋给它。如果不存在,则创建新的限制了作用域的变量,并用该值初始化这个变量。
scope 属性是可选的,其缺省值是 page。
例:
循环
语法:
说明:
begin 和 end 属性要么是静态整数值,要么是可以得出整数值的表达式。它们分别指定迭代索引的初始值以及迭代索引的终止值。当使用 <c:forEach> 在整数范围内进行迭代时,这两个属性是必需的,而其它所有属性都是可选的。
当出现 step 时,它也必须是整数值。它指定每次迭代后索引的增量。
如果指定了 var 属性,那么将会创建一个带有指定名称的并限定了作用域的变量,并将每次迭代的当前索引值赋给该变量。
items 属性的值应该是一个集合,对该集合的成员进行迭代,通常使用 EL 表达式指定值。
和 var 属性一样, varStatus 用于创建限定了作用域的变量。不过,由 varStatus 属性命名的变量并不存储当前索引值或当前元素,而是赋予 javax.servlet.jsp.jstl.core.LoopTagStatus 类的实例。
例:
If判断
语法:
说明:
测试表达式(test属性值)进行求值,接下来,仅当对表达式求出的值为 true 时,它才处理标记的主体内容
<c:if> 通过其 var 和 scope 属性(它们所起的作用和在 <c:set> 中所起的作用一样)选择将测试结果赋给限定了作用域的变量。
例:
Choose操作语法
语法:
说明:
每个要测试的条件都由相应的 <c:when> 标记来表示,至少要有一个 <c:when> 标记。只会处理第一个其 test 值为 true 的 <c:when> 标记体内的内容。如果没有一个 <c:when> 测试返回 true ,那么会处理 <c:otherwise> 标记的主体内容。
例:
<c:url> 操作的语法
语法:
说明:
<c:url> 标记,用于生成 URL。
value 属性用来指定基本 URL,然后在必要时标记对其进行转换。如果这个基本 URL 以一个斜杠开始,那么会在它前面加上 servlet 的上下文名称。可以使用 context 属性提供显式的上下文名称。如果省略该属性,那么就使用当前 servlet 上下文的名称。这一点特别有用,因为 servlet 上下文名称是在部署期间而不是开发期间决定的。(如果这个基本 URL 不是以斜杠开始的,那么就认为它是一个相对 URL,这时就不必添加上下文名称。)
如果通过嵌套 <c:param> 标记指定了任何请求参数,那么将会使用 HTTP GET 请求的标准表示法将它们的名称和值添加到生成的 URL 后面。此外,还进行 URL 编码:为了生成有效的 URL,将对这些参数的名称或值中出现的任何字符适当地进行转换。
例:
<c:redirect> 操作的语法
语法:
说明:
<c:redirect>用于向用户的浏览器发送 HTTP 重定向响应,它是 JSTL 中与 javax.servlet.http.HttpServletResponse 的 sendRedirect() 方法功能相当的标记。
例:
- <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
- <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>
- <%@ taglib uri="http://java.sun.com/jsp/jstl/functions" prefix="fn" %>
输出<c:out>
语法:
- <c:out value="expression" default="expression" escapeXml="boolean"/>
该标记对由其 value 属性指定的表达式进行求值,然后打印结果。如果指定了可选属性 default,那么,在对 value 属性的表达式求值所得结果为 null 或空 String 的情况下,<c:out> 将打印其值。
escapeXml 属性也是可选的。它控制当用 <c:out> 标记输出诸如“<”、“>”和“&”之类的字符(在 HTML 和 XML 中具有特殊意义)时是否应该进行转义。如果将 escapeXml 设置为 true,则会自动将这些字符转换成相应的 XML 实体(此处提到的字符分别转换成 <、> 和 &)。
例:
- <c:out value="${user.company}" escapeXml=="false"/>
赋值<c:set>
语法:
- <c:set var="name" scope="scope" value="expression"/>
<c:set> 操作提供基于标记的机制来创建和设置限制了作用域的变量。其中 var 属性指定了限制了作用域的变量的名称,scope 属性表明了该变量驻留在哪个作用域中,value 属性指定了分配给该变量的值。如果指定变量已经存在,则简单地将所指明的值赋给它。如果不存在,则创建新的限制了作用域的变量,并用该值初始化这个变量。
scope 属性是可选的,其缺省值是 page。
例:
- <c:set var="timezone" scope="session" value="CST"/>
- <c:set var="square" value="${param['x'] * param['x']}"/>
循环
语法:
- <c:forEach var="name" items="expression"
- varStatus="name" begin="expression"
- end="expression" step="expression">
- body content
- </c:forEach>
begin 和 end 属性要么是静态整数值,要么是可以得出整数值的表达式。它们分别指定迭代索引的初始值以及迭代索引的终止值。当使用 <c:forEach> 在整数范围内进行迭代时,这两个属性是必需的,而其它所有属性都是可选的。
当出现 step 时,它也必须是整数值。它指定每次迭代后索引的增量。
如果指定了 var 属性,那么将会创建一个带有指定名称的并限定了作用域的变量,并将每次迭代的当前索引值赋给该变量。
items 属性的值应该是一个集合,对该集合的成员进行迭代,通常使用 EL 表达式指定值。
和 var 属性一样, varStatus 用于创建限定了作用域的变量。不过,由 varStatus 属性命名的变量并不存储当前索引值或当前元素,而是赋予 javax.servlet.jsp.jstl.core.LoopTagStatus 类的实例。
例:
- <table>
- <c:forEach items=
- "${entryList}" var="blogEntry" varStatus="status">
- <tr><td align="left" class="blogTitle">
- <c:out value="${status.count}"/>.
- <c:out value="${blogEntry.title}" escapeXml="false"/>
- </td></tr>
- <tr><td align="left" class="blogText">
- <c:out value="${blogEntry.text}" escapeXml="false"/>
- </td></tr>
- </c:forEach>
- </table>
If判断
语法:
- <c:if test="expression" var="name" scope="scope">
- body content
- </c:if>
测试表达式(test属性值)进行求值,接下来,仅当对表达式求出的值为 true 时,它才处理标记的主体内容
<c:if> 通过其 var 和 scope 属性(它们所起的作用和在 <c:set> 中所起的作用一样)选择将测试结果赋给限定了作用域的变量。
例:
- <table>
- <c:forEach items=
- "${entryList}" var="blogEntry" varStatus="status">
- <c:if test="${status.first}">
- <tr><td align="left" class="blogDate">
- <c:out value="${blogEntry.created}"/>
- </td></tr>
- </c:if>
- <tr><td align="left" class="blogTitle">
- <c:out value="${blogEntry.title}" escapeXml="false"/>
- </td></tr>
- <tr><td align="left" class="blogText">
- <c:out value="${blogEntry.text}" escapeXml="false"/>
- </td></tr>
- </c:forEach>
- </table>
Choose操作语法
语法:
- <c:choose>
- <c:when test="expression">
- body content
- </c:when>
- ...
- <c:otherwise>
- body content
- </c:otherwise>
- </c:choose>
每个要测试的条件都由相应的 <c:when> 标记来表示,至少要有一个 <c:when> 标记。只会处理第一个其 test 值为 true 的 <c:when> 标记体内的内容。如果没有一个 <c:when> 测试返回 true ,那么会处理 <c:otherwise> 标记的主体内容。
例:
- <c:choose>
- <c:when test="${pageContext.request.scheme eq 'http'}">
- This is an insecure Web session.
- </c:when>
- <c:when test="${pageContext.request.scheme eq 'https'}">
- This is a secure Web session.
- </c:when>
- <c:otherwise>
- You are using an unrecognized Web protocol. How did this happen?!
- </c:otherwise>
- </c:choose>
<c:url> 操作的语法
语法:
- <c:url value="expression" context="expression" var="name" scope="scope">
- <c:param name="expression" value="expression"/>
- ...
- </c:url>
<c:url> 标记,用于生成 URL。
value 属性用来指定基本 URL,然后在必要时标记对其进行转换。如果这个基本 URL 以一个斜杠开始,那么会在它前面加上 servlet 的上下文名称。可以使用 context 属性提供显式的上下文名称。如果省略该属性,那么就使用当前 servlet 上下文的名称。这一点特别有用,因为 servlet 上下文名称是在部署期间而不是开发期间决定的。(如果这个基本 URL 不是以斜杠开始的,那么就认为它是一个相对 URL,这时就不必添加上下文名称。)
如果通过嵌套 <c:param> 标记指定了任何请求参数,那么将会使用 HTTP GET 请求的标准表示法将它们的名称和值添加到生成的 URL 后面。此外,还进行 URL 编码:为了生成有效的 URL,将对这些参数的名称或值中出现的任何字符适当地进行转换。
例:
- <a href="<c:url value='/content/sitemap.jsp'/>">View sitemap</a>
- <c:url value="/content/search.jsp">
- <c:param name="keyword" value="${searchTerm}"/>
- <c:param name="month" value="02/2003"/>
- </c:url>
<c:redirect> 操作的语法
语法:
- <c:redirect url="expression" context="expression">
- <c:param name="expression" value="expression"/>
- ...
- </c:redirect>
<c:redirect>用于向用户的浏览器发送 HTTP 重定向响应,它是 JSTL 中与 javax.servlet.http.HttpServletResponse 的 sendRedirect() 方法功能相当的标记。
例:
- <c:catch var="exception">
- <c:import url="ftp://ftp.example.com/package/README"/>
- </c:catch>
- <c:if test="${not empty exception}">
- <c:redirect url="/errors/remote.jsp"/>
- </c:if>