ContentHandler是Java类包中一个特殊的SAX接口,位于org.xml.sax包中。该接口封装了一些对事件处理的方法,当XML解析器开始解析XML输入文档时,它会遇到某些特殊的事件,比如文档的开头和结束、元素开头和结束、以及元素中的字符数据等事件。当遇到这些事件时,XML解析器会调用ContentHandler接口中相应的方法来响应该事件。ContentHandler接口的方法有以下几种:
l void startDocument()方法:接收文档开始的通知,SAX解析器仅调用该方法一次。
l void endDocument()方法:接收文档结尾的通知,SAX解析器仅调用该方法一次,并且它将是解析期间最后调用的方法。直到解析器放弃解析(由于不可恢复的错误)或到达输入的结尾时,该方法才会被调用。
l void startElement(String uri,String localName,String qName,Attributes atts)方法:接收元素开始的通知。该方法的参数信息如下:
uri:名称空间URI,如果元素没有名称空间URI,如果未执行名称空间处理,则为空字符串。
localName:本地名称(不带前缀),如果未执行命名空间处理,则为空字符串。
qName:元素名(带有前缀),如果元素名不可用,则为空字符串。
atts:该元素的属性。如果没有属性,则它将是空Attributes对象。在startElement返回后,此对象的值是未定义的。
l void endElement(String uri,String qName)方法:接收元素结束的通知。该方法的参数含义与startElement()方法的参数含义一致。
l void characters(char[ ] ch,int start,int length)方法:接收字符数据的通知。该方法的参数信息如下:
ch:字符数组,来自XML文档中的字符串数据。
start:数组中的开始位置
length:从数组中读取的字符的个数
l void ignorableWhitespace(char[ ] ch,int length)方法:接收元素内容中可忽略的空白通知。该方法的参数含义与characters()方法的参数含义一致。
l void startPrefixMapping(String prefix,String uri)方法:开始标记的前缀URI名称空间范围映射。该方法的参数信息如下:
prefix:声明的名称空间前缀。对于没有前缀的默认元素名称空间,使用空字符串。
uri:将前缀映射到的名称空间URI。
l void endPrefixMapping(String prefix)方法:结束标记的前缀URI名称空间范围的映射。
l void setDocumentLocator(Locator locator)方法:接收用来查找SAX文档事件起源的对象。如果要使用SAX解析器来提供定位器,则必须在调用ContentHandler接口中的任何其他方法之前调用该方法,为应用程序提供定位器。
l void processingInstruction(String target,String data)方法:接收处理指令的通知。
l void skippedEntity(String name)方法:接收跳过的实体的通知。
下面我们来看一个简单的例子:
SAXExample1.java
import org.xml.sax.*;
import org.xml.sax.ContentHandler;
public class SAXExample1 implements ContentHandler{
public void setDocumentLocator(Locator locator){
System.out.println(”执行setDocumentLocator()方法!!“);
}
public void startDocument( ) throws SAXException{
System.out.println(”执行startDocument( )方法!!“);
public void endDocument() throws SAXException{
System.out.println(”执行endDocument( )方法!!“);
public void startPrefixMapping(String prefix,String uri)
throws SAXException{
System.out.println(”执行startPrefixMapping( )方法!!“);
public void endPrefixMapping(String prefix) throws SAXException{
System.out.println(”执行endPrefixMapping( )方法!!“);
public void startElement(String uri,
String qName,Attributes atts) throws SAXException {
System.out.println(”执行startElement( )方法!!“);
public void endElement(String uri,String qName)
System.out.println(”执行endElement( )方法!!“);
public void characters(char[ ] ch,int length)
System.out.println(”执行characters( )方法!!“);
public void ignorableWhitespace(char[ ] ch,u5b8bu4f53; font-size:16px; text-align:left; text-indent:2em"> System.out.println(”执行ignorableWhitespace( )方法!!“);
public void processingInstruction(String target,String data)
System.out.println(”执行processingInstruction( )方法!!“);
public void skippedEntity(String name) throws SAXException{
System.out.println(”执行skippedEntity( )方法!!“);
在例中SAXExample1类实现了ContentHandler接口,并重写了该接口的所有方法。但在这些方法中,我们采取了简单的实现。主要是想让大家了解这些方法的执行顺序和过程。
然后创建一个简单的XML文档,XML文档(test1.xml)代码如下:
<?xml version=”1.0″ encoding=”UTF-8″?>
<student id=”a001″>
this is a test
<name>zhangsan</name>
</student>
最后再做一个测试类(TestSax.java)用来创建解析器,并将这些事件处理程序分配给该解析器,程序代码如下:
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();
SAXExample2.java
import java.io.*;
public class SAXExample2 implements ContentHandler{
System.out.println(”查找文档完成!“);
public void startDocument() throws SAXException{
System.out.println(”开始解析!“);
System.out.println(”解析完成!“);
System.out.println(”执行startPrefixMapping()方法!!“);
System.out.println(”执行endPrefixMapping()方法!!“);
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(”字符数据为:“);
String qName) throws SAXException{
System.out.println(”对“+qName+”的解析完成!“);
OutputStreamWriter outw =
new OutputStreamWriter(System.out);
outw.write(ch,start,length);
outw.flush();
System.out.println(”");
}catch (Exception e) {
System.out.println(”执行ignorableWhitespace()方法!!“);
System.out.println(”执行processingInstruction()方法!!“);
System.out.println(”执行skippedEntity()方法!!“);
}
原文链接:https://www.f2er.com/xml/298896.html