周记随笔第11周(jsp自定义标签和El表达式和标准标签库)

第11周学习知识点：
1.自定义标签
2.El表达式
3.jsp标准标签库

本周学习收获：

1.自定义jsp标签的执行过程

当一个含有自定义标签的jsp页面被jsp引擎转译成servlet时，jsp引擎遇到自定义的标签，会把这个自定义标签转化成对一个称为“标签处理类”的调用。之后，当这个jsp页面被执行时,jsp引擎就会调用这个“标签处理类”对象,并执行其内部定义的相应操作方法,从而完成相应的功能。
2.自定义jsp标签的开发流程
步骤:
(1)创建标签的处理类(Tag Handle Class).这个类实现Tag接口，用来定义标签的行为，并在jsp引擎遇到自定义标签时调用执行。
(2)创建标签库描述(tld)文件(Tag Library Descriptor File),在tld文件中对标签处理器类进行描述
(3)在jsp文件中用taglib指令引入标签库,然后使用标签库描述文件中指定的标签名来使用它
3.使用标签输出客户机IP和分析
Tag接口的执行流程:
Public void setPageContext,jsp引擎实例化标签处理器后，将调用setPageContext方法将jsp页面的pageContext对象传递给标签处理器，标签处理器以后可以通过这个pageContext对象与jsp页面进行通信。
Public void setParent,setPageContext方法执行完后，web容器接着调用的setParent方法将当前标签的父标签传递给当前标签处理器，如果当前标签没有没有父标签，则传递给setParent方法的参数值为null
Public int doStarTag(),调用了setPageContext方法和setParent方法之后,web容器执行到自定义标签的开始标记时,就会调用标签处理器的doStarTag方法
Public int doEndTag(),web容器执行完自定义标签的标签体后，就会接着去执行自定义标签的结束标记,此时，web容器会去调用标签处理器的doEndTag方法
Public void release(),通常web容器执行完自定标签后，标签处理器会驻留在内存中，为其它请求服务,直至停止web应用，web4容器才会调用release方法
4.自定义标签功能扩展
开发人员在编写Jsp页面时，经常还需要在页面中引入一些逻辑:
控制jsp页面某一部分内容是否执行,控制整个jsp页面是否执行,控制jsp页面内容重复执行,修改jsp页面内容输出。
tld文件中的四种标签体类型:EMPTY  JSP  scriptless  tagdepentend
5.标签库描述符:
标签库描述符文件是一个以“.tld”结尾的标准XML文档，用来记录一个标签库内拥有哪些标签、每个标签包含哪些属性。
<taglib>元素是标签库描述符的根元素，它包含12个子元素，详细介绍如下：
(1)<description>：标签库的一个文本描述。
(2)<tlib-version>：指定标签库的版本。
(3)<short-name>：为标签定义简短的名字，在taglib指令中可作为首选的前缀名使用。
(4)<uri>：定义一个URI，用于唯一地标识此标签库。
(5)<tag>：用于指定自定义标签的相关信息。
(6)<display-name>：为标签库指定一个简短的别名。
(7)<small-icon>：为标签库指定大小为16×16的小图标(gif或jpeg格式)，该图标可在图形界面工具中显示。
(8)<large-icon>：为标签库指定大小为32×32的大图标(gif或jpeg格式)，该图标可在图形界面工具中显示。
(9)<validator>：为标签库提供一个验证器。
(10)<listener>：为标签库提供一个监听器。
(11)<tag-file>：用于描述标签文件。
(12)<function>：用于指定在表达式语言中使用的函数。
6.传统标签的开发：两个支持类(TagSupport和BodyTagSupport)的生命周期。
BodyTagSupport类中增加了两个方法：
setBodyContent(BodyContent bc)：容器在执行这个标签处理类的实例时，将调用该方法，把标签主体返回的内容缓存在BodyContent类的实例中。BodyContent除了从父类JspWriter继承提供用于向响应体中写入文本的方法，还提供了用于获取它缓冲的标签体内容。
doInitBody()：计算标签主体之前调用该方法进行初始化共，可以向bodyContent对象中写入初始内容，这些内容会放置在标签主体内容之前。
BodyContent类专门用于缓存标签主体返回的内容，包括静态文本以及由嵌套标签或脚本元素所创建的动态内容。
7.简单标签
实现SimpleTag接口的标签通常称为简单标签。简单标签共定义了5个方法：
setJspContext方法：
用于把JSP页面的pageContext对象传递给标签处理器对象

