标签与简单标签

自定义标签库开发Tip：自定义标签简介自定义标签主要用于移除Jsp页面中的java代码。使用自定义标签移除jsp页面中的java代码，只需要完成以下两个步骤：编写一个实现Tag接口的Java类(标签处理器类)。编写标签库描述符（tld）文件，在tld文件中把标签处理器类进行描述。快速入门：使用标签输出客户机IP。自定义标签的执行流程。Tip：Tag接口的执行流程JSP引擎将遇到自定义标签时，首先创建标签处理器类的实例对象，然后按照JSP定义的通信规则依次调用它的。 1、publicvoidsetPageContext(PageContext pc)，JSP引擎实例化标签处理器后，将调用setPageContext方法将JSP页面的pageContext对象传递给标签处理器，标签处理器以后可以通过这个pageContext对象与JSP页面进行通信。 2、publicvoidsetParent(Tag t)，setPageContext方法执行完后，WEB容器接着调用的setParent方法将当前标签的父标签传递给当前标签处理器，如果当前标签没有父标签，则传递给setParent方法的参数值为null。 3、publicintdoStartTag()，调用了setPageContext方法和setParent方法之后，WEB容器执行到自定义标签的开始标记时，就会调用标签处理器的doStartTag方法。 4、publicintdoEndTag()，WEB容器执行完自定义标签的标签体后，就会接着去执行自定义标签的结束标记，此时，WEB容器会去调用标签处理器的doEndTag方法。 5、publicvoidrelease()，通常WEB容器执行完自定义标签后，标签处理器会驻留在内存中，为其它请求服务器，直至停止web应用时，web容器才会调用release方法。Tip：自定义标签功能扩展开发人员在编写Jsp页面时，经常还需要在页面中引入一些逻辑，例如：控制jsp页面某一部分内容是否执行。控制结束标签后的JSP内容是否执行控制jsp页面内容重复执行。修改页面内容输出。自定义标签除了可以移除jsp页面java代码外，它也可以实现以上功能。实验以上4个功能tld文件中的四种标签体类型EMPTYJSPscriptlesstagdependentTip：简单标签由于传统标签使用三个标签接口来完成不同的功能，显得过于繁琐，不利于标签技术的推广，SUN公司为降低标签技术的学习难度，在JSP2.0中定义了一个更为简单、便于编写和调用的SimpleTag接口来实现标签的功能。实现SimpleTag接口的标签通常称为简单标签。简单标签共定义了5个方法：setJspContext方法setParent和getParent方法setJspBody方法doTag方法Tip：SimpleTag方法介绍(课后阅读API)setJspContext方法用于把JSP页面的pageContext对象传递给标签处理器对象setParent方法用于把父标签处理器对象传递给当前标签处理器对象getParent方法用于获得当前标签的父标签处理器对象setJspBody方法用于把代表标签体的JspFragment对象传递给标签处理器对象doTag方法用于完成所有的标签逻辑，包括输出、迭代、修改标签体内容等。在doTag方法中可以抛出javax.servlet.jsp.SkipPageException异常，用于WEB容器不再执行JSP页面中位于结束标记后面的内容，这等效于在传统标签的doEndTag方法中返回Tag.SKIP_PAGE常量的情况。Tip：SimpleTag接口方法的执行顺序当web容器开始执行标签时，会调用如下方法完成标签的初始化WEB容器调用标签处理器对象的setJspContext方法，将代表JSP页面的pageContext对象传递给标签处理器对象。WEB容器调用标签处理器对象的setParent方法，将父标签处理器对象传递给这个标签处理器对象。注意，只有在标签存在父标签的情况下，WEB容器才会调用这个方法。如果调用标签时设置了属性，容器将调用每个属性对应的setter方法把属性值传递给标签处理器对象。如果标签的属性值是EL表达式或脚本表达式，则WEB容器首先计算表达式的值，然后把值传递给标签处理器对象。如果简单标签有标签体，容器将调用setJspBody方法把代表标签体的JspFragment对象传递进来。执行标签时：容器调用标签处理器的doTag()方法，开发人员在方法体内通过操作JspFragment对象，就可以实现是否执行、迭代、修改标签体的目的。Tip：JspFragment类javax.servlet.jsp.tagext.JspFragment类是在JSP2.0中定义的，它的实例对象代表JSP页面中的一段符合JSP语法规范的JSP片段，这段JSP片段中不能包含JSP脚本元素。WEB容器在处理简单标签的标签体时，会把标签体内容用一个JspFragment对象表示，并调用标签处理器对象的setJspBody方法把JspFragment对象传递给标签处理器对象。JspFragment类中只定义了两个方法，如下所示：getJspContext方法用于返回代表调用页面的JspContext对象.publicabstractvoidinvoke(java.io.Writer out)用于执行JspFragment对象所代表的JSP代码片段参数out用于指定将JspFragment对象的执行结果写入到哪个输出流对象中，如果传递给参数out的值为null，则将执行结果写入到JspContext.getOut()方法返回的输出流对象中。(简而言之，可以理解为写给浏览器)Tip：invoke方法详解JspFragment.invoke方法是JspFragment最重要的方法，利用这个方法可以控制是否执行和输出标签体的内容、是否迭代执行标签体的内容或对标签体的执行结果进行修改后再输出。例如：在标签处理器中如果没有调用JspFragment.invoke方法，其结果就相当于忽略标签体内容；在标签处理器中重复调用JspFragment.invoke方法，则标签体内容将会被重复执行；若想在标签处理器中修改标签体内容，只需在调用invoke方法时指定一个可取出结果数据的输出流对象（例如StringWriter），让标签体的执行结果输出到该输出流对象中，然后从该输出流对象中取出数据进行修改后再输出到目标设备，即可达到修改标签体的目的。Tip：开发带属性的标签自定义标签可以定义一个或多个属性，这样，在JSP页面中应用自定义标签时就可以设置这些属性的值，通过这些属性为标签处理器传递参数信息，从而提高标签的灵活性和复用性。Tip：开发带属性的标签要想让一个自定义标签具有属性，通常需要完成两个任务：在标签处理器中编写每个属性对应的setter方法在TLD文件中描术标签的属性为自定义标签定义属性时，每个属性都必须按照JavaBean的属性命名方式，在标签处理器中定义属性名对应的setter方法，用来接收JSP页面调用自定义标签时传递进来的属性值。例如属性url，在标签处理器类中就要定义相应的setUrl(Stringurl)方法。在标签处理器中定义相应的set方法后，JSP引擎在解析执行开始标签前，也就是调用doStartTag方法前，会调用set属性方法，为标签设置属性。Tip：在TLD中描述标签属性<tag>元素的<attribute>子元素用于描述自定义标签的一个属性，自定义标签所具有的每个属性都要对应一个<attribute>元素。<attribute> <description>description</description> <name>aaaa</name> <required>true</required> <rtexprvalue>true</rtexprvalue> <type>ObjectType</type></attribute>元素名是否必须指定描述description否用于指定属性的描述信息。name是用于指定属性的名称。属性名称是大小写敏感的，并且不能以jsp、_jsp、java和sun开头。required否用于指定在JSP页面中调用自定义标签时是否必须设置这个属性。其取值包括true和false，默认值为false，true表示必须设置，否则可以设置也可以不设置该属性。rtexprvalue否rtexprvalue是runtimeexpressionvalue（运行时表达式）的英文简写，用于指定属性值是一个静态值或动态值。其取值包括true和false，默认值为false，false表示只能为该属性指定静态文本值，例如"123"；true表示可以为该属性指定一个JSP动态元素，动态元素的结果作为属性值，例如JSP表达式<%=value%>。type否用于指定属性值的Java类型。Tip：案例使用标签控制页面逻辑案例：开发防盗链标签:referer开发<c:if>标签开发<c:when><c:otherwise>标签开发迭代标签开发html转义标签打包标签库Tip：JSTL标签库核心标签库c:ifc:forEach国际化标签国际化相关类和原理数据库标签XML标签JSTL(EL函数)Tip：<c:out>标签<c:out>标签用于输出一段文本内容到pageContext对象当前保存的“out”对象中。属性名是否支持EL属性类型属性描述ValuetrueObject指定要输出的内容escapeXmltrueBoolean指定是否将>、<、&、'、"等特殊字符进行HTML编码转换后再进行输出。默认值为truedefaulttrueObject指定如果value属性的值为null时所输出的默认值Tip：<c:set>标签<c:set>标签用于把某一个对象存在指定的域范围内，或者设置Web域中的java.util.Map类型的属性对象或JavaBean类型的属性对象的属性。属性名是否支持EL属性类型属性描述valuetrueObject用于指定属性值varfalseString用于指定要设置的Web域属性的名称scopefalseString用于指定属性所在的Web域targettrueObject用于指定要设置属性的对象，这个对象必须是JavaBean对象或java.util.Map对象propertytruestring用于指定当前要为对象设置的属性名称Tip：<c:remove>标签<c:remove>标签用于删除各种Web域中的属性。 其语法格式如下： <c:removevar="varName" [scope="{page|request|session|application}"]/>Tip：<c:catch>标签<c:catch>标签用于捕获嵌套在标签体中的内容抛出的异常，其语法格式如下：<c:catch[var="varName"]>nestedactions</c:catch>var属性用于标识<c:catch>标签捕获的异常对象，它将保存在page这个Web域中。<%@taglibprefix="c"uri="http://java.sun.com/jsp/jstl/core"%><%@pagecontentType="text/html;charset=gb2312"%><c:catchvar="myex“scope=“page”> <% 10/0; %></c:catch>异常：<c:outvalue="${myex}"/><br/>异常myex.getMessage：<c:outvalue="${myex.message}"/><br/>异常myex.getCause：<c:outvalue="${myex.cause}"/><br/>异常myex.getStackTrace：<c:outvalue="${myex.stackTrace}"/>Tip：<c:if>标签<c:iftest=“”>标签可以构造简单的“if-then”结构的条件表达式属性名是否支持EL属性类型属性描述testtrueboolean决定是否处理标签体中的内容的条件表达式varfalseString用于指定将test属性的执行结果保存到某个Web域中的某个属性的名称scopefalseString指定将test属性的执行结果保存到哪个Web域中Tip：<c:choose>标签<c:choose>标签用于指定多个条件选择的组合边界，它必须与<c:when>和<c:otherwise>标签一起使用。使用<c:choose>，<c:when>和<c:otherwise>三个标签，可以构造类似“if-elseif-else”的复杂条件判断结构。<%@taglibprefix="c"uri="http://java.sun.com/jsp/jstl/core"%><%@pagecontentType="text/html;charset=gb2312"%><c:setvalue="${param.count}"var="count“/>pageContext(count,2)<c:choose> <c:whentest="${count==0}"> 对不起，没有符合您要求的记录。 </c:when> <c:otherwise> 符合您要求的记录共有${count}条. </c:otherwise></c:choose>Tip：<c:forEach>标签<c:forEach>标签用于对一个集合对象中的元素进行循环迭代操作，或者按指定的次数重复迭代执行标签体中的内容。属性名是否支持EL属性类型属性描述varfalseString指定将当前迭代到的元素保存到page这个Web域中的属性名称itemstrue任何支持的类型将要迭代的集合对象begintrueint如果指定items属性，就从集合中的第begin个元素开始进行迭代，begin的索引值从0开始编号；如果没有指定items属性，就从begin指定的值开始迭代，直到end值时结束迭代endtrueint参看begin属性的描述steptrueint指定迭代的步长，即迭代因子的迭代增量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>标签的最大好处。示例：<c:paramname="name"value="value"/>Tip：<c:url>标签<c:url>标签用于在JSP页面中构造一个URL地址，其主要目的是实现URL重写。URL重写就是将会话标识号以参数形式附加在URL地址后面属性名是否支持EL属性类型属性描述valuetrueString指定要构造的URLvarfalseString指定将构造出的URL结果保存到Web域中的属性名称scopefalseString指定将构造出的URL结果保存到哪个Web域中Tip：<c:redirect>标签<c:redirect>标签用于实现请求重定向属性名是否支持EL属性类型属性描述urltrueString指定要转发或重定向到的目标资源的URL地址contexttrueString当要使用相对路径重定向到同一个服务器下的其他WEB应用程序中的资源时，context属性指定其他WEB应用程序的名称Tip：国际化标签详情国际化编程时介绍