综述:可扩展标注语言(eXtensible Markup Language,XML)正被迅速的运用于业界,它已作为与平台、语言和协议无关的格式描述和交换数据的广泛应用标准。XML和它的辅助规范可用于描述数据的文档表现,描述XML文档类型的限制,描述XML文档和资源之间的链接,描述XML文档的自动转换和格式化。   如何开发自定义标签库? 
  我使用JSP和ASP编程已经有一段颇长的时间了,在两种服务器端的编程方式中,我越来越觉得JSP的功能要强大得多。不提别的,其中JSP的标签库就是我选择JSP作为首选服务器端Web应用开发工具的原因。为什么?因为:维护和开发的速度。在一个单一的服务器页面中,你可以混合使用各种不同的脚本方法和对象。就?quot;混凝土"一样,这种混合可令服务器端的脚本变得强大,并且让服务器端的编程者设计出非常灵活和动态的Web页面。不过这种自由的混合也有其缺点,那就是维护起来非常麻烦,特别是当项目逐渐变大时。由于最终的产品是经由一个传统的Web设计者来维护的,因此会带来问题。更糟糕的是,随着代码的复杂性增加,开发的速度就会变慢,不利于开发中等和大型的Web应用,一旦开发完,站点还要找合格的编程者来维护这些颇为复杂的代码。 
幸好,JSP提供了一个很好解决的办法。标签库提供了一个简单的方法来建立一个可重用的代码块。一旦标签库设计好,它就可以在许多项目中再次使用。更方便的是,与COM和J2EE不同,你无需学习任何其它的技巧就可以建立一个标签库!只要你懂得写JSP,你就可以建立一个标签库。标签库还可以改善Web应用的维护。这个是得益于JSP页面自定义标签的简单XML接口。这样,Web设计者甚至可以做到无需知道任何JSP的知识,就可以建立JSP的Web应用。这个开放式的Web开发对于团队运作是非常有效的。JSP编程者可以建立自定义的标签和后台的代码模块,而Web设计者可以使用自定义的标签来建立Web应用,并且将精力集中在Web设计上。 
  1. 标签库的定义 
   JSP标签库(也称自定义库)可看成是一套产生基于XML脚本的方法,它经由JavaBeans来支持。在概念上说,标签库是非常简单和可以重用的代码构造。
 执行XML/XSL转换的标签范例和HTML页面 
<%@ taglib uri=" http://www.jspinsider.com/jspkit/JAXP " prefix="JAXP"%> 
c:/xml/example.xml 
c:/xml/example.xsl 
  在这个例子中,通过使用简单的标签来访问后台更为强大的代码,一个XML被装载,并且通过一个XSL文件来产生一个结果,并发送给客户端,全部通过使用一个简单的标签调用就做到了。 
   自定义标签为在JSP项目中创建易于重用的代码打开了一扇大门。你所需要的只是标签库和它的文档说明。 
  2. 标签的组件 
   虽然标签库非常易于使用,不过要建立一个内里的设计来支持标签库是颇复杂的,起码要比建立一个简单的JavaBean复杂。这个复杂是来自于标签库是由几部分构成的。不过,你只需要知道Java和JSP的知识就够了。 
一个简单的标签由下面的元素构成: 
   ⑴ JavaBeans:为了得到Java与生具来的面向对象的好处,可重用的代码应该放到一个独立的代码容器中。这些JavaBeans并不是标签库的一部分。不过它是你的代码库用来执行相关任务的基本代码块。 
   ⑵ 标签处理:这是标签库的真正核心。一个标签处理器将引用它需要的任何资源(你的JavaBeans)和访问你的JSP页面的全部信息(pageContext对象)。JSP页面也会将所有已经被设置的标签属性和JSP页面上的标签体中的内容传送给标签处理器。在标签处理器处理完毕后,它将发回输出到你的JSP页面进行处理。 
   ⑶ 标签库的描述(tld文件):这是一个简单的XML文件,它记录着标签处理器的属性、信息和位置。JSP容器通过这个文件来得知从哪里及如何调用一个标签库。 
   ⑷ 网站的web.xml文件:这是你网站的初始化文件,在这个文件中,你定义了网站中用到的自定义标签,以及哪个tld文件用来描述每个自定义的标签。 
   ⑸ 分发文件(一个WAR或者JAR文件):如果你想重用自定义标签的话,你需要一个方法来将它由一个项目转移到另一个项目中。将标签库打包为一个JAR文件是一个简单而且有效的方式。 
