ContentHandler是Java類包中一個特殊的SAX接口，位于org.xml.sax包中。該接口封裝了一些對事件處理的方法，當(dāng)XML解析器開始解析XML輸入文檔時，它會遇到某些特殊的事件，比如文檔的開頭和結(jié)束、元素開頭和結(jié)束、以及元素中的字符數(shù)據(jù)等事件。當(dāng)遇到這些事件時，XML解析器會調(diào)用ContentHandler接口中相應(yīng)的方法來響應(yīng)該事件。ContentHandler接口的方法有以下幾種：

l void startDocument()方法：接收文檔開始的通知，SAX解析器僅調(diào)用該方法一次。

l void endDocument()方法：接收文檔結(jié)尾的通知，SAX解析器僅調(diào)用該方法一次，并且它將是解析期間最后調(diào)用的方法。直到解析器放棄解析(由于不可恢復(fù)的錯誤)或到達(dá)輸入的結(jié)尾時，該方法才會被調(diào)用。

l void startElement(String uri, String localName, String qName, Attributes atts)方法：接收元素開始的通知。該方法的參數(shù)信息如下：

uri：名稱空間URI，如果元素沒有名稱空間URI，如果未執(zhí)行名稱空間處理，則為空字符串。

localName：本地名稱(不帶前綴)，如果未執(zhí)行命名空間處理，則為空字符串。

qName：元素名(帶有前綴)，如果元素名不可用，則為空字符串。

atts：該元素的屬性。如果沒有屬性，則它將是空Attributes對象。在startElement返回后，此對象的值是未定義的。

l void endElement(String uri, String localName, String qName)方法：接收元素結(jié)束的通知。該方法的參數(shù)含義與startElement()方法的參數(shù)含義一致。

l void characters(char[ ] ch, int start, int length)方法：接收字符數(shù)據(jù)的通知。該方法的參數(shù)信息如下：

ch：字符數(shù)組，來自XML文檔中的字符串?dāng)?shù)據(jù)。

start：數(shù)組中的開始位置

length：從數(shù)組中讀取的字符的個數(shù)

l void ignorableWhitespace(char[ ] ch, int start, int length)方法：接收元素內(nèi)容中可忽略的空白通知。該方法的參數(shù)含義與characters()方法的參數(shù)含義一致。

l void startPrefixMapping(String prefix, String uri)方法：開始標(biāo)記的前綴URI名稱空間范圍映射。該方法的參數(shù)信息如下：

prefix：聲明的名稱空間前綴。對于沒有前綴的默認(rèn)元素名稱空間，使用空字符串。

uri：將前綴映射到的名稱空間URI。

l void endPrefixMapping(String prefix)方法：結(jié)束標(biāo)記的前綴URI名稱空間范圍的映射。

l void setDocumentLocator(Locator locator)方法：接收用來查找SAX文檔事件起源的對象。如果要使用SAX解析器來提供定位器，則必須在調(diào)用ContentHandler接口中的任何其他方法之前調(diào)用該方法，為應(yīng)用程序提供定位器。

l void ignorableWhitespace(char[ ] ch, int start, int length)方法：接收元素內(nèi)容中可忽略的空白的通知。

l void processingInstruction(String target, String data)方法：接收處理指令的通知。

l void skippedEntity(String name)方法：接收跳過的實體的通知。

下面我們來看一個簡單的例子：

import org.xml.sax.*;
import org.xml.sax.ContentHandler;
public class SAXExample1 implements ContentHandler{
public void setDocumentLocator(Locator locator){
System.out.println(”執(zhí)行setDocumentLocator()方法?。　?;
}
public void startDocument( ) throws SAXException{
System.out.println(”執(zhí)行startDocument( )方法??！“);
}
public void endDocument() throws SAXException{
System.out.println(”執(zhí)行endDocument( )方法！！“);
}
public void startPrefixMapping(String prefix, String uri)
throws SAXException{
System.out.println(”執(zhí)行startPrefixMapping( )方法！！“);
}
public void endPrefixMapping(String prefix) throws SAXException{
System.out.println(”執(zhí)行endPrefixMapping( )方法??！“);
}
public void startElement(String uri, String localName,
String qName, Attributes atts) throws SAXException {
System.out.println(”執(zhí)行startElement( )方法！！“);
}
public void endElement(String uri, String localName, String qName)
throws SAXException{
System.out.println(”執(zhí)行endElement( )方法??！“);
}
public void characters(char[ ] ch, int start, int length)
throws SAXException{
System.out.println(”執(zhí)行characters( )方法！！“);
}
public void ignorableWhitespace(char[ ] ch, int start, int length)
throws SAXException{
System.out.println(”執(zhí)行ignorableWhitespace( )方法??！“);
}
public void processingInstruction(String target, String data)
throws SAXException{
System.out.println(”執(zhí)行processingInstruction( )方法！！“);
}
public void skippedEntity(String name) throws SAXException{
System.out.println(”執(zhí)行skippedEntity( )方法??！“);
}
}

在例中SAXExample1類實現(xiàn)了ContentHandler接口，并重寫了該接口的所有方法。但在這些方法中，我們采取了簡單的實現(xiàn)。主要是想讓大家了解這些方法的執(zhí)行順序和過程。

然后創(chuàng)建一個簡單的XML文檔，XML文檔(test1.xml)代碼如下：

<?xml version=”1.0″ encoding=”UTF-8″?>
<student id=”a001″>
this is a test
<name>zhangsan</name>
</student>

最后再做一個測試類（TestSax.java）用來創(chuàng)建解析器，并將這些事件處理程序分配給該解析器，程序代碼如下：

import org.xml.sax.*;
import org.xml.sax.helpers.*;
public class TestSax{
public static void main(String args[ ]){
try {
// 建立SAX 2解析器．．．
XMLReader parser=XMLReaderFactory.createXMLReader();
// 安裝ContentHandler．．．
parser.setContentHandler(new SAXExample1());
//解析文件．．．
parser.parse(”test1.xml”);
}catch ( Exception e ) {
e.printStackTrace();
}
}
}

import org.xml.sax.*;
import java.io.*;
import org.xml.sax.ContentHandler;
public class SAXExample2 implements ContentHandler{
public void setDocumentLocator(Locator locator){
System.out.println(”查找文檔完成！“);
}
public void startDocument() throws SAXException{
System.out.println(”開始解析！“);
}
public void endDocument() throws SAXException{
System.out.println(”解析完成！“);
}
public void startPrefixMapping(String prefix, String uri)
throws SAXException{
System.out.println(”執(zhí)行startPrefixMapping()方法??！“);
}
public void endPrefixMapping(String prefix) throws SAXException{
System.out.println(”執(zhí)行endPrefixMapping()方法！！“);
}
public void startElement(String uri, String localName,
String qName, Attributes atts) throws SAXException {
System.out.println(”元素名：“+qName);
for(int i=0;i<atts.getLength();i++){
System.out.print(” “);
System.out.println(”屬性：“+atts.getQName(i)
+”=”+atts.getValue(i));
}
System.out.print(”字符數(shù)據(jù)為：“);
}
public void endElement(String uri, String localName,
String qName) throws SAXException{
System.out.println(”對“+qName+”的解析完成！“);
}
public void characters(char[ ] ch, int start, int length)
throws SAXException{
try {
OutputStreamWriter outw =
new OutputStreamWriter(System.out);
outw.write(ch,start,length);
outw.flush();
System.out.println(”");
}catch (Exception e) {
e.printStackTrace();
}
}
public void ignorableWhitespace(char[ ] ch, int start, int length)
throws SAXException{
System.out.println(”執(zhí)行ignorableWhitespace()方法??！“);
}
public void processingInstruction(String target, String data)
throws SAXException{
System.out.println(”執(zhí)行processingInstruction()方法??！“);
}
public void skippedEntity(String name) throws SAXException{
System.out.println(”執(zhí)行skippedEntity()方法?。　?;
}
}