a、ax.servlet.jsp.tagext.SimpleTag,一般选择继承javax.servlet.jsp.tagext.SimpleTagSupport,覆盖掉doTag方法
b、在WEB-INF目录下建立一个扩展名为tld的xml文件(标签配置)
c、在JSP中使用前,先通过taglib指令导入外部的标签库
3、执行原理:
SimpleTag接口中的方法:
void doTag():由服务器调用。在JSP中遇到标签时调用。
JspTag getParent():由程序员调用。获取该标签的父标签对象。没有返回null
以下三个方法的共同特点:由服务器调用,在调用doTag之前就调完了。
void setJspBody(JspFragment jspBody):由服务器调用。传入标签的内容。
void setJspContext(JspContext pc):由服务器调用。传入当前页面的pageContext对象
void setParent(JspTag parent):由服务器调用。传入你的爹。没爹传入null
4、自定义标签的详细功能(基本功)
控制页面中某部分内容不显示 1.jsp
控制结束标签后的JSP内容不执行 2.jsp
控制主体内容重复执行:带属性的标签开发3.jsp
获取标签主体内容,改变后再输出4.jsp
代码:参考1 2 3 4.jsp
5、tld文件中的一些配置
body-content:的取值内容
JSP:不要考虑。(给传统标签处理类用的)
empty:传统和简单标签都能用的。开始标签和结束标签没有主体内容时用。
scriptless:给简单标签用的。开始标签和结束标签有主体内容时用。但是内容不能有<%
tagdependent:给简单标签用的。告诉标签处理类,主体内容是普通的文本
6、开发属于自己的标签库
6.1实现if功能的标签(控制主体内容是否输出)
6.2实现if else功能的标签(嵌套标签案例)
6.3实现for功能的标签(重复执行主体内容)
6.4实现HTML转义的标签(改变主体内容再输出)
快速入门:使用自定义标签输出客户机IP
package cn.itcast.web.tag;
import java.io.IOException;
import javax.servlet.http.HttpServletRequest; import javax.servlet.jsp.JspException; import javax.servlet.jsp.JspWriter; import javax.servlet.jsp.tagext.TagSupport;
public class ViewIPTag extends TagSupport {
@Override public int doStartTag() throws JspException { HttpServletRequest request=(HttpServletRequest) this.pageContext.getRequest(); String strIP=request.getRemoteAddr(); JspWriter out=this.pageContext.getOut(); try { out.write("你的IP地址为"+strIP); } catch (IOException e) { throw new RuntimeException(e); } return super.doStartTag(); } } |
//Itcast.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>A tag library exercising SimpleTag handlers.</description> <tlib-version>1.0</tlib-version> <short-name>SimpleTagLibrary</short-name> <uri>http://www.hgnc.net/jsp2-tag</uri> <tag> <description>show client IP</description> <name>viewIP</name> <tag-class>cn.itcast.web.tag.ViewIPTag</tag-class> <body-content>empty</body-content> </tag> </taglib> |
//web.xml tld文件放在WEB-INF目录下,可不配置,可参看tomcat例子 <jsp-config> <taglib> <taglib-uri> http://www.hgnc.net/jsp2-tag </taglib-uri> <taglib-location> /WEB-INF/itcast.tld </taglib-location> </taglib> </jsp-config> |
<%@ page language="java" pageEncoding="UTF-8"%> <%@ taglib prefix="itcast" uri="http://www.hgnc.net/jsp2-tag"%> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>显示IP地址</title> </head> <body> <% String strIP=request.getRemoteAddr(); out.print("你的IP地址为"+strIP); %> <br>
< itcast:viewIP/> </body> </html> |
查看tag接口api文档,分析自定义标签的执行流程。
Tag接口的执行流程
JSP引擎将遇到自定义标签时,首先创建标签处理器类的实例对象,然后按照JSP规范定义的通信规则依次调用它的方法。
1、public void setPageContext(PageContext pc), JSP引擎实例化标签处理器后,将调用setPageContext方法将JSP页面的pageContext对象传递给标签处理器,标签处理器以后可以通过这个pageContext对象与JSP页面进行通信。
2、public void setParent(Tag t),setPageContext方法执行完后,WEB容器接着调用的setParent方法将当前标签的父标签传递给当前标签处理器,如果当前标签没有父标签,则传递给setParent方法的参数值为null。
3、public int doStartTag(),调用了setPageContext方法和setParent方法之后,WEB容器执行到自定义标签的开始标记时,就会调用标签处理器的doStartTag方法。
4、public int doEndTag(),WEB容器执行完自定义标签的标签体后,就会接着去执行自定义标签的结束标记,此时,WEB容器会去调用标签处理器的doEndTag方法。
5、public void release(),通常WEB容器执行完自定义标签后,标签处理器会驻留在内存中,为其它请求服务器,直至停止web应用时,web容器才会调用release方法。
自定义标签功能扩展
自定义标签除了可以移除Jsp页面中的java代码外,它还可以用于完成一些页面逻辑,例如:
public int doStartTag() throws JspException { return this.SKIP_BODY; } | |
<tag> <description>忽略标签体</description> <name>skipBody</name> <tag-class>cn.itcast.web.tag.TagDemo1</tag-class> <body-content>JSP</body-content> </tag> | //通过自定义标签可以控制jsp页面某一部分内容是否执行 <itcast:skipBody> ssssssssssssss </itcast:skipBody> |
例如:<c:if>标签
通过自定义标签可以控制标签后的jsp页面是否执行。 public int doEndTag() throws JspException { return SKIP_PAGE; }
| <%@ page language="java" pageEncoding="UTF-8"%> <%@ taglib prefix="itcast" uri="http://www.hgnc.net/jsp2-tag"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>整个jsp是否输出</title> </head> uuu <itcast:skipPage>kkkkkkkkkkkkl</itcast:skipPage> <body> gggg </body> </html> |
<tag> <description>整个jsp页面标签后的内容是否输出</description> <name>skipPage</name> <tag-class>cn.itcast.web.tag.TagDemo2</tag-class> <body-content>JSP</body-content> </tag> |
通过自定义标签可以控制jsp页面某一部分内容重复执行。
int x; @Override public int doAfterBody() throws JspException { if(x-->0) return IterationTag.EVAL_BODY_AGAIN; else return IterationTag.SKIP_BODY; }
@Override public int doStartTag() throws JspException { x=5; return this.EVAL_BODY_INCLUDE; } | <tag> <description>循环输出标签体</description> <name>loopbody</name> <tag-class>cn.itcast.web.tag.TagDemo4</tag-class> <body-content>JSP</body-content> </tag> |
例如:<c:foreach>标签
通过自定义标签可以修改jsp页面内容输出。
@Override public int doStartTag() throws JspException { return BodyTag.EVAL_BODY_BUFFERED; }
@Override public int doEndTag() throws JspException { BodyContent bc=this.getBodyContent(); String content=bc.getString(); content=content.toUpperCase(); try { this.pageContext.getOut().write(content); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); } return super.doEndTag(); } | <itcast:modibody> kkkkkkkkkkkkl<br /> </itcast:modibody> |
tld文件中的四种标签体类型
EMPTY JSP scriptless tagdepentend
20、简单标签
由于传统标签使用三个标签接口来完成不同的功能,显得过于繁琐,不利于标签技术的推广, SUN公司为降低标签技术的学习难度,在JSP 2.0中定义了一个更为简单、便于编写和调用的SimpleTag接口来实现标签的功能。实现SimpleTag接口的标签通常称为简单标签。简单标签共定义了5个方法:
setJspContext方法
setParent和getParent方法
setJspBody方法
doTag方法
SimpleTag方法介绍(课后阅读API)
setJspContext方法
用于把JSP页面的pageContext对象传递给标签处理器对象
setParent方法
用于把父标签处理器对象传递给当前标签处理器对象
getParent方法
用于获得当前标签的父标签处理器对象
setJspBody方法
用于把代表标签体的JspFragment对象传递给标签处理器对象
doTag方法
用于完成所有的标签逻辑,包括输出、迭代、修改标签体内容等。在doTag方法中可以抛出javax.servlet.jsp.SkipPageException异常,用于通知WEB容器不再执行JSP页面中位于结束标记后面的内容,这等效于在传统标签的doEndTag方法中返回Tag.SKIP_PAGE常量的情况。
SimpleTag接口方法的执行顺序
当web容器开始执行标签时,会调用如下方法完成标签的初始化
WEB容器调用标签处理器对象的setJspContext方法,将代表JSP页面的pageContext对象传递给标签处理器对象。
WEB容器调用标签处理器对象的setParent方法,将父标签处理器对象传递给这个标签处理器对象。注意,只有在标签存在父标签的情况下,WEB容器才会调用这个方法。
如果调用标签时设置了属性,容器将调用每个属性对应的setter方法把属性值传递给标签处理器对象。如果标签的属性值是EL表达式或脚本表达式,则WEB容器首先计算表达式的值,然后把值传递给标签处理器对象。
如果简单标签有标签体,容器将调用setJspBody方法把代表标签体的JspFragment对象传递进来。
执行标签时:
容器调用标签处理器的doTag()方法,开发人员在方法体内通过操作JspFragment对象,就可以实现是否执行、迭代、修改标签体的目的。
JspFragment类
javax.servlet.jsp.tagext.JspFragment类是在JSP2.0中定义的,它的实例对象代表JSP页面中的一段符合JSP语法规范的JSP片段,这段JSP片段中不能包含JSP脚本元素。
WEB容器在处理简单标签的标签体时,会把标签体内容用一个JspFragment对象表示,并调用标签处理器对象的setJspBody方法把JspFragment对象传递给标签处理器对象。JspFragment类中只定义了两个方法,如下所示:
getJspContext方法
用于返回代表调用页面的JspContext对象.
public abstract void invoke(java.io.Writer out)
用于执行JspFragment对象所代表的JSP代码片段
参数out用于指定将JspFragment对象的执行结果写入到哪个输出流对象中,如果传递给参数out的值为null,则将执行结果写入到JspContext.getOut()方法返回的输出流对象中。(简而言之,可以理解为写给浏览器)
显示标签体 public class SimpleDemo1 extends SimpleTagSupport { @Override public void doTag() throws JspException, IOException { JspFragment jf=this.getJspBody(); jf.invoke(this.getJspContext().getOut()); super.doTag(); } } |
不显示标签体 public class SimpleDemo1 extends SimpleTagSupport { @Override public void doTag() throws JspException, IOException { } } |
//重复显示 public class SimpleDemo2 extends SimpleTagSupport { @Override public void doTag() throws JspException, IOException { JspFragment jf=this.getJspBody(); for(int i=0;i<5;i++) jf.invoke(this.getJspContext().getOut()); //与这个等价jf.invoke(null); super.doTag(); } } |
//修改标签内容 public class SimpleDemo3 extends SimpleTagSupport { @Override public void doTag() throws JspException, IOException { JspFragment jf=this.getJspBody(); StringWriter sw=new StringWriter(); jf.invoke(sw); String content=sw.toString(); content=content.toUpperCase(); this.getJspContext().getOut().write(content); } } |
//停止显示标签后面文档内容 public class SimpleDemo4 extends SimpleTagSupport { @Override public void doTag() throws JspException, IOException { throw new SkipPageException(); } } |
<uri>http://www.hgnc.net/jsp2-tagSimple</uri> <tag> <name>showbody</name> <tag-class>cn.itcast.web.simpletag.SimpleDemo1</tag-class> <body-content>scriptless</body-content> </tag> |
<%@ page language="java" pageEncoding="UTF-8"%> <%@ taglib prefix="itcast" uri="http://www.hgnc.net/jsp2-tagSimple"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>简单标签</title> </head>
<body> <itcast:showbody>ssssssssssssss </itcast:showbody> </body> </html> |
传统标签执行完后,驻留在内存象servlet一样,简单标签,执行完一次后,就释放了。
invoke方法详解
JspFragment.invoke方法可以说是JspFragment最重要的方法,利用这个方法可以控制是否执行和输出标签体的内容、是否迭代执行标签体的内容或对标签体的执行结果进行修改后再输出。例如:
在标签处理器中如果没有调用JspFragment.invoke方法,其结果就相当于忽略标签体内容;
在标签处理器中重复调用JspFragment.invoke方法,则标签体内容将会被重复执行;
若想在标签处理器中修改标签体内容,只需在调用invoke方法时指定一个可取出结果数据的输出流对象(例如StringWriter),让标签体的执行结果输出到该输出流对象中,然后从该输出流对象中取出数据进行修改后再输出到目标设备,即可达到修改标签体的目的。
开发带属性的标签
自定义标签可以定义一个或多个属性,这样,在JSP页面中应用自定义标签时就可以设置这些属性的值,通过这些属性为标签处理器传递参数信息,从而提高标签的灵活性和复用性。
要想让一个自定义标签具有属性,通常需要完成两个任务:
在标签处理器中编写每个属性对应的setter方法
在TLD文件中描术标签的属性
为自定义标签定义属性时,每个属性都必须按照JavaBean的属性命名方式,在标签处理器中定义属性名对应的setter方法,用来接收JSP页面调用自定义标签时传递进来的属性值。 例如属性url,在标签处理器类中就要定义相应的setUrl(String url)方法。
在标签处理器中定义相应的set方法后,JSP引擎在解析执行开始标签前,也就是调用doStartTag方法前,会调用set属性方法,为标签设置属性。
在TLD中描述标签属性
元素名 | 是否必须指定 | 描 述 |
description | 否 | 用于指定属性的描述信息。 |
name | 是 | 用于指定属性的名称。属性名称是大小写敏感的,并且不能以jsp、_jsp、java和sun开头。 |
required | 否 | 用于指定在JSP页面中调用自定义标签时是否必须设置这个属性。其取值包括true和false,默认值为false,true表示必须设置,否则可以设置也可以不设置该属性。 |
rtexprvalue | 否 | rtexprvalue是runtime expression value(运行时表达式)的英文简写,用于指定属性值是一个静态值或动态值。其取值包括true和false,默认值为false,false表示只能为该属性指定静态文本值,例如"123";true表示可以为该属性指定一个JSP动态元素,动态元素的结果作为属性值,例如JSP表达式<%=value %>。 |
type | 否 | 用于指定属性值的Java类型。 |
<%@ page language="java" pageEncoding="UTF-8"%> <%@page import="java.util.Date"%> <%@ taglib prefix="itcast" uri="http://www.hgnc.net/jsp2-tagSimple"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>带属性标签</title> </head> <body> <itcast:prop times="5" date="<%=new Date()%>">kkkkkkkkkkkkl<br /> </itcast:prop> </body> </html> |
<tag> <name>prop</name> <tag-class>cn.itcast.web.simpletag.SimpleDemo5</tag-class> <body-content>scriptless</body-content> <attribute> <name>times</name> <required>yes</required> </attribute> <attribute> <name>date</name> <required>yes</required> <rtexprvalue>true</rtexprvalue> </attribute> </tag> |
package cn.itcast.web.simpletag;
import java.io.IOException; import java.io.StringWriter; import java.util.Date;
import javax.servlet.jsp.JspException; import javax.servlet.jsp.SkipPageException; import javax.servlet.jsp.tagext.JspFragment; import javax.servlet.jsp.tagext.SimpleTagSupport;
public class SimpleDemo5 extends SimpleTagSupport { private int times; private Date date; public void setTimes(int times) { this.times = times; } public void setDate(Date date) { this.date = date; } @Override public void doTag() throws JspException, IOException { this.getJspContext().getOut().write(date.toString()); for (int i=0;i<times;i++) this.getJspBody().invoke(null); //throw new SkipPageException(); } } |
案例
使用标签控制页面逻辑案例:
开发防盗链标签
<%@ page language="java" pageEncoding="UTF-8"%> <%@taglib uri ="/jsp2-tagexample" prefix="fix"%> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <fix:referer site="http://localhost" page="/index.jsp"></fix:referer> <html> <head> <title>My JSP '1.jsp' starting page</title> </head>
<body> This is my JSP page. <br> </body> </html> |
package cn.itcast.web.tag.eaxmple;
import java.io.IOException;
import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.servlet.jsp.JspException; import javax.servlet.jsp.PageContext; import javax.servlet.jsp.SkipPageException; import javax.servlet.jsp.tagext.SimpleTagSupport;
public class RefererTag extends SimpleTagSupport { private String page; private String site; public void setPage(String page) { this.page = page; } public void setSite(String site) { this.site = site; } @Override public void doTag() throws JspException, IOException { PageContext pageContext=(PageContext) this.getJspContext(); HttpServletRequest request=(HttpServletRequest) pageContext.getRequest(); HttpServletResponse response= (HttpServletResponse) pageContext.getResponse(); String referer=request.getHeader("referer"); if(referer==null || !referer.startsWith(site)){ String cp=request.getContextPath(); if(page.startsWith(cp)) { response.sendRedirect(page); }else if (page.startsWith("/")) { response.sendRedirect(cp+page); }else { response.sendRedirect(cp+"/"+page); } throw new SkipPageException(); } else super.doTag(); } } |
<?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>A tag library exercising SimpleTag handlers.</description> <tlib-version>1.0</tlib-version> <short-name>SimpleTagLibrary</short-name> <uri>/jsp2-tagexample</uri>
<tag> <name>referer</name> <tag-class>cn.itcast.web.tag.eaxmple.RefererTag</tag-class> <body-content>empty</body-content> <attribute> <name>site</name> <required>yes</required> </attribute> <attribute> <name>page</name> <required>yes</required> <rtexprvalue>true</rtexprvalue> </attribute> </tag> </taglib> |
开发<c:if>标签
public class IfTag extends SimpleTagSupport { private boolean test;
public void setTest(boolean test) { this.test = test; }
@Override public void doTag() throws JspException, IOException { // TODO Auto-generated method stub if(test) this.getJspBody().invoke(null); else super.doTag(); } } |
<body> <% session.setAttribute("user","mmmm") ;%> <fix:if test="${user==null }"> 未登陆. <br> </fix:if> <fix:if test="${user!=null }"> welcome用户已经登录. <br> </fix:if>
ssss </body> |
<tag> <description>Outputs Hello, World</description> <name>if</name> <tag-class>cn.itcast.web.tag.example.IfTag</tag-class> <body-content>scriptless</body-content> <attribute> <name>test</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> </tag> |
开发<c:if><c:else>标签
<fix:choose> <fix:when test="${user==null }"> 未登陆. <br> </fix:when> <fix:otherwith> welcome用户已经登录. <br> </fix:otherwith> </fix:choose> <fix:choose> <fix:when test="${2==2}"> 2==2<br> </fix:when> <fix:otherwith> 2!=2<br> </fix:otherwith> </fix:choose>
<fix:choose> <fix:when test="${1==1}"> 1==1 <br> </fix:when> <fix:otherwith> 1<>1 <br> </fix:otherwith> </fix:choose> |
public class Choose extends SimpleTagSupport { private boolean isDo; public boolean isDo() { return isDo; } public void setDo(boolean isDo) { this.isDo = isDo; } @Override public void doTag() throws JspException, IOException { this.getJspBody().invoke(null); } } |
public class WhenTag extends SimpleTagSupport {
private boolean test; public void setTest(boolean test) { this.test = test; }
@Override public void doTag() throws JspException, IOException { Choose parent=(Choose) this.getParent(); if(test && !parent.isDo()) { this.getJspBody().invoke(null); parent.setDo(true); } } } |
public class OtherwithTag extends SimpleTagSupport {
@Override public void doTag() throws JspException, IOException { Choose parent=(Choose) this.getParent(); if(!parent.isDo()) { this.getJspBody().invoke(null); parent.setDo(true); } } } |
开发迭代标签
<%@ page language="java" pageEncoding="UTF-8" isELIgnored="false"%> <%@page import="java.util.ArrayList"%> <%@page import="java.util.List"%> <%@taglib uri ="/jsp2-tagexample" prefix="cc"%> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>My JSP '1.jsp' starting page</title> </head>
<body> <% List list=new ArrayList(); list.add("aaa"); list.add("bbb"); list.add("ccc"); list.add("ddd"); request.setAttribute("list",list); %> <cc:foreach items="${list}" var="str"> ${str } </cc:foreach>
</body> </html> |
<tag> <name>foreach</name> <tag-class>cn.itcast.web.tag.eaxmple.ForeachTag</tag-class> <body-content>scriptless</body-content> <attribute> <name>items</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <name>var</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> </tag> |
package cn.itcast.web.tag.eaxmple;
import java.io.IOException; import java.util.Iterator; import java.util.List;
import javax.servlet.jsp.JspException; import javax.servlet.jsp.PageContext; import javax.servlet.jsp.tagext.SimpleTagSupport;
public class ForeachTag extends SimpleTagSupport {
private String var; private Object items;
public void setVar(String var) { this.var = var; }
public void setItems(Object items) { this.items = items; }
@Override public void doTag() throws JspException, IOException { List list= (List) items; Iterator it=list.iterator(); while(it.hasNext()){ String value=(String) it.next(); this.getJspContext().setAttribute(var, value); this.getJspBody().invoke(null); } } } |
<%@ page language="java" pageEncoding="UTF-8" isELIgnored="false"%> <%@page import="java.util.ArrayList"%> <%@page import="java.util.List"%> <%@page import="java.util.HashMap"%> <%@page import="java.util.Map"%> <%@taglib uri ="/jsp2-tagexample" prefix="cc"%> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>My JSP '1.jsp' starting page</title> </head>
<body> ______list_____<br> <% List list=new ArrayList(); list.add("nnn"); list.add("bbb"); list.add("ccc"); list.add("ddd"); request.setAttribute("list",list); %> <cc:foreach2 items="${list}" var="str"> ${str }<br/> </cc:foreach2>
______map_____<br> <% Map map=new HashMap(); map.put("aa","111"); map.put("bb","222"); map.put("cc","333"); request.setAttribute("map",map); %> <cc:foreach2 items="${map}" var="entry"> ${entry.key } :${entry.value }<br/> </cc:foreach2>
______Integer_____<br> <% Integer num[]={1,2,3,4}; request.setAttribute("num",num); %> <cc:foreach2 items="${num}" var="i"> ${i }<br/> </cc:foreach2>
______String_____<br> <% String strs[]={"sss","mmm"}; request.setAttribute("strs",strs); %> <cc:foreach2 items="${strs}" var="str"> ${str }<br/> </cc:foreach2> ______int_____<br> <% int num2[]={11,22,33,44}; request.setAttribute("num2",num2); %> <cc:foreach2 items="${num2}" var="i"> ${i } </cc:foreach2> </body> </html> |
package cn.itcast.web.tag.eaxmple;
import java.io.IOException; import java.lang.reflect.Array; import java.util.ArrayList; import java.util.Arrays; import java.util.Collection; import java.util.Iterator; import java.util.List; import java.util.Map;
import javax.servlet.jsp.JspException; import javax.servlet.jsp.PageContext; import javax.servlet.jsp.tagext.SimpleTagSupport;
public class ForeachTag2 extends SimpleTagSupport {
private String var; private Object items; private Collection collection; public void setVar(String var) { this.var = var; }
public void setItems(Object items) { this.items = items; if(items==null) collection=null; if(items instanceof Collection) { collection=(Collection) items; } if(items instanceof Map){ Map map=(Map)items; collection=map.entrySet(); } if(items.getClass().isArray()){ this.collection=new ArrayList(); int len=Array.getLength(items); for(int i=0;i<len;i++) this.collection.add(Array.get(items, i)); } /* if(items instanceof Object[]){ Object obj[]=(Object[]) items; collection=Arrays.asList(obj); } if(items instanceof int[]){ int arr[]=(int[])items; this.collection=new ArrayList(); for(int i:arr){ this.collection.add(i); } }*/ }
@Override public void doTag() throws JspException, IOException { if( collection==null) return; Iterator it=collection.iterator(); while(it.hasNext()){ Object value=it.next(); this.getJspContext().setAttribute(var, value); this.getJspBody().invoke(null); } } } |
开发html转义标签
<fix:htmlFilter> <a href="a 发 a a">超链接的写法</a> </fix:htmlFilter> |
package cn.itcast.web.tag.example;
import java.io.IOException; import java.io.StringWriter;
import javax.servlet.jsp.JspException; import javax.servlet.jsp.tagext.JspFragment; import javax.servlet.jsp.tagext.SimpleTagSupport;
public class HtmlFilter extends SimpleTagSupport {
@Override public void doTag() throws JspException, IOException { JspFragment jf=this.getJspBody(); StringWriter sw=new StringWriter(); jf.invoke(sw); String content=sw.getBuffer().toString(); content=filter(content); this.getJspContext().getOut().write(content); } /*C:\\Tomcat 7.0\\webapps\\examples\\WEB-INF\\classes\\util\\HTMLFilter.java*/ public static String filter(String message) {
if (message == null) return (null); char content[] = new char[message.length()]; message.getChars(0, message.length(), content, 0); StringBuilder result = new StringBuilder(content.length + 50); for (int i = 0; i < content.length; i++) { switch (content[i]) { case '<': result.append("<"); break; case '>': result.append(">"); break; case '&': result.append("&"); break; case '"': result.append("""); break; default: result.append(content[i]); } } return (result.toString()); } } |
|
打包标签库
1) 新建一java工程,把src目录下的东西的代码拷进来,再在工程目录下建立META-INF目录,把配置文件拷进来,点工程右键属性 export/Java/JAR file,next在上面两个框中,左框中选中要导出的工程,去掉右框中eclipse的配置,在点brower按钮,输入导出的文件名,点finish.
21、JSTL标签库
核心标签
国际化标签
数据库标签
Xml标签
Jstl函数(el函数)
Tip:<c:out>标签
<c:out> 标签用于输出一段文本内容到pageContext对象当前保存的“out”对象中。
属性名 | 是否支持EL | 属性类型 | 属 性 描 述 |
Value | true | Object | 指定要输出的内容 |
escapeXml | true | Boolean | 指定是否将>、<、&、'、" 等特殊字符进行HTML编码转换后再进行输出。默认值为true |
default | true | Object | 指定如果value属性的值为null时所输出的默认值 |
<c:out value="aabbcc<br/>" escapeXml="false"></c:out> <c:out value="<a href=''>点点</a>" escapeXml="true"></c:out> <% request.setAttribute("data",null); %> <c:out default="bbbbbbbbbbbbb" value="${data }"></c:out> |
|
Tip:<c:set>标签
<c:set>标签用于把某一个对象存在指定的域范围内,或者设置Web域中的java.util.Map类型的属性对象或JavaBean类型的属性对象的属性。
属性名 | 是否支持EL | 属性类型 | 属 性 描 述 |
value | true | Object | 用于指定属性值 |
var | false | String | 用于指定要设置的Web域属性的名称 |
scope | false | String | 用于指定属性所在的Web域 |
target | true | Object | 用于指定要设置属性的对象,这个对象必须是JavaBean对象或java.util.Map对象 |
property | true | string | 用于指定当前要为对象设置的属性名称 |
<br/>_____________c:set___可操作各个域javabean Map集合____ <c:set var="dd" value="ddvalue" scope="page"/> ${dd }<br/>
<% Map map=new HashMap(); request.setAttribute("map",map); %> <c:set property="dd" value="xxx" target="${map}" /> ${map.dd }<br/>
<% Person p=new Person(); request.setAttribute("p",p); %> <c:set property="name" value="namevalue" target="${p}"></c:set> <c:out value="${p.name}"></c:out> | package cn.itcast.domain;
public class Person { private String name;
public String getName() { return name; }
public void setName(String name) { this.name = name; }
} |
Tip:<c:remove>标签
<c:remove>标签用于删除各种Web域中的属性。
其语法格式如下:
<c:remove var="varName"
[scope="{page|request|session|application}"] />
Tip:<c:catch>标签
<c:catch>标签用于捕获嵌套在标签体中的内容抛出的异常,其语法格式如下:<c:catch [var="varName"]>nested actions</c:catch>
var属性用于标识<c:catch>标签捕获的异常对象,它将保存在page这个Web域中。
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ page contentType="text/html;charset=gb2312" %>
<c:catch var="myex">
<%
int i=10/0;
%>
</c:catch>
异常:<c:out value="${myex}" /><br />
异常 myex.getMessage:<c:out value="${myex.message}" /><br />
异常 myex.getCause:<c:out value="${myex.cause}" /><br />
异常 myex.getStackTrace:<c:out value="${myex.stackTrace}" />
Tip:<c:if>标签
<c:if test=“”>标签可以构造简单的“if-then”结构的条件表达式
<c:if var="aaa" test="${user==null}" scope="page"></c:if> |
属性名 | 是否支持EL | 属性类型 | 属 性 描 述 |
test | true | boolean | 决定是否处理标签体中的内容的条件表达式 |
var | false | String | 用于指定将test属性的执行结果保存到某个Web域中的某个属性的名称 |
scope | false | String | 指定将test属性的执行结果保存到哪个Web域中 |
Tip:<c:choose>标签
<c:choose>标签用于指定多个条件选择的组合边界,它必须与<c:when>和<c:otherwise>标签一起使用。使用<c:choose>,<c:when>和<c:otherwise>三个标签,可以构造类似 “if-else if-else” 的复杂条件判断结构。
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ page contentType="text/html;charset=gb2312" %>
<c:set value="${param.count}" var="count“ /> pageContext(count,2)
<c:choose>
<c:when test="${count == 0}">
对不起,没有符合您要求的记录。
</c:when>
<c:otherwise>
符合您要求的记录共有${count}条.
</c:otherwise>
</c:choose>
Tip:<c:forEach>标签
<c:forEach>标签用于对一个集合对象中的元素进行循环迭代操作,或者按指定的次数重复迭代执行标签体中的内容。
属性名 | 是否支持EL | 属性类型 | 属 性 描 述 |
var | false | String | 指定将当前迭代到的元素保存到page这个Web域中的属性名称 |
items | true | 任何支持的类型 | 将要迭代的集合对象 |
varStatus | false | String | 指定将代表当前迭代状态信息的对象保存到page这个Web域中的属性名称,是第几次接待 |
begin | true | int | 如果指定items属性,就从集合中的第begin个元素开始进行迭代,begin的索引值从0开始编号;如果没有指定items属性,就从begin指定的值开始迭代,直到end值时结束迭代 |
end | true | int | 参看begin属性的描述 |
step | true | int | 指定迭代的步长,即迭代因子的迭代增量 |
<br/>_____________c:foreach______ <c:forEach var="i" begin="1" end="9" step="1" > ${i } </c:forEach> <br/>___c:foreach 实现表格隔行变色______
<% List list=new ArrayList(); list.add("aaa"); list.add("bbb"); list.add("ccc"); list.add("ddd"); request.setAttribute("list",list); %> <style> .odd{background-color: blue;} .even{background-color: red;} tr:hover{background-color: green;} //如果不支持鼠标放上去变色,可从tomact默认网页上拷头<!DOCTYPE html> </style> <table> <c:forEach var="str" items="${list}" varStatus="status"> <tr class="${status.count%2==0?'even':'odd' }"><td> ${status} ::: ${str }</td></tr> </c:forEach> </table> <br/>____________________________________ <% String atts[] = new String [5]; atts[0]="hello"; atts[1]="this"; atts[2]="is"; atts[3]="a"; atts[4]="pen"; request.setAttribute("atts", atts); %> <c:forEach items="${atts}" var="item" varStatus="s"> <h2><c:out value="${item}"/> varStatus的四种属性:</h2> index:${s.index}</br> count:${s.count}</br> first:${s.first}</br> last:${s.last}</br> </c:forEach> |
Tip:<c:param>标签
在JSP页面进行URL的相关操作时,经常要在URL地址后面附加一些参数。<c:param>标签可以嵌套在<c:import>、<c:url>或<c:redirect>标签内,为这些标签所使用的URL地址附加参数。<c:param>标签在为一个URL地址附加参数时,将自动对参数值进行URL编码,例如,如果传递的参数值为“中国”,则将其转换为“%d6%d0%b9%fa”后再附加到URL地址后面,这也就是使用<c:param>标签的最大好处。
http://localhost:808/servlet/MyServlet?name=“中国”
示例:<c:param name="name" value="value" />
Tip:<c:url>标签
<c:url>标签用于在JSP页面中构造一个URL地址,其主要目的是实现URL重写。URL重写就是将会话标识号以参数形式附加在URL地址后面
属性名 | 是否支持EL | 属性类型 | 属 性 描 述 |
value | true | String | 指定要构造的URL |
Context | true | String | 当要使用相对路径导入同一个服务器下的其他WEB应用程序中的URL地址时,context属性指定其他WEB应用程序的名称 |
var | false | String | 指定将构造出的URL结果保存到Web域中的属性名称 |
scope | false | String | 指定将构造出的URL结果保存到哪个Web域中 |
<c:url var="url" value="/index.jsp"> <c:param name="name" value="中国"></c:param> </c:url> <a href="${url }">购买</a> |
Tip:<c:redirect>标签
<c:redirect>标签用于将当前的访问请求转发或重定向到其他资源,它可以根据url属性所指定的地址,执行类似<jsp:forward>这个JSP标准标签的功能,将访问请求转发到其他资源;或执行response.sendRedirect()方法的功能,将访问请求重定向到其他资源。
属性名 | 是否支持EL | 属性类型 | 属 性 描 述 |
url | true | String | 指定要转发或重定向到的目标资源的URL地址 |
context | true | String | 当要使用相对路径重定向到同一个服务器下的其他WEB应用程序中的资源时,context属性指定其他WEB应用程序的名称 |
<% String data="aa,bb,cc,dd"; request.setAttribute("data",data); %> <c:forTokens items="${data}" delims="\," var="c"> ${c } : </c:forTokens> |
22、EL表达式
获得web开发常用对象
隐含对象名称 | 描 述 |
pageContext | 对应于JSP页面中的pageContext对象(注意:取的是pageContext对象。) |
pageScope | 代表page域中用于保存属性的Map对象 |
requestScope | 代表request域中用于保存属性的Map对象 |
sessionScope | 代表session域中用于保存属性的Map对象 |
applicationScope | 代表application域中用于保存属性的Map对象 |
param | 表示一个保存了所有请求参数的Map对象 |
paramValues | 表示一个保存了所有请求参数的Map对象,它对于某个请求参数,返回的是一个string[] |
header | 表示一个保存了所有http请求头字段的Map对象 |
headerValues | 同上,返回string[]数组。注意:如果头里面有“-” ,例Accept-Encoding,则要headerValues[“Accept-Encoding”] |
cookie | 表示一个保存了所有cookie的Map对象 |
initParam | 表示一个保存了所有web应用初始化参数的map对象 |
测试headerValues时,如果头里面有“-” ,例Accept-Encoding,则要headerValues[“Accept-Encoding”]
测试cookie时,例${cookie.key}取的是cookie对象,如访问cookie的名称和值,须${cookie.key.name}或${cookie.key.value}
EL表达式语法允许开发人员开发自定义函数,以调用Java类的方法。
示例:${prefix:method(params)}
在EL表达式中调用的只能是Java类的静态方法。
这个Java类的静态方法需要在TLD文件中描述,才可以被EL表达式调用。
EL自定义函数用于扩展EL表达式的功能,可以让EL表达式完成普通Java程序代码所能完成的功能。
EL Function开发步骤
一般来说, EL自定义函数开发与应用包括以下三个步骤:
编写一个Java类的静态方法
编写标签库描述符(tld)文件,在tld文件中描述自定义函数。
在JSP页面中导入和使用自定义函数
示例:开发对html标签进行转义的el function
开发EL Function注意事项
编写完标签库描述文件后,需要将它放置到<web应用>\WEB-INF目录中或WEB-INF目录下的除了classes和lib目录之外的任意子目录中。
TLD文件中的<uri> 元素用指定该TLD文件的URI,在JSP文件中需要通过这个URI来引入该标签库描述文件。
<function>元素用于描述一个EL自定义函数,其中:
<name>子元素用于指定EL自定义函数的名称。
<function-class>子元素用于指定完整的Java类名,
<function-signature>子元素用于指定Java类中的静态方法的签名,方法签名必须指明方法的返回值类型及各个参数的类型,各个参数之间用逗号分隔。
EL注意事项
EL表达式是JSP 2.0规范中的一门技术 。因此,若想正确解析EL表达式,需使用支持Servlet2.4/JSP2.0技术的WEB服务器。
注意:有些Tomcat服务器如不能使用EL表达式
(1)升级成tomcat6
(2)在JSP中加入<%@ page isELIgnored="false" %>
EL表达式保留关键字
${sessionScope.user[data]} //data是一个变量 .无法做到动态取值
JSTL中的常用EL函数
由于在JSP页面中显示数据时,经常需要对显示的字符串进行处理,SUN公司针对于一些常见处理定义了一套EL函数库供开发者使用。
这些EL函数在JSTL开发包中进行描述,因此在JSP页面中使用SUN公司的EL函数库,需要导入JSTL开发包,并在页面中导入EL函数库,如下所示:
在页面中使用JSTL定义的EL函数:
<%@taglib uri="http://java.sun.com/jsp/jstl/functions" prefix="fn"%>
fn:toLowerCase函数将一个字符串中包含的所有字符转换为小写形式,并返回转换后的字符串,它接收一个字符串类型的参数,例如
fn:toLowerCase("Www.IT315.org") 的返回值为字符串“www.it315.org”
fn:toLowerCase("")的返回值为空字符串
fn:toUpperCase函数将一个字符串中包含的所有字符转换为大写形式,并返回转换后的字符串,它接收一个字符串类型的参数。例如:
fn:toUpperCase("Www.IT315.org") 的返回值为字符串“WWW.IT315.ORG”
fn:toUpperCase("")的返回值为空字符串
fn:trim函数删除一个字符串的首尾的空格,并返回删除空格后的结果字符串,它接收一个字符串类型的参数。需要注意的是,fn:trim函数不能删除字符串中间位置的空格。
例如,fn:trim(" www.it315.org ") 的返回值为字符串“www.it 315.org”。
fn:length函数返回一个集合或数组大小,或返回一个字符串中包含的字符的个数,返回值为int类型。fn:length函数接收一个参数,这个参数可以是<c:forEach>标签的items属性支持的任何类型,包括任意类型的数组、java.util.Collection、java.util.Iterator、java.util.Enumeration、java.util.Map等类的实例对象和字符串。
如果fn:length函数的参数为null或者是元素个数为0的集合或数组对象,则函数返回0;如果参数是空字符串,则函数返回0。
fn:split函数以指定字符串作为分隔符,将一个字符串分割成字符串数组并返回这个字符串数组。
fn:split函数接收两个字符串类型的参数,第一个参数表示要分割的字符串,第二个参数表示作为分隔符的字符串。
例如,fn:split("www.it315.org", ".")[1]的返回值为字符串“it315”。
fn:join函数以一个字符串作为分隔符,将一个字符串数组中的所有元素合并为一个字符串并返回合并后的结果字符串。fn:join函数接收两个参数,第一个参数是要操作的字符串数组,第二个参数是作为分隔符的字符串。
如果fn:join函数的第二个参数是空字符串,则fn:join函数的返回值直接将元素连接起来。例如:
假设stringArray是保存在Web域中的一个属性,它表示一个值为{"www","it315","org"}的字符串数组,则fn:join(stringArray, “.")返回字符串“www.it315.org”
fn:join(fn:split("www,it315,org", ","), ".") 的返回值为字符串www.it315.org
fn:indexOf函数返回指定字符串在一个字符串中第一次出现的索引值,返回值为int类型。fn:indexOf函数接收两个字符串类型的参数,如果第一个参数字符串中包含第二个参数字符串,那么,不管第二个参数字符串在第一个参数字符串中出现几次,fn:indexOf函数总是返回第一次出现的索引值;如果第一个参数中不包含第二个参数,则fn:indexOf函数返回-1。如果第二个参数为空字符串,则fn:indexOf函数总是返回0。例如:
fn:indexOf("www.it315.org","t3") 的返回值为5
fn:contains函数检测一个字符串中是否包含指定的字符串,返回值为布尔类型。fn:contains函数在比较两个字符串是否相等时是大小写敏感的。
fn:contains函数接收两个字符串类型的参数,如果第一个参数字符串中包含第二个参数字符串,则fn:contains函数返回true,否则返回false。如果第二个参数的值为空字符串,则fn:contains函数总是返回true。实际上,fn:contains(string, substring)等价于fn:indexOf(string, substring) != -1。
忽略大小的EL函数:fn:containsIgnoreCase
fn:startsWith函数用于检测一个字符串是否是以指定字符串开始的,返回值为布尔类型。
fn:startsWith函数接收两个字符串类型的参数,如果第一个参数字符串以第二个参数字符串开始,则函数返回true,否则函数返回false。如果第二个参数为空字符串,则fn:startsWith函数总是返回true。例如:
fn:startsWith("www.it315.org","it315")的返回值为false
与之对应的EL函数:fn:endsWith
fn:replace函数将一个字符串中包含的指定子字符串替换为其它的指定字符串,并返回替换后的结果字符串。fn:replace方法接收三个字符串类型的参数,第一个参数表示要操作的源字符串,第二个参数表示源字符串中要被替换的子字符串,第三个参数表示要被替换成的字符串。例如:
fn:replace("www it315 org", " ", ".")的返回值为字符串www.it315.org
fn:substring函数用于截取一个字符串的子字符串并返回截取到的子字符串。fn:substring函数接收三个参数,第一个参数是用于指定要操作的源字符串,第二个参数是用于指定截取子字符串开始的索引值,第三个参数是用于指定截取子字符串结束的索引值,第二个参数和第三个参数都是int类型,其值都从0开始。例如:
fn:substring("www.it315.org", 4, 9) 的返回值为字符串“it315”
fn:substringAfter函数用于截取并返回一个字符串中的指定子字符串第一次出现之后的子字符串。fn:substringAfter函数接收两个字符串类型的参数,第一个参数表示要操作的源字符串,第二个参数表示指定的子字符串,例如:
fn:substringAfter(“www.it315.org”, “.”)的返回值为字符串“it315.org”。
与之对应的EL函数为:fn:substringBefore
23、Filter简介
Filter也称之为过滤器,它是Servlet技术中最激动人心的技术,WEB开发人员通过Filter技术,对web服务器管理的所有web资源:例如Jsp, Servlet, 静态图片文件或静态 html 文件等进行拦截,从而实现一些特殊的功能。例如实现URL级别的权限访问控制、过滤敏感词汇、压缩响应信息等一些高级功能。
Servlet API中提供了一个Filter接口,开发web应用时,如果编写的Java类实现了这个接口,则把这个java类称之为过滤器Filter。通过Filter技术,开发人员可以实现用户在访问某个目标资源之前,对访问的请求和响应进行拦截,如下所示:
Filter是如何实现拦截的?
Filter接口中有一个doFilter方法,当开发人员编写好Filter,并配置对哪个web资源进行拦截后,WEB服务器每次在调用web资源的service方法之前,都会先调用一下filter的doFilter方法,因此,在该方法内编写代码可达到如下目的:
调用目标资源之前,让一段代码执行
是否调用目标资源(即是否让用户访问web资源)。
web服务器在调用doFilter方法时,会传递一个filterChain对象进来,filterChain对象是filter接口中最重要的一个对象,它也提供了一个doFilter方法,开发人员可以根据需求决定是否调用此方法,调用该方法,则web服务器就会调用web资源的service方法,即web资源就会被访问,否则web资源不会被访问。
调用目标资源之后,让一段代码执行
实验: Filter开发,见下页PPT中的开发流程
Filter开发入门
Filter开发分为二个步骤:
编写java类实现Filter接口,并实现其doFilter方法。
在 web.xml 文件中使用<filter>和<filter-mapping>元素对编写的filter类进行注册,并设置它所能拦截的资源。(动手实验)
Filter链
在一个web应用中,可以开发编写多个Filter,这些Filter组合起来称之为一个Filter链。
web服务器根据Filter在web.xml文件中的注册顺序,决定先调用哪个Filter,当第一个Filter的doFilter方法被调用时,web服务器会创建一个代表Filter链的FilterChain对象传递给该方法。在doFilter方法中,开发人员如果调用了FilterChain对象的doFilter方法,则web服务器会检查FilterChain对象中是否还有filter,如果有,则调用第2个filter,如果没有,则调用目标资源。
Filter链实验(查看filterChain API文档)
Filter的生命周期
init(FilterConfig filterConfig)throws ServletException:
和我们编写的Servlet程序一样,Filter的创建和销毁由WEB服务器负责。 web 应用程序启动时,web 服务器将创建Filter 的实例对象,并调用其init方法,完成对象的初始化功能,从而为后续的用户请求作好拦截的准备工作(注:filter对象只会创建一次,init方法也只会执行一次。示例 )
开发人员通过init方法的参数,可获得代表当前filter配置信息的FilterConfig对象。(filterConfig对象见下页PPT)
destroy():
在Web容器卸载 Filter 对象之前被调用。该方法在Filter的生命周期中仅执行一次。在这个方法中,可以释放过滤器使用的资源。
FilterConfig接口
用户在配置filter时,可以使用<init-param>为filter配置一些初始化参数,当web容器实例化Filter对象,调用其init方法时,会把封装了filter初始化参数的filterConfig对象传递进来。因此开发人员在编写filter时,通过filterConfig对象的方法,就可获得:
String getFilterName():得到filter的名称。
String getInitParameter(String name): 返回在部署描述中指定名称的初始化参数的值。如果不存在返回null.
Enumeration getInitParameterNames():返回过滤器的所有初始化参数的名字的枚举集合。
public ServletContext getServletContext():返回Servlet上下文对象的引用。
实验:得到filter配置信息
Filter常见应用(1)
统一全站字符编码的过滤器
通过配置参数encoding指明使用何种字符编码,以处理Html Form请求参数的中文问题
禁止浏览器缓存所有动态页面的过滤器:
有 3 个 HTTP 响应头字段都可以禁止浏览器缓存当前页面,它们在 Servlet 中的示例代码如下:
response.setDateHeader("Expires",-1);
response.setHeader("Cache-Control","no-cache");
response.setHeader("Pragma","no-cache");
并不是所有的浏览器都能完全支持上面的三个响应头,因此最好是同时使用上面的三个响应头。
Expires数据头:值为GMT时间值,为-1指浏览器不要缓存页面
Cache-Control响应头有两个常用值:
no-cache指浏览器不要缓存当前页面。
max-age:xxx指浏览器缓存页面xxx秒。
控制浏览器缓存页面中的静态资源的过滤器:
场景:有些动态页面中引用了一些图片或css文件以修饰页面效果,这些图片和css文件经常是不变化的,所以为减轻服务器的压力,可以使用filter控制浏览器缓存这些文件,以提升服务器的性能。
使用Filter实现URL级别的权限认证
情景:在实际开发中我们经常把一些执行敏感操作的servlet映射到一些特殊目录中,并用filter把这些特殊目录保护起来,限制只能拥有相应访问权限的用户才能访问这些目录下的资源。从而在我们系统中实现一种URL级别的权限功能。
要求:为使Filter具有通用性,Filter保护的资源和相应的访问权限通过filter参数的形式予以配置。
实现用户自动登陆的过滤器
在用户登陆成功后,发送一个名称为user的cookie给客户端,cookie的值为用户名和md5加密后的密码。
编写一个AutoLoginFilter,这个filter检查用户是否带有名称为user的cookie来,如果有,则调用dao查询cookie的用户名和密码是否和数据库匹配,匹配则向session中存入user对象(即用户登陆标记),以实现程序完成自动登陆。
Filter的部署—注册Filter
<filter> <filter-name>testFitler</filter-name> <filter-class>org.test.TestFiter</filter-class> <init-param> <param-name>word_file</param-name> <param-value>/WEB-INF/word.txt</param-value> </init-param> </filter> |
<filter-name>用于为过滤器指定一个名字,该元素的内容不能为空。
<filter-class>元素用于指定过滤器的完整的限定类名。
<init-param>元素用于为过滤器指定初始化参数,它的子元素<param-name>指定参数的名字,<param-value>指定参数的值。在过滤器中,可以使用FilterConfig接口对象来访问初始化参数。
Filter的部署—映射Filter
<filter-mapping>元素用于设置一个 Filter 所负责拦截的资源。一个Filter拦截的资源可通过两种方式来指定:Servlet 名称和资源访问的请求路径
<filter-name>子元素用于设置filter的注册名称。该值必须是在<filter>元素中声明过的过滤器的名字
<url-pattern>设置 filter 所拦截的请求路径(过滤器关联的URL样式)
<servlet-name>指定过滤器所拦截的Servlet名称。
<dispatcher>指定过滤器所拦截的资源被 Servlet 容器调用的方式,可以是REQUEST,INCLUDE,FORWARD和ERROR之一,默认REQUEST。用户可以设置多个<dispatcher> 子元素用来指定 Filter 对资源的多种调用方式进行拦截。
<dispatcher> 子元素可以设置的值及其意义:
REQUEST:当用户直接访问页面时,Web容器将会调用过滤器。如果目标资源是通过RequestDispatcher的include()或forward()方法访问时,那么该过滤器就不会被调用。
INCLUDE:如果目标资源是通过RequestDispatcher的include()方法访问时,那么该过滤器将被调用。除此之外,该过滤器不会被调用。
FORWARD:如果目标资源是通过RequestDispatcher的forward()方法访问时,那么该过滤器将被调用,除此之外,该过滤器不会被调用。
ERROR:如果目标资源是通过声明式异常处理机制调用时,那么该过滤器将被调用。除此之外,过滤器不会被调用。
Filter的部署—映射Filter示例
<filter-mapping> <filter-name>testFilter</filter-name> <url-pattern>/test.jsp</url-pattern> </filter-mapping> |
<filter-mapping> <filter-name>testFilter</filter-name> <url-pattern>/index.jsp</url-pattern> <dispatcher>REQUEST</dispatcher> <dispatcher>FORWARD</dispatcher> </filter-mapping> |
Filter高级开发
由于开发人员在filter中可以得到代表用户请求和响应的request、response对象,因此在编程中可以使用Decorator(装饰器)模式对request、response对象进行包装,再把包装对象传给目标资源,从而实现一些特殊需求。
Decorator设计模式
某个对象的方法不适应业务需求时,通常有2种方式可以对方法进行增强:
编写子类,覆盖需增强的方法
使用Decorator设计模式对方法进行增强
疑问:在实际应用中遇到需增强对象的方法时,到底选用哪种方式呢?
没有具体的定式,不过有一种情况下,必须使用Decorator设计模式:即被增强的对象,开发人员只能得到它的对象,无法得到它的class文件。
比如request、response对象,开发人员之所以在servlet中能通过sun公司定义的HttpServletRequest\response接口去操作这些对象,是因为Tomcat服务器厂商编写了request、response接口的实现类。web服务器在调用servlet时,会用这些接口的实现类创建出对象,然后传递给servlet程序。
此种情况下,由于开发人员根本不知道服务器厂商编写的request、response接口的实现类是哪个?在程序中只能拿到服务器厂商提供的对象,因此就只能采用Decorator设计模式对这些对象进行增强。
Decorator设计模式的实现
1.首先看需要被增强对象继承了什么接口或父类,编写一个类也去继承这些接口或父类。
2.在类中定义一个变量,变量类型即需增强对象的类型。
3.在类中定义一个构造函数,接收需增强的对象。
4.覆盖需增强的方法,编写增强的代码。
举例:使用Decorator设计模式为BufferedReader类的readLine方法添加行号的功能。
request对象的增强
Servlet API 中提供了一个request对象的Decorator设计模式的默认实现类HttpServletRequestWrapper , (HttpServletRequestWrapper 类实现了request 接口中的所有方法,但这些方法的内部实现都是仅仅调用了一下所包装的的 request 对象的对应方法)以避免用户在对request对象进行增强时需要实现request接口中的所有方法。
使用Decorator模式包装request对象,完全解决get、post请求方式下的乱码问题。
使用Decorator模式包装request对象,实现html标签转义功能(Tomcat服务器中提供了转义html标签的工具类)。
response对象的增强
Servlet API 中提供了response对象的Decorator设计模式的默认实现类HttpServletResponseWrapper , (HttpServletResponseWrapper类实现了response接口中的所有方法,但这些方法的内部实现都是仅仅调用了一下所包装的的 response对象的对应方法)以避免用户在对response对象进行增强时需要实现response接口中的所有方法。
response增强案例—压缩响应
应用HttpServletResponseWrapper对象,压缩响应正文内容。思路:
通过filter向目标页面传递一个自定义的response对象。
在自定义的response对象中,重写getOutputStream方法和getWriter方法,使目标资源调用此方法输出页面内容时,获得的是我们自定义的ServletOutputStream对象。
在我们自定义的ServletOuputStream对象中,重写write方法,使写出的数据写出到一个buffer中。
当页面完成输出后,在filter中就可得到页面写出的数据,从而我们可以调用GzipOuputStream对数据进行压缩后再写出给浏览器,以此完成响应正文件压缩功能。
实用案例-缓存数据到内存
对于页面中很少更新的数据,例如商品分类,为避免每次都要从数据库查询分类数据,因此可把分类数据缓存在内存或文件中,以此来减轻数据库压力,提高系统响应速度。