⑹ 在你的JSP文件中作标签库声明:很简单,如果要用到该标签的话,只要在页面声明一下就可以,其后,你就可以在该JSP页面的任何地方使用它。 
   看来要做的工作很多,不过其实并不是很难。它的要点并不在于编码,而是在于如何将各部分正确地组织起来。不过,这样的分层是很重要的,它可令标签的使用灵活和更容易转移。更重要的是,这些层的存在可让处理建立标签的工程通过一个JSP IDE(JSP的集成开发环境)自动完成。期望将来的JSP IDE可自动完成创建一个自定义标签的大部分工作,这样你只需要写代码和标签处理就可以了。 
   注意:一个标签处理仅定义一个自定义标签;一个标签库是几个处理相同任务的标签处理器的集合。 
  3. 建立自己的标签 
   以下将一步一步地教你如何建立自定义的标签,具体的例子是扩展JSP,令它拥有自己的HTML编码功能。这个功能将所有的<和>字符用HTML代码来代替。它可以很容易地扩展为做其它的编码处理。为了简化,这个例子只解释了建立自定义标签的基本要素。 
   ⑴ 创建一个JavaBean 
   你代码中任何可重新使用的部分都应该放到一个JavaBean中。这个很重要,因为你要经常在项目的其它地方用到这些代码。放在标签处理器中的任何代码在标签外都是不可以重新使用的,因此将可重用的代码部分独立开来是很重要的。在这个例子总,为HTML编码的逻辑是常用的,因此放到JavaBean中。 
   ⑵ HTML编码JavaBean 
/* HTML_Format.Java */ 
public class HTML_Format extends Object implements Java.io.Serializable { 
/** 创建新的HTML_Format */ 
public HTML_Format() {} 
/** 将一个字符串中所有的所有 < 和 > 字符用响应的HTML编码代替 */ 
public String HTML_Encode(String as_data) 
{ 
int li_len = as_data.length(); 
/*string buffer的长度要比原来的字符串长*/ 
StringBuffer lsb_encode = new StringBuffer(li_len + (li_len/10)); 
/* 循环替换全部的< 和 > 字符 */ 
for( int li_count = 0 ; li_count < li_len ; li_count++) 
{ String ls_next = String.valueOf(as_data.charAt(li_count)); 
if (ls_next.equals("<")) ls_next = "<"; 
if (ls_next.equals(">")) ls_next = ">"; 
lsb_encode.append( ls_next ); 
} 
return( lsb_encode.toString() ); 
} 
} 
  ⑶ 创建一个标签处理器 
   标签处理器使用以下的代码: 
HTML编码标签处理器 
import Java.io.IOException; 
import Javax.servlet.jsp.*; 
import Javax.servlet.jsp.tagext.*; 
public class HTML_FormatTag extends BodyTagSupport 
{ 
/* 1} 在标签末将会调用这个函数 */ 
public int doEndTag() throws JspTagException 
{ 
try 
{ /* 2}得到标签中的文本 */ 
BodyContent l_tagbody = getBodyContent(); 
String ls_output = ""; 
/* 3}如果标签体有文本,就处理它 */ 
if(l_tagbody != null) 
{ HTML_Format l_format = new HTML_Format(); 
/* 3a} 将标签体的内容转换为一个字符串 */ 
String ls_html_text = l_tagbody.getString(); 
ls_output = l_format.HTML_Encode(ls_html_text); 
} 
/* 4}将结果写回到数据流中 */ 
pageContext.getOut().write(ls_output.trim()); 
} 
catch (IOException e) 
{ throw new JspTagException("Tag Error:" + e.toString()); 
} 
/* 让JSP继续处理以下页面的内容 */ 
return EVAL_PAGE; 
} 
} 
  这个处理很简单,它包括有: 
   o 读入标签开始和结束间的文本 
   o 调用html编码函数 
   o 返回结果到JSP页面。 
   ⑷ 创建一个标签描述器 
   需要描述自定义标签以让系统知道如何处理。该描述文件的后缀为.tld,通常它的名字和标签处理器相同,并存放在"/WEB-INF/"目录。 