setParent和getParent方法：
用于把父标签处理器对象传递给当前标签处理器对象 和用于获得当前标签的父标签处理器对象
setJspBody方法:
用于把代表标签体的JspFragment对象传递给标签处理器对象
doTag方法:
用于完成所有的标签逻辑，包括输出、迭代、修改标签体内容等。在doTag方法中可以抛出javax.servlet.jsp.SkipPageException异常，用于通知WEB容器不再执行JSP页面中位于结束标记后面的内容，这等效于在传统标签的doEndTag方法中返回Tag.SKIP_PAGE常量的情况
8.SimpleTag接口方法的执行顺序
WEB容器调用标签处理器对象的setJspContext方法，将代表JSP页面的pageContext对象传递给标签处理器对象。
WEB容器调用标签处理器对象的setParent方法，将父标签处理器对象传递给这个标签处理器对象。注意，只有在标签存在父标签的情况下，WEB容器才会调用这个方法。
如果调用标签时设置了属性，容器将调用每个属性对应的setter方法把属性值传递给标签处理器对象。如果标签的属性值是EL表达式或脚本表达式，则WEB容器首先计算表达式的值，然后把值传递给标签处理器对象。
如果简单标签有标签体，容器将调用setJspBody方法把代表标签体的JspFragment对象传递进来。
9.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()方法返回的输出流对象中。(简而言之，可以理解为写给浏览器)
10.invoke方法详解
JspFragment.invoke方法是JspFragment最重要的方法，利用这个方法可以控制是否执行和输出标签体的内容、是否迭代执行标签体的内容或对标签体的执行结果进行修改后再输出。例如：

