标签:uppercase return library 使用方法 span turn txt attribute ges
原理:用户自定义的 jsp 标记。当一个含有自定义标签的 jsp 页面被 jsp 引擎编译成 servlet 时,tag 标签被转化成了对一个标签处理器类的对象的操作。
标签库API:定义在 javax.servlet.jsp.tagext 中
1)setJspContext:Jsp 引擎将代表 JSP 页面的 pageContext 对象传递给标签处理器对象
2)setParent:Jsp 引擎将父标签处理器对象传递给当前标签处理器对象。只有存在父标签时,Jsp 引擎才会调用才方法
3)setXxx:设置标签属性。只有定义属性才调用该方法。
4)setJspBody:若存在标签体,Jsp 引擎将把标签体封装成一个 JspFragment 对象,调用 setJspBody 方法将 JSPFragment 对象传递给标签处理器对象。若标签体为空,这 setJspBody 将不会被 Jsp 引擎调用。
5)doTag:容器调用标签处理器对象的 doTag 方法执行标签逻辑
HelloSimpleTag(实现SimpleTag接口):把 value 输出 count 遍
public class HelloSimpleTag implements SimpleTag { private String value; private String count; public void setValue(String value) { this.value = value; } public void setCount(String count) { this.count = count; } //标签体逻辑实际应该编写到该方法中. @Override public void doTag() throws JspException, IOException { // System.out.println("value: " + value + ", count: " + count); // // HttpServletRequest request = (HttpServletRequest) pageContext.getRequest(); // pageContext.getOut().print("Hello: " + request.getParameter("name")); JspWriter out = pageContext.getOut(); int c = 0; c = Integer.parseInt(count); for(int i = 0; i < c; i++){ out.print((i + 1) + ": " + value); out.print("<br>"); } } @Override public JspTag getParent() { System.out.println("getParent"); return null; } @Override public void setJspBody(JspFragment arg0) { System.out.println("setJspBody"); } private PageContext pageContext; //JSP 引擎调用, 把代表 JSP 页面的 PageContext 对象传入 //PageContext 可以获取 JSP 页面的其他 8 个隐含对象. //所以凡是 JSP 页面可以做的标签处理器都可以完成. @Override public void setJspContext(JspContext arg0) { System.out.println(arg0 instanceof PageContext); this.pageContext = (PageContext) arg0; } @Override public void setParent(JspTag arg0) { System.out.println("setParent"); } }
ReadFileTag(继承SimpleTagSupport类):给一个文本路径,输出该文本里的内容
public class ReadFileTag extends SimpleTagSupport{ //相对于当前 WEB 应用的根路径的文件名 private String src; public void setSrc(String src) { this.src = src; } @Override public void doTag() throws JspException, IOException { PageContext pageContext = (PageContext) getJspContext(); InputStream in = pageContext.getServletContext().getResourceAsStream(src); BufferedReader reader = new BufferedReader(new InputStreamReader(in)); String str = null; while((str = reader.readLine()) != null){ str = Pattern.compile("<").matcher(str).replaceAll("<"); str = Pattern.compile(">").matcher(str).replaceAll(">"); pageContext.getOut().println(str); pageContext.getOut().println("<br>"); } } }
<?xml version="1.0" encoding="UTF-8" ?> <taglib xmlns="http://java.sun.com/xml/ns/j2ee" 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" version="2.0"> <!-- 描述 TLD 文件 --> <description>MyTag 1.0 core library</description> <display-name>MyTag core</display-name> <tlib-version>1.0</tlib-version> <!-- 建议在 JSP 页面上使用的标签的前缀 --> <short-name>mytag</short-name> <!-- 作为 tld 文件的 id, 用来唯一标识当前的 TLD 文件, 多个 tld 文件的 URI 不能重复. 通过 JSP 页面的 taglib 标签的 uri 属性来引用. --> <uri>http://www.xxx.com/mytag/core</uri> <!-- 描述自定义的 HelloSimpleTag 标签 --> <tag> <!-- 标签的名字: 在 JSP 页面上使用标签时的名字 --> <name>hello</name> <!-- 标签所在的全类名 --> <tag-class>com.zhang.javaweb.tag.HelloSimpleTag</tag-class> <!-- 标签体的类型 --> <body-content>empty</body-content> <!-- 描述当前标签的属性 --> <attribute> <!-- 属性名 --> <name>value</name> <!-- 该属性是否被必须 --> <required>true</required> <!-- rtexprvalue: runtime expression value 当前属性是否可以接受运行时表达式的动态值 --> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <name>count</name> <required>false</required> <rtexprvalue>false</rtexprvalue> </attribute> </tag>
<tag> <name>readerFile</name> <tag-class>com.zhang.javaweb.tag.ReadFileTag</tag-class> <body-content>empty</body-content> <attribute> <name>src</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> </tag> </taglib>
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!-- 导入标签库(描述文件) --> <%@taglib uri="http://www.xxx.com/mytag/core" prefix="mytag" %> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <mytag:readerFile src="/WEB-INF/note.txt" />
<!-- count不能接收运行时表达式的值,所以不能用el表达式 --> <mytag:hello value="${param.name }" count="10" /> </body> </html>
1). 若一个标签有标签体
<mytag:testJspFragment>abcdefg</mytag:testJspFragment>
在自定义标签的标签处理器中使用 JspFragment 对象封装标签体信息。
2). 若配置了标签含有标签体
则 JSP 引擎会调用 setJspBody() 方法把 JspFragment 传递给标签处理器类
在 SimpleTagSupport 中还定义了一个 getJspBody() 方法, 用于返回 JspFragment 对象。
3). JspFragment 的 invoke(Writer) 方法
把标签体内容从 Writer 中输出,若为 null,
则等同于 invoke(getJspContext().getOut()), 即直接把标签体内容输出到页面上。
有时, 可以 借助于 StringWriter, 可以在标签处理器类中先得到标签体的内容:
//1. 利用 StringWriter 得到标签体的内容.
StringWriter sw = new StringWriter();
bodyContent.invoke(sw);
//2. 把标签体的内容都变为大写
String content = sw.toString().toUpperCase();
4). 在 tld 文件中, 使用 body-content 节点来描述标签体的类型
<body-content>: 指定标签体的类型,大部分情况下, 取值为 scriptless。可能取值有 3 种:
<body-content>tagdependent</body-content>
5). 定义一个自定义标签
<mytag:printUpper time="10">abcdefg</mytag> 把标签体内容转换为大写, 并输出 time 次到浏览器上。
6). 实现 forEach 标签
> 两个属性: items(集合类型, Collection),var(String 类型)
> doTag:
* 遍历 items 对应的集合
* 把正在遍历的对象放入到 pageContext 中,键: var,值: 正在遍历的对象.
* 把标签体的内容直接输出到页面上。
<c:forEach items="${requestScope.customers }" var="cust2">
${pageScope.cust2.id } -- ${cust2.name } <br>
</c:forEach>
@Override public void doTag() throws JspException, IOException { //1. 得到父标签的引用 JspTag parent = getParent(); //2. 获取父标签的 name 属性 ParentTag parentTag = (ParentTag) parent; String name = parentTag.getName(); //3. 把 name 值打印到 JSP 页面上. getJspContext().getOut().print("子标签输出name: " + name); }
1). 父标签无法获取子标签的引用
父标签仅把子标签作为标签体来使用
2). 子标签可以通过 getParent() 方法来获取父标签的引用(需继承 SimpleTagSupport 或自实现 SimpleTag 接口的该方法)
若子标签的确有父标签,JSP 引擎会把代表父标签的引用通过 setParent(JspTag parent) 赋给标签处理器
3). 父标签的类型是 JspTag 类型
该接口是一个空接口,但是来统一 SimpleTag 和 Tag 的。实际使用需要进行类型的强制转换。
4). 父标签的 <body-content></body-content>需设置为 scriptless
在 tld 配置文件中,无需为父标签有额外的配置。但,子标签是是以标签体的形式存在的,所以父标签的 <body-content></body-content>需设置为 scriptless。
5). 实现
<c:choose>
<c:when test="${param.age > 24}">大学毕业</c:when>
<c:when test="${param.age > 20}">高中毕业</c:when>
<c:otherwise>高中以下...</c:otherwise>
</c:choose>
> 开发 3 个标签: choose,when,otherwise
> 其中 when 标签有一个 boolean 类型的属性: test
> choose 是 when 和 otherwise 的父标签
> when 在 otherwise 之前使用
> 在父标签 choose 中定义一个 "全局" 的 boolean 类型的 flag:用于判断子标签在满足条件的情况下是否执行。
* 若 when 的 test 为 true,且 when 的父标签的 flag 也为 true,则执行 when 的标签体(正常输出标签体的内容),
同时把 flag 设置为 false
* 若 when 的 test 为 true,且 when 的父标签的 flag 为 false,则不执行标签体。
* 若 flag 为 true,otherwise 执行标签体。
标签:uppercase return library 使用方法 span turn txt attribute ges
原文地址:http://www.cnblogs.com/CComma/p/7197067.html