前言:
前面我学了核心的标签
但是如果我想要实现的内容核心标签 和jstl标签库不能解决怎么办?
有人说可以用jsp脚本,但是jsp主要是展示数据用的,不应该大量出现java代码才对。这个时候自定义标签就出现了。
(也有人说jsp耦合度太高了,这些姑且不考虑)
自定义标签目的:
替代jsp脚本,用于在jsp页面中执行java代码
第一步:编写一个普通的java类,继承SimpleTagSupport类,叫标签处理器类
注意:SimpleTagSupport需要导包jsp-api.jar,这个可以在Tomcat的lib中找到
重点:自定义标签的内容要覆盖doTag方法
自定义标签的执行过程
问题: http://localhost:8080/day14/01.hellotag.jsp 如何访问到自定义标签?
前提: tomcat服务器启动时,加载到每个web应用,加载每个web应用的WEB-INF目录下的所有文件!!!例如。web.xml, tld文件!!!
1)访问01.hellotag.jsp资源
2)tomcat服务器把jsp文件翻译成java源文件->编译class->构造类对象->调用_jspService()方法
3)检查jsp文件的taglib指令,是否存在一个名为http://gz.itcast.cn的tld文件。如果没有,则报错
4)上一步已经读到itcast.tld文件
5)读到<itcast:showIp> 到itcast.tld文件中查询是否存在<name>为showIp的<tag>标签
6)找到对应的<tag>标签,则读到<tag-class>内容
7)得到 gz.itcast.a_tag.ShowIpTag
构造ShowIpTag对象,然后调用ShowIpTag里面的方法
自定义标签处理器类的生命周期
SimpleTag接口:
void setJspContext(JspContext pc) --设置pageContext对象,传入pageContext(一定调用)
通过getJspCotext()方法得到pageContext对象
void setParent(JspTag parent) --设置父标签对象,传入父标签对象,如果没有父标签,则不 调用此方法。通过getParent()方法得到父标签对象。
void setXXX(值) --设置属性值。
void setJspBody(JspFragment jspBody) --设置标签体内容。标签体内容封装到JspFragment对象 中,然后传入JspFragment对象。通过getJspBody()方法 得到标签体内容。如果没有标签体内容,则不会调 用此方法
void doTag() --执行标签时调用的方法。(一定调用)
我编写了两个:直接贴代码好了:
代码1实现了 像浏览器输出浏览器的IP地址:
package show;
import java.io.IOException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.tagext.SimpleTagSupport;
public class ShowIp extends SimpleTagSupport {
@Override
public void doTag() throws JspException, IOException {
PageContext pageContext=(PageContext)this.getJspContext();
HttpServletRequest httpServletRequest=(HttpServletRequest)pageContext.getRequest();
String string=httpServletRequest.getRemoteHost();
JspWriter jspWriter=pageContext.getOut();
jspWriter.write(string);
}
}
代码2:比较杂,主要有带属性的标签还有对标签内容进行操作:
1)控制标签体内容是否输出
2)控制标签余下内容是否输出
3)控制重复输出标签体内容
4)改变标签体内容
5)带属性的标签
public class other extends SimpleTagSupport {
private Integer num;
public void setNum(Integer num) {
this.num = num;
}
@Override
public void doTag() throws JspException, IOException {
//输出属性
System.out.println(num);
/* 1)控制标签内容是否输出
输出: 调用jspFrament.invoke();
不输出: 不调用jspFrament.invoke();
往浏览器输出内容,invoke为null就是默认往浏览器输出
*/
this.getJspBody().invoke(null);
JspFragment jspFragment= this.getJspBody();
String context=jspFragment.toString();
//控制重复输出标签体内容
for(int i=0;i<2;i++) {
jspFragment.invoke(null);
}
//改变标签体内容
StringWriter stringWriter=new StringWriter();
//标签内容存到临时StringWriter中
jspFragment.invoke(stringWriter);
String string=stringWriter.toString();
string=string.toUpperCase();
this.getJspContext().getOut().write(string);
//控制标签余下内容是否输出
//不输出: 抛出SkipPageException异常
throw new SkipPageException();
}
}
第二步:在web项目的WEB-INF目录下建立itcast.tld文件,这个tld叫标签库的声明文件。
<?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">
<description>自定义</description>
<display-name>jjc</display-name>
<tlib-version>1.1</tlib-version>
<short-name>item</short-name>
<uri>jiangjiacong</uri>
<tag>
<name>showIp</name>
<tag-class>show.ShowIp</tag-class>
<body-content>scriptless</body-content>
</tag>
<tag>
<name>context</name>
<tag-class>other.other</tag-class>
<!-- empt:表示没有标签体
JSP:表示标签体可以包含JSP代码
scriptless:表示标签体可以包含EL表达式和JSP动作元素,但不能包含JSP的脚本元素
tagdependent:表示标签体交由标签本身去解析处理。即在标签体中所写的任何代码都会原封不动地传给标签处理器 -->
<body-content>scriptless</body-content>
<!-- 属性声明 -->
<attribute>
<!-- 属性名称 -->
<name>num</name>
<!-- 是否必填 -->
<required>true</required>
<!-- 是否支持EL表达式 -->
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
</taglib>
注意:
<body-content>:是输出标签体内容格式
- empt:表示没有标签体
- JSP:表示标签体可以包含JSP代码
- scriptless:表示标签体可以包含EL表达式和JSP动作元素,但不能包含JSP的脚本元素
- tagdependent:表示标签体交由标签本身去解析处理。即在标签体中所写的任何代码都会原封不动地传给标签处理器
一般自定义标签都是scriptless
接下来 jsp页面要引用自定义标签:
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<%@taglib uri="jiangjiacong" prefix="item"%>
<!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>
<%Integer age=133;
pageContext.setAttribute("agevalue", age);
%>
<%-- <item:showIp>sdf</item:showIp> --%>
<item:context num="${agevalue}">${10>2 }<br/></item:context>
</body>
</html>
重点:
<%@taglib uri="jiangjiacong" prefix="item"%>