在标签处理器中如果没有调用JspFragment.invoke方法，其结果就相当于忽略标签体内容；
在标签处理器中重复调用JspFragment.invoke方法，则标签体内容将会被重复执行；
若想在标签处理器中修改标签体内容，只需在调用invoke方法时指定一个可取出结果数据的输出流对象（例如StringWriter），让标签体的执行结果输出到该输出流对象中，然后从该输出流对象中取出数据进行修改后再输出到目标设备，即可达到修改标签体的目的。
11.开发带属性的标签
自定义标签可以定义一个或多个属性，这样，在JSP页面中应用自定义标签时就可以设置这些属性的值，通过这些属性为标签处理器传递参数信息，从而提高标签的灵活性和复用性。
开发带属性的标签
要想让一个自定义标签具有属性，通常需要完成两个任务：
在标签处理器中编写每个属性对应的setter方法
在TLD文件中描术标签的属性
为自定义标签定义属性时，每个属性都必须按照JavaBean的属性命名方式，在标签处理器中定义属性名对应的setter方法，用来接收JSP页面调用自定义标签时传递进来的属性值。 例如属性url，在标签处理器类中就要定义相应的setUrl(String url)方法。
在标签处理器中定义相应的set方法后，JSP引擎在解析执行开始标签前，也就是调用doStartTag方法前，会调用set属性方法，为标签设置属性
12.打包自定义标签
把自定义的标签打到一个jar包中，就是要把标签处理类的字节码和标签库描述文件按照一定的存放方式添加到一个jar包中。具体做法如下。
把标签处理类字节码和标签库描述文件按如下所示的结构组织。
使用jar命令来创建jar文件：
jar cvf mytaglib_0.9.jar  META-INF  com
完成这两个步骤之后，一个自定义标签库jar包就打好了，可以把它添加到任何想使用这个标签库的Web应用程序的WEB-INF/lib目录下使用了。
13.自定义分页标签案例
分页标签的使用方式如下：
<q:pager pageNo="当前页号" pageSize="每页要显示的记录数" recordCount="总记录数" url="要跳转的URI" />
通过给这个标签传入当前页号、每页要显示的记录数、总记录数和要跳转的URI，这个标签就可以生成翻页的HTML元素。
标签处理类
这个标签只是通过指定属性值就可以生成所有的翻页元素，因此这个标签不需要主体，可以直接继承自TagSupport类：public class PagerTag extends TagSupport {...}
然后为这个标签定义4个属性，给它们提供setter方法，以便使用标签时，从外部传值进来。
最主要的逻辑实现都是在doStartTag()方法中，首先通过总记录数和每页要显示的记录数计算出总页数：
int pageCount = (recordCount + pageSize - 1) / pageSize;
编写要输出到响应的StringBuilder实例。
把请求对象中获取的所有请求参数都作为隐藏表单域(<input type=“hidden”>)生成到一个form表单中：
生成翻页的HTML元素。这一段逻辑稍微复杂一些。
生成“总记录数和总页数”
是否要显示“上一页”超链接的逻辑处理。
如果总页数超过5页，显示“…”
当前页和它附近页的显示处理
如果总页数比当前页数超过2页，显示“...”
是否要显示“下一页”超链接的逻辑处理
在标签库描述符文件描述这个标签的信息
在页面中使用该分页标签
用taglib指令引用该标签库描述文件：
<%@ taglib uri="http://blog.csdn.net/qjyong/tags/pager" prefix="q"%>
为该分页标签准备好一些样式，让翻页元素更美观：
用代码片段显示数据
调用分页标签
创建一个TestPagerTagServlet的Servlet，用来准备测试数据，并为分页标签准备好参数值，然后转发到测试页。
14.El表达式：
(1)El表达式简介：EL 全名为Expression Language。EL主要作用
获取数据：
EL表达式主要用于替换JSP页面中的脚本表达式，以从各种类型的web域 中检索java对象、获取数据。(某个web域 中的对象，访问javabean的属性、访问list集合、访问map集合、访问数组)
执行运算：
利用EL表达式可以在JSP页面中执行一些基本的关系运算、逻辑运算和算术运算，以在JSP页面中完成一些简单的逻辑运算。${user==null}
获取web开发常用对象
EL 表达式定义了一些隐式对象，利用这些隐式对象，web开发人员可以很轻松获得对web常用对象的引用，从而获得这些对象中的数据。
调用Java方法
EL表达式允许用户开发自定义EL函数，以在JSP页面中通过EL表达式调用Java类的方法。
(2)获取数据
使用EL表达式获取数据语法：“${标识符}”
EL表达式语句在执行时，会调用pageContext.findAttribute方法，用标识符为关键字，分别从page、request、session、application四个域中查找相应的对象，找到则返回相应对象，找不到则返回”” （注意，不是null，而是空字符串）。
示例：${user}
EL表达式也可以很轻松获取JavaBean的属性，或获取数组、Collection、Map类型集合的数据，例如：
${user.address.city}
${user.list[0]}：访问有序集合某个位置的元素
${map.key}  ： 获得map集合中指定key的值
结合JSTL的foreach标签，使用EL表达式也可以很轻松迭代各种类型的数组或集合，示例：
迭代数组
迭代collection类型集合
迭代map类型集合
(3)获得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对象
(4)El function开发步骤：
一般来说， EL自定义函数开发与应用包括以下三个步骤：
编写一个Java类的静态方法
编写标签库描述符（tld）文件，在tld文件中描述自定义函数。
在JSP页面中导入和使用自定义函数
注意事项：
(1)编写完标签库描述文件后，需要将它放置到<web应用>\WEB-INF目录中或WEB-INF目录下的除了classes和lib目录之外的任意子目录中。
(2)TLD文件中的<uri> 元素用指定该TLD文件的URI，在JSP文件中需要通过这个URI来引入该标签库描述文件。
(3)<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" %>
(5)El函数库
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函数将一个字符串中包含的所有字符转换为小写形式，并返回转换后的字符串，它接收一个字符串类型的参数，例如
fn:toLowerCase("Www.IT315.org") 的返回值为字符串“www.it315.org”
fn:toLowerCase("")的返回值为空字符串
fn:toUpperCase
fn:toUpperCase函数将一个字符串中包含的所有字符转换为大写形式，并返回转换后的字符串，它接收一个字符串类型的参数。例如：
fn:toUpperCase("Www.IT315.org") 的返回值为字符串“WWW.IT315.ORG”
fn:toUpperCase("")的返回值为空字符串
fn:trim
fn:trim函数删除一个字符串的首尾的空格，并返回删除空格后的结果字符串，它接收一个字符串类型的参数。需要注意的是，fn:trim函数不能删除字符串中间位置的空格。
例如，fn:trim("   www.it315.org  ") 的返回值为字符串“www.it 315.org”。
fn:length
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函数接收两个字符串类型的参数，第一个参数表示要分割的字符串，第二个参数表示作为分隔符的字符串。

例如，fn:split("www.it315.org", ".")[1]的返回值为字符串“it315”。
fn:join
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
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函数接收两个字符串类型的参数，如果第一个参数字符串中包含第二个参数字符串，则fn:contains函数返回true，否则返回false。如果第二个参数的值为空字符串，则fn:contains函数总是返回true。实际上，fn:contains(string, substring)等价于fn:indexOf(string, substring) != -1。

忽略大小的EL函数：fn:containsIgnoreCase
fn:startsWith
fn:startsWith函数用于检测一个字符串是否是以指定字符串开始的，返回值为布尔类型。

fn:startsWith函数接收两个字符串类型的参数，如果第一个参数字符串以第二个参数字符串开始，则函数返回true，否则函数返回false。如果第二个参数为空字符串，则fn:startsWith函数总是返回true。例如：

fn:startsWith("www.it315.org","it315")的返回值为false
fn:replace
fn:replace函数将一个字符串中包含的指定子字符串替换为其它的指定字符串，并返回替换后的结果字符串。fn:replace方法接收三个字符串类型的参数，第一个参数表示要操作的源字符串，第二个参数表示源字符串中要被替换的子字符串，第三个参数表示要被替换成的字符串。例如：

fn:replace("www it315 org", " ", ".")的返回值为字符串“www.it315.org”
fn:substring
fn:substring函数用于截取一个字符串的子字符串并返回截取到的子字符串。fn:substring函数接收三个参数，第一个参数是用于指定要操作的源字符串，第二个参数是用于指定截取子字符串开始的索引值，第三个参数是用于指定截取子字符串结束的索引值，第二个参数和第三个参数都是int类型，其值都从0开始。例如：

fn:substring("www.it315.org", 4, 9) 的返回值为字符串“it315”
fn:substringAfter
fn:substringAfter函数用于截取并返回一个字符串中的指定子字符串第一次出现之后的子字符串。fn:substringAfter函数接收两个字符串类型的参数，第一个参数表示要操作的源字符串，第二个参数表示指定的子字符串，例如：

fn:substringAfter(“www.it315.org”, “.”)的返回值为字符串“it315.org”。

与之对应的EL函数为：fn:substringBefore
15.Jsp标准标签库
(1)JSTL概述:
JSP标准标签库(JSP Standard Tag Library，JSTL)是实现Web应用程序中常见的通用功能的定制标签库集，程序员使用JSTL标签来避免在JSP页面中使用脚本。
在学习JSTL标签库之前，需要先下载JSTL所需要的JAR包。有两种获取方式
通过官方网站(http://www.apache.org/dist/jakarta/taglibs/standard)下载，获取API里面的jstl.jar、standard.jar。
使用MyEclipse自带的驱动包。使用MyEclipse创建Web工程时，选择“JSTL Support”选项。
(2)Core标签库
核心标签库主要包括通用标签、条件标签、迭代标签和与URL相关的标签。
在使用Core标签库的JSP文件的开始部分，添加代码：
<%@taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
通用标签：
<c:out>标签
用于将表达式的结果输出到当前的JspWriter对象中。其功能类似于JSP的表达式<%=  %>，或者EL表达式${}。
<c:set>标签
<c:set>标签用于设置JSP页面的各种域范围中的变量，或者设置java.util.Map对象或JavaBean对象的属性。
语法
<c:set value=“value” var=“name” [scope=“范围”]/>将value的值保存到名为name的变量中，同时name变量保存到选定的作用范围中。例如，
<c:set value=“sunwk” name=“username” scope=“session”/>
<c:remove>标签
<c:remove>标签用于移除JSP页面中指定域范围中的变量。
语法
<c:remove var=“name” [scope=“范围”]/>
<c:catch>标签
<c:catch>标签用于捕获嵌套在标签体内的内容抛出的异常对象，并将异常信息保存到变量中。
语法
<c:catch [var=“name”]>
body content
</c:catch>
将可能发生异常的代码放到该标签中，如果发生异常，异常信息保存到name变量中。
条件标签
<c:if>标签
<c:if>标签用来做条件判断，功能类似于JSP中的<%if(boolean){}%>。
<c:choose>、<c:when>、<c:otherwise>标签
<c:choose>标签用于提供条件选择的上下文，它必须与<c:when>和<c:otherwise>标签一起使用。
<c:when>作为<c:choose>的子标签，<c:when>有一个test属性，该属性的值为布尔型，如果test的值为true，则执行<c:when>标签体的内容。
<c:otherwise>标签没有属性，它必须作为<c:choose>标签的最后分支出现。
<c:choose>标签用于指定多个条件选择的组合边界，它必须与<c:when>和<c:otherwise>标签一起使用。使用<c:choose>，<c:when>和<c:otherwise>三个标签，可以构造类似 “if-else if-else” 的复杂条件判断结构。
迭代标签
<c:forEach>标签
<c:forEach>标签用于对包含了多个对象的集合进行迭代，重复执行它的标签体，或者重复迭代固定的次数。
<c:forTokens>标签
<c:forTokens>标签用来浏览一字符串中所有的成员，其成员是由定义符号(Delimiters)所分隔的。
URL相关的标签
<c:url>标签
<c:url>标签在JSP页面构造一个URL，它提供了3个功能元素，它们可以在URL前面附加当前Servlet上下文的名称；可以为会话管理重写URL；可以对请求参数名称和值进行URL编码，这些功能在为J2EE Web应用程序构造URL时特别有用。
<c:url>标签用于在JSP页面中构造一个URL地址，其主要目的是实现URL重写。URL重写就是将会话标识号以参数形式附加在URL地址后面
<c:redirect>标签
<c:redirect>标签用于向用户的浏览器发送HTTP重定向响应，它是JSTL中与 javax.servlet.http.HttpServletResponse的sendRedirect()方法功能相当的标记。
<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:param name="name" value="value" />