HTML编码标签描述器 
<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE taglib 
PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN" 
" http://Java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd "> 
<TAGLIB> 
<TLIBVERSION>1.0</TLIBVERSION> 
<JSPVERSION>1.1</JSPVERSION> 
<SHORTNAME>HTML_FormatTag</SHORTNAME> 
<URI></URI> 
<INFO>HTML Encoding Tag </INFO> 
<TAG> 
<NAME>HTMLEncode</NAME> 
<TAGCLASS>HTML_FormatTag</TAGCLASS> 
<INFO>Encode HTML</INFO> 
</TAG> 
</TAGLIB> 
  ⑸ 更新Web XML文件 
   现在可告诉JSP容器使用标签库。为此要修改web.xml文件,具体说来是要在其中加入一个taglib的项目来注册该标签库。最重要的是,要为tag分配一个URI。URI是一个唯一的引用,只应用在该网站的这个特别的标签上。使用全长的URL或者包名是一个好的习惯,它可以确保唯一性,因为该标签可以在不同的网站使用。这个例子是简化了。 
修改web.xml文件 
<?xml version="1.0" encoding="ISO-8859-1"?> 
<!DOCTYPE web-app 
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN" 
" http://Java.sun.com/j2ee/dtds/web-app_2.2.dtd "> 
<WEB-APP> 
<TAGLIB> 
<TAGLIB-URI> 
HTMLEncode 
</TAGLIB-URI> 
<TAGLIB-LOCATION> 
/WEB-INF/HTML_FormatTag.tld 
</TAGLIB-LOCATION> 
</TAGLIB> 
</WEB-APP> 
  ⑹ 使用新的标签 
   自定义的标签已经设置好,可以用在一个JSP页面上。要做到这一点,只需在该页面使用taglib指示命令声明一下该标签就可以了,该标签通过它唯一的URI被引用,并且会被分配一个名字空间前缀。前缀可以任意,只要它不与其它的名字空间冲突便可。 
   在一个JSP页面上使用HTML编码标签: 
<%@ taglib uri="HTMLEncode" prefix="Examples" %> 
<PRE> 
<?XML:NAMESPACE PREFIX = Examples /><Examples:HTMLEncode> 
< Hello , Simple sample > 
</Examples:HTMLEncode> 
</PRE> 
范例代码的输出 
< Hello , Simple sample > 
which displays as: 
< Hello , Simple sample > 
  通过这个标签,我就将该页面的所有代码编码了。有趣的是所有的自定义标签都是在服务器上处理的。这意味着你将不会在输出的页面上看到自定义的标签。 
   建立一个标签不是很难吧。最困难的部分是要学习标签处理的所有细节。这是一个很强大的功能,我们只是提到了最基本的地方。由于这个处理需要几步,新的JSP编程者在创建标签时将会感到迷惑。 
  如何利用JSP开发DOM应用? 
  DOM是Document Object Model的缩写,即文档对象模型。XML将数据组织为一颗树,所以DOM就是对这颗树的一个对象描叙。通俗的说,就是通过解析XML文档,为XML文档在逻辑上建立一个树模型,树的节点是一个个对象。我们通过存取这些对象就能够存取XML文档的内容。 
   下面我们来看一个简单的例子,看看在DOM中,我们是如何来操作一个XML文档的。这是一个XML文档,也是我们要操作的对象: 
<?xml version="1.0" encoding="UTF-8"?> 
<messages> 
<message>Good-bye serialization, hello Java!</message> 
</messages> 
  下面,我们需要把这个文档的内容解析到一个个的Java对象中去供程序使用,利用JAXP,我们只需几行代码就能做到这一点。首先,我们需要建立一个解析器工厂,以利用这个工厂来获得一个具体的解析器对象: 
   DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance(); 
   我们在这里使用DocumentBuilderFacotry的目的是为了创建与具体解析器无关的程序,当DocumentBuilderFactory类的静态方法newInstance()被调用时,它根据一个系统变量来决定具体使用哪一个解析器。又因为所有的解析器都服从于JAXP所定义的接口,所以无论具体使用哪一个解析器,代码都是一样的。所以当在不同的解析器之间进行切换时,只需要更改系统变量的值,而不用更改任何代码。这就是工厂所带来的好处。 
   DocumentBuilder db = dbf.newDocumentBuilder(); 
