標簽庫(JSP)
標簽庫的提出
JSP是一種功能強大的WEB應用服務器端編程技術,與傳統CGI編程語言響應請求再輸出靜態HTML不同的是,JSP從靜態HTML開始並把JAVA代碼散佈在HTML中。當編寫小型的應用程序時,HTML標記與JAVA代碼數量都不大,程序的可讀性和維護不是問題。但是建立中大型應用程序時,HTML標記與JAVA代碼大量的交替夾雜一起,使程序變得不可維護。程序員不得不在HTML中尋找JAVA代碼,而界面設計師要修改網頁界面變得不可能。這樣效率將非常低下。 標簽庫的運用將以上的問題很好地得到解決,它更清晰地分離了業務邏輯和表示細節。Servlet和JavaBean處理業務邏輯,JSP頁面作為一個顯示組件。標簽庫就成了業處邏輯處理到JSP頁面的橋梁。標簽庫的使用程序員更專注於編寫程序代碼,而界面設計師專員於界面布局及美工。
標簽庫的組成● 標記定義 ● taglib指令 ● 標記庫描述文件(*.tld) ● 標記處理程序
標簽庫定義的格式標簽庫的定義包括二種可能的格式: ● <prefix:tagName [attr=”value”] *>tagbody</prefix:tagName> ● <prefix:tagName [attr=”value”] *></prefix:tagName>或<prefix:tagName [attr=”value”] */>
perfix表示標簽前綴,tagName標簽名,attr=”value”屬性及屬性值,tagbody標簽主體。 前一格式包含主體,後一種不包含。 taglib指令<%@ taglib uri=”URI TO TAG” prefix=”tag prefis”%> taglib指令通知JSP容器頁面使用了一個標簽庫。該指今在JSP頁面的頂部指定標簽庫描述文件的uri,prefix定義標簽的前綴。 如: <%@ taglib uri="/taglib" prefix="test"%> 在頁面的其它位置即可這樣使用: <test:testtaglib name="testString" type="String"/> name、type是標簽的二個屬性。
標記庫描述文件標記描述文件(Tag Library Descriptor,tld)是一個XML文檔。格式如下: <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN" "http://java./j2ee/dtds/web-jsptaglibrary_1_1.dtd"> <taglib>
<jspversion>1.1</jspversion> <shortname>Application Tag Library</shortname>
<tag> <name>testtaglib</name> <tagclass>com.shingwai.taglib.TestTag</tagclass> <teiclass>com.shingwai.taglib.TestTEI</teiclass>
<info></info> <attribute>
<required>true</required> <rtexprvalue>false</rtexprvalue> </attribute> <attribute> <name>type</name> <required>true</required> <rtexprvalue>false</rtexprvalue> </attribute> </tag> </taglib>
該文件以.tld為後綴,與程序的web.xml存放在一起。 Web.xml聲明標簽庫 <taglib> <taglib-uri>/hello</taglib-uri> <taglib-location>/WEB-INF/hello_tag.tld</taglib-location> </taglib>
標簽處理程序你可以在標簽庫描述文件中使用<tagclass>元素來指定標簽的處理程序。 標簽處理程序是實現了JAVA接口的JavaBean組件,可以使用下面兩種接口來定義標簽處理程序: javax.servlet.jsp.tagext.Tag 處接口處理不含標簽主體的簡單標簽。 javax.servlet.jsp.tagext.BodyTag 可以訪問標簽主體。 (注意:一个标签处理器仅定义一个标签;一个标签库是几个处理相同任务的标签处理器的集合) Tag接口中的主要方法 doStratTag() 該方法處理標簽的開始標記 它有三個可能的返回值: EVAL_BODY_INCLUED 處理標記主體,但不允許標簽處理程序操縱它。這樣的處理程序實現Tag接口,並且不能實現BodyTag接口。 EVAL_BODY_TAG 處理標記主體並且允許處理程序通過一個新的對象來操縱它。必須實現BodyTag接口。 SKIP_BODY 不處理標記主體
doEndTag() 該方法處理標簽的結束標記 它有二個可能的返回值: EVAL_PAGE 繼續計算JSP頁面的其余部分。 SKIP_PAGE 跳過JSP頁面的其余部分,以完成請求。
getParent() 獲得直接的父標記 BodyTag接口中的主要方法 doInitBody()初始化主體處理,可能是為了獲得數據庫,如果doStartTag方法返回EVAL_BODY_AGAIN,那麼程序調用一次該方法,如果doStartTag方法返回SKIP_BODY,那麼程序不調用該方法。
TagExtraInfo類在tld文件中你使用<teiclass>元素來指定該類,用來得到標簽中的屬性和值。 JSP容器在TagExtraInfo類上調用getVariableInfo()方法,當調用這個方法時,它將傳遞一個javax.servler.jsp.tagext.TagData對象,這個對象包含可識別的[屬性、值]對。這個屬性、值即是JSP頁面定義標簽庫時的定義的標簽屬性和值(attr=”value”)。 getVariableInfo()方法返回一個VariableInfo對象組,每個對象需要四個參數。TagData對象中屬性的值、變量的類型、boolean值、作用域。 三個作用域 1、NESTED 定義變量的操作在開始標記和結束標記使用該變量 2、AT_BEGIN D 操作在開始標記到頁面結束使用該變量 3、AT_END 操作在結束標記到頁面結束使用該變量
實例一:第一個“你好”目的:用標簽庫在JSP頁面顯示一個字符串“你好!”。 實現步驟:
1、Jbuilder新建工程。 2、建立包名:com.shingwai.taglib 3、編寫標簽處理程序 HelloTag.java 代碼如下: package com.shingwai.taglib; import javax.servlet.jsp.*; import javax.servlet.jsp.tagext.*;
public class HelloTag extends TagSupport{ private String str="你好!";
JspWriter writer=pageContext.getOut(); try{ writer.write(str); } catch(Exception e){ e.printStackTrace(); } return TagSupport.SKIP_BODY; } }
4、編寫標簽庫描術文件 hello_tag.tld 保存於程序的WEB-INF文件夾。 代碼如下: <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN" "http://java./j2ee/dtds/web-jsptaglibrary_1_1.dtd"> <taglib> <tlibversion>1.0</tlibversion> <jspversion>1.1</jspversion> <shortname>Application Tag Library</shortname>
<tag>
<tagclass>com.shingwai.taglib.HelloTag</tagclass> </tag> </taglib>
5、編寫應用程序初始化文件web.xml 加入如下代碼: <taglib> <taglib-uri>/hello</taglib-uri> <taglib-location>/WEB-INF/hello_tag.tld</taglib-location> </taglib>
6、建立JSP頁面:hello.jsp 代碼如下: <%@ page contentType="text/html; charset=Big5" %>
<html> <head> <title>hello</title> </head> <body bgcolor="#ffffff">
<test:hello/> </h1> </body> </html>
7、發佈程序訪問顯示如下:
實例二:帶屬性的標簽庫目的:當屬性color的為“red”時輸出紅色的“你好!”,當屬性color的值為“blue”時輸了為藍色的“你好!”。 1、編寫TEI類。HelloColorTEI.java 代碼如下: package com.shingwai.taglib; import javax.servlet.jsp.tagext.*;
public class HelloColorTEI extends TagExtraInfo{ public VariableInfo[] getVariableIfob(TagData data){ VariableInfo info1=new VariableInfo(data.getAttributeString("color"),"String",true,VariableInfo.NESTED); VariableInfo[] info={info1}; return info; } } 2、編寫標簽處理程序HelloColorTag.java 代碼如下: package com.shingwai.taglib; import javax.servlet.jsp.*; import javax.servlet.jsp.tagext.*; public class HelloColorTag extends TagSupport{ private String c; private String color=null; public void setColor(String color){ this.color=color; } public int doEndTag()throws JspException{ JspWriter writer=pageContext.getOut(); c=this.color; try{ writer.write("<font color=‘"+c+"‘>你好!</font>"); } catch(Exception e){ e.printStackTrace(); } return TagSupport.EVAL_PAGE; } }
3、在標簽庫描術文件 hello_tag.tld 中加入XML標識如下: <tag> <name>hellocolor</name> <tagclass>com.shingwai.taglib.HelloColorTag</tagclass> <teiclass>com.shingwai.taglib.HelloColorTEI</teiclass> <attribute> <name>color</name> <required>true</required> <rtexprvalue>false</rtexprvalue> </attribute> </tag>
4、hello.jsp代碼如下: <%@ page contentType="text/html; charset=Big5" %> <%@ taglib uri="/hello" prefix="test"%> <html><head> <title>hello</title> </head> <body bgcolor="#ffffff"> <h1> <test:hellocolor color="red"/><br> <test:hellocolor color="blue"/> </h1> </body> </html> 5、發佈訪問文件hello.jsp
實例三:有標簽主體的標簽庫目的:把標簽開始標記到結束標記內(即標簽主體的內容)的文字顏色設為紅色輸出。 1、標簽處理程序BodyTag.java 代碼如下: package com.shingwai.taglib; import javax.servlet.jsp.tagext.*; import javax.servlet.jsp.*;
public class BodyTag extends BodyTagSupport{ private String b=""; public int doStartTag()throws JspException{ return TagSupport.EVAL_BODY_AGAIN;//處理標記主體並可操縱它 } public int doAfterBody()throws JspException{ BodyContent body=getBodyContent();//得到主體內容 String b=body.getString(); try{ JspWriter out=body.getEnclosingWriter();//返回BodyContent的JspWriter方法 out.print("<font color=‘red‘>"+b+"</font>");//寫出數據 } catch(Exception e){ e.printStackTrace(); } return TagSupport.SKIP_BODY; } public int doEndTag()throws JspException{ return TagSupport.EVAL_PAGE; } public void release(){
} }
2、編寫描述文檔 body_tag.tld <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN" "http://java./j2ee/dtds/web-jsptaglibrary_1_1.dtd"> <taglib> <tlibversion>1.0</tlibversion> <jspversion>1.1</jspversion> <shortname>Application Tag Library</shortname> <info></info> <tag> <name>boby</name> <tagclass>com.shingwai.taglib.BodyTag</tagclass> <bodycontent>jsp</bodycontent> <info></info> </tag> </taglib>
3、在web.xml 中聲明標簽庫,加入如下代碼。
<taglib> <taglib-uri>/body</taglib-uri> <taglib-location>/WEB-INF/body_tag.tld</taglib-location> </taglib>
4、Jsp文件 bodytag.jsp <%@ page contentType="text/html; charset=Big5" %> <%@ taglib uri="/body" prefix="body"%> <html><head> <title>bodytag</title> </head> <body bgcolor="#ffffff"> <h1> <body:boby> 電腦部同仁好! </body:boby> </h1> </body> </html>
5、發布訪問bodytag.jsp,輸出紅色文字。
實例四:嵌套标记說明:可以对多个JSP标记进行嵌套引用,这样子标记就可以访问和存储父标记的数据和方法。子标记访问父标记需要使用BodyTagSupport类中的 findAccetorWithClass方法。注意它只能查找临近的父标记。
目的:父標簽裡定義的字符串變量在子標簽中輸出。
<p:parent>
</p:parent>
1、編寫父標簽處理程序ParentTag.java package com.shingwai.taglib; import javax.servlet.jsp.tagext.*; import javax.servlet.jsp.*;
public class ParentTag extends BodyTagSupport{ private String name=""; private String email=""; public void setName(String name){ this.name=name; } public String getName(){ return name; } public void setEmail(String email){ this.email=email; } public String getEmail(){ return email; } public int doStartTag()throws JspException{ this.setName("李小明"); this.setEmail("lixiaomeng@163.com"); return TagSupport.EVAL_BODY_INCLUDE; } public int doEndTag()throws JspException{ return TagSupport.EVAL_PAGE; } }
2、編寫子標簽處理程序SonTag.java package com.shingwai.taglib; import javax.servlet.jsp.*; import javax.servlet.jsp.tagext.*;
public class SonTag extends TagSupport{ public int doStartTag()throws JspException{//處理開始標記 ParentTag parent=(ParentTag)findAncestorWithClass(this,com.shingwai.taglib.ParentTag.class);//取父標簽的對象,等同ParentTag parent=(ParentTag)getParent(); JspWriter writer = pageContext.getOut(); try { writer.write(parent.getName());//訪問父標簽的方法,輸出值 } catch (Exception e) { e.printStackTrace(); } return TagSupport.EVAL_BODY_AGAIN; } public int doEndTag()throws JspException{//處理結束標記 ParentTag parent=(ParentTag)findAncestorWithClass(this,com.shingwai.taglib.ParentTag.class); JspWriter writer = pageContext.getOut(); try { writer.write(parent.getEmail()); } catch (Exception e) { e.printStackTrace(); } return TagSupport.EVAL_PAGE; } }
3、描述符文件 parent_tag.tld <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN" "http://java./j2ee/dtds/web-jsptaglibrary_1_1.dtd"> <taglib> <tlibversion>1.0</tlibversion> <jspversion>1.1</jspversion> <shortname>Application Tag Library</shortname> <info></info> <tag> <name>parent</name> <tagclass>com.shingwai.taglib.ParentTag</tagclass> </tag> <tag> <name>son</name> <tagclass>com.shingwai.taglib.SonTag</tagclass> </tag> </taglib>
4、明標簽庫 web.xml 增加如下代碼: <taglib> <taglib-uri>/parent</taglib-uri> <taglib-location>/WEB-INF/parent_tag.tld</taglib-location> </taglib>
5、JSP頁面編寫:parent.jsp <%@ page contentType="text/html; charset=Big5" %> <%@ taglib uri="/parent" prefix="p"%> <html><head> <title>parent</title> </head> <body bgcolor="#ffffff"> <h1> <p:parent> <p:son><br> </p:son> </p:parent> </h1> </body> </html>
6、發佈該問parent.jsp
|
|