当获得一个工厂对象后,使用它的静态方法newDocumentBuilder()方法可以获得一个DocumentBuilder对象,这个对象代表了具体的DOM解析器。但具体是哪一种解析器,微软的或者IBM的,对于程序而言并不重要。 
   然后,我们就可以利用这个解析器来对XML文档进行解析了: 
   Document doc = db.parse("c:/xml/message.xml"); 
   DocumentBuilder的parse()方法接受一个XML文档名作为输入参数,返回一个Document对象,这个Document对象就代表了一个XML文档的树模型。以后所有的对XML文档的操作,都与解析器无关,直接在这个Document对象上进行操作就可以了。而具体对Document操作的方法,就是由DOM所定义的了。 
   从得到的Document对象开始,我们就可以开始我们的DOM之旅了。使用Document对象的getElementsByTagName()方法,我们可以得到一个NodeList对象,一个Node对象代表了一个XML文档中的一个标签元素,而NodeList对象,观其名而知其意,所代表的是一个Node对象的列表: 
   NodeList nl = doc.getElementsByTagName("message"); 
   我们通过这样一条语句所得到的是XML文档中所有<message>标签对应的Node对象的 
   一个列表。然后,我们可以使用NodeList对象的item()方法来得到列表中的每一个Node对象: 
   Node my_node = nl.item(0); 
   当一个Node对象被建立之后,保存在XML文档中的数据就被提取出来并封装在这个Node中了。在这个例子中,要提取Message标签内的内容,我们通常会使用Node对象的getNodeValue()方法: 
String message = my_node.getFirstChild().getNodeValue(); 
   请注意,这里还使用了一个getFirstChild()方法来获得message下面的第一个子Node对象。虽然在message标签下面除了文本外并没有其它子标签或者属性,但是我们坚持在这里使用getFirseChild()方法,这主要和W3C对DOM的定义有关。W3C把标签内的文本部分也定义成一个Node,所以先要得到代表文本的那个Node,我们才能够使用getNodeValue()来获取文本的内容。现在,既然我们已经能够从XML文件中提取出数据了,我们就可以把这些数据用在合适的地方,来构筑应用程序。 
DOM实例 
  先说说这个例子到底要做的是什么吧,我们在一个名为link.xml文件中保存了一些URL地址,我们希望可以通过DOM把这些URL读出并显示出来,也可以反过来向这个XML文件中写入加入的URL地址。很简单,却很实用,也足够来例示DOM的绝大部分用法了。 
   第一个程序我们称为xmldisplay.Java,主要的功能就是读取这个XML文件中各个节点的内容,然后在格式化输出在System.out上,我们来看看这个程序: 
import Javax.xml.parsers.*; 
import org.w3c.dom.*; 
  这是引入必要的类,因为在这里使用的是Sun所提供的XML解析器,因而需要引入Java.xml.parsers包,其中包含了有DOM解析器和SAX解析器的具体实现。org.w3c.dom包中定义了w3c所制定的DOM接口。 
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance(); 
DocumentBuilder builder=factory.newDocumentBuilder(); 
Document doc=builder.parse("links.xml"); 
doc.normalize(); 
  除了上面讲到的,还有一个小技巧,对Document对象调用normalize(),可以去掉XML文档中作为格式化内容的空白而映射在DOM树中的不必要的Text Node对象。否则你得到的DOM树可能并不如你所想象的那样。特别是在输出的时候,这个normalize()更为有用。 
  NodeList links =doc.getElementsByTagName("link"); 
  刚才说过,XML文档中的空白符也会被作为对象映射在DOM树中。因而,直接调用Node方法的getChildNodes方法有时候会有些问题,有时不能够返回所期望的NodeList对象。解决的办法是使用Element的getElementByTagName(String),返回的NodeLise就是所期待的对象了。然后,可以用item()方法提取想要的元素。 
for (int i=0;i<links.getLength();i++){ 
Element link=(Element) links.item(i); 
System.out.print("Content: "); 
System.out.println(link.getElementsByTagName("text").item(0).getFirstChild(); 
.getNodeValue()); 
…… 
  上面的代码片断就完成了对XML文档内容的格式化输出。只要注意到一些细节的问题,比如getFirstChile()方法和getElementsByTagName()方法的使用,这些还是比较容易的。 
下面的内容,就是在修改了DOM树后重新写入到XML文档中去的问题了。这个程序名为xmlwrite.Java。在JAXP1.0版本中,并没有直接的类和方法能够处理XML文档的写入问题,需要借助其它包中的一些辅助类。而在JAXP1.1版本中,引入了对XSLT的支持,所谓XSLT,就是对XML文档进行变换(Translation)后,得到一个新的文档结构。利用这个新加入的功能,我们就能够很方便的把新生成或者修改后的DOM树从新写回到XML文件中去了,下面我们来看看代码的实现,这段代码的主要功能是向links.xml文件中加入一个新的link节点: 
import Javax.xml.parsers.*; 
import Javax.xml.transform.*; 
import Javax.xml.transform.dom.DOMSource; 
import Javax.xml.transform.stream.StreamResult; 
import org.w3c.dom.*; 
  新引入的Java.xml.transform包中的几个类,就是用来处理XSLT变换的。 
我们希望在上面的XML文件中加入一个新的link节点,因而首先还是要读入links.xml文件,构建一个DOM树,然后再对这个DOM树进行修改(添加节点),最后把修改后的DOM写回到links.xml文件中: 
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance(); 
DocumentBuilder builder=factory.newDocumentBuilder(); 
Document doc=builder.parse("links.xml"); 
doc.normalize(); 
//---取得变量---- 
String text="Hanzhong's Homepage"; 
String url=" www.hzliu.com "; 
String author="Hzliu Liu"; 
String discription="A site from Hanzhong Liu, give u lots of suprise!!!"; 
  为了看清重点,简化程序,我们把要加入的内容硬编码到记忆String对象中,而实际操作中,往往利用一个界面来提取用户输入,或者通过JDBC从数据库中提取想要的内容。 
Text textseg; 
Element link=doc.createElement("link"); 
  首先应该明了的是,无论什么类型的Node,Text型的也好,Attr型的也好,Element型的也好,它们的创建都是通过Document对象中的createXXX()方法来创建的(XXX代表具体要创建的类型),因此,我们要向XML文档中添加一个link项目,首先要创建一个link对象: 
Element linktext=doc.createElement("text"); 
textseg=doc.createTextNode(text); 
linktext.appendChild(textseg); 
link.appendChild(linktext); 
…… 
  创建节点的过程可能有些千篇一律,但需要注意的地方是,对Element中所包含的text(在DOM中,这些text也是代表了一个Node的,因此也必须为它们创建相应的node),不能直接用Element对象的setNodeValue()方法来设置这些text的内容,而需要用创建的Text对象的setNodeValue()方法来设置文本,这样才能够把创建的Element和其文本内容添加到DOM树中。看看前面的代码,你会更好的理解这一点: 
doc.getDocumentElement().appendChild(link); 
   最后,不要忘记把创建好的节点添加到DOM树中。Document类的getDocumentElement()方法,返回代表文档根节点的Element对象。在XML文档中,根节点一定是唯一的。 
TransformerFactory tFactory =TransformerFactory.newInstance(); 
Transformer transformer = tFactory.newTransformer(); 
DOMSource source = new DOMSource(doc); 
StreamResult result = new StreamResult(new Java.io.File("links.xml")); 
transformer.transform(source, result); 
  然后就是用XSLT把DOM树输出了。这里的TransformerFactory也同样应用了工厂模式,使得具体的代码同具体的变换器无关。实现的方法和DocumentBuilderFactory相同,这儿就不赘述了。Transformer类的transfrom方法接受两个参数、一个数据源Source和一个输出目标Result。这里分别使用的是DOMSource和StreamResult,这样就能够把DOM的内容输出到一个输出流中,当这个输出流是一个文件的时候,DOM的内容就被写入到文件中去了。 
  如何利用JSP开发SAX应用? 
  SAX是Simple API for XML的缩写,它并不是由W3C官方所提出的标准,可以说是"民间"的事实标准。实际上,它是一种社区性质的讨论产物。虽然如此,在XML中对SAX的应用丝毫不比DOM少,几乎所有的XML解析器都会支持它。 
   这样泛泛的说来或许有些不容易理解,别急,后面的例子会让你明白SAX的解析过程。看看这个简单XML文件: 
<POEM> 
<AUTHOR>Ogden Nash</AUTHOR>