以文本方式查看主题

-  中文XML论坛 - 专业的XML技术讨论区  (http://bbs.xml.org.cn/index.asp)
--  『 DOM/SAX/XPath 』  (http://bbs.xml.org.cn/list.asp?boardid=11)
----  SAX教程系列三(创建SAX解析器)-----来源:IBM developerWorks  (http://bbs.xml.org.cn/dispbbs.asp?boardid=11&rootid=&id=7967)


--  作者:yuji1998
--  发布时间:5/31/2004 12:18:00 AM

--  SAX教程系列三(创建SAX解析器)-----来源:IBM developerWorks
欢迎您通过电子邮件nicholas@nicholaschase.com直接与作者 Nicholas Chase 联系。
注:本教程仅供本站成员的学习和研究使用,严禁用于商业目的!

示例文件
      本教程将展示如何构造这样一个应用程序,它使用 SAX 来记录一组用户的答案,这些用户被要求就他们与外星人的遭遇接受调查。
答案将存储在一个 XML 文件中:
<?xml version="1.0"?>
<surveys>
<response username="bob">
   <question subject="appearance">A</question>
   <question subject="communication">B</question>
   <question subject="ship">A</question>
   <question subject="inside">D</question>
   <question subject="implant">B</question>
</response>
<response username="sue">
   <question subject="appearance">C</question>
   <question subject="communication">A</question>
   <question subject="ship">A</question>
   <question subject="inside">D</question>
   <question subject="implant">A</question>
</response>
<response username="carol">
   <question subject="appearance">A</question>
   <question subject="communication">C</question>
   <question subject="ship">A</question>
   <question subject="inside">D</question>
   <question subject="implant">C</question>
</response>
</surveys>
      创建事件处理程序
      在应用程序能够使用 SAX 来处理 XML 文档之前,它必须首先创建一个事件处理程序。SAX 提供了一个类DefaultHandler,应用程序可以扩展该类。
      要使用 SAX 来进行正确的解析,需要对处理程序的方法进行特殊调用,而这些调用 不能是静态的。这意味着您需要特别地实例化处理程序对象,因此下面将提供简单的概述,以防您还不习惯使用对象。
      当新的对象被创建时,它会寻找要执行的任何类构造函数。例如:
import org.xml.sax.helpers.DefaultHandler;

public class SurveyReader extends DefaultHandler
{

   public SurveyReader() {
      System.out.println("Object Created.");
   }

   public void showEvent(String name) {
      System.out.println("Hello, "+name+"!");
   }

   public static void main (String args[]) {
   
      SurveyReader reader = new SurveyReader();
      reader.showEvent("Nick");
   }

}
      当 main 方法执行时,它会创建 SurveyReader 类的一个新实例。这样会导致构造函数执行,从而输出 Object Created(以及下面的问候语)。然后您可以使用该对象来执行 showEvent() 方法。
      直接指定 SAX 驱动程序
      在准备好事件处理程序之后,下一步就是使用 SAX 驱动程序来创建解析器,或 XMLReader。您可以使用三种方式中的任一种来创建解析器:
• 直接调用驱动程序
• 允许在运行时指定驱动程序
• 将驱动程序作为 createXMLReader() 的参数来传递
      如果知道 SAX 驱动程序的类名称,您可以直接调用它。例如,如果该类是(虚构的)com.nc.xml.SAXDriver,您可以使用如下代码:
try {
   XMLReader xmlReader = new com.nc.xml.SAXDriver();
} catch (Exception e) {
   System.out.println("Can't create the parser: " + e.getMessage());
}
      来直接创建 XMLReader。
      您还可以使用系统属性来使得应用程序更灵活。例如,您可以在运行应用程序时,从命令行将类名称作为 org.xml.sax.driver 属性的值来指定。
java -Dorg.xml.sax.driver=com.nc.xml.SAXDriver SurveyReader

(注意,-D 后面 不 应该有空格。)
这使得该信息对 XMLReaderFactory 可用,因此您可以使用这样的代码:
try {
   XMLReader xmlReader = XMLReaderFactory.createXMLReader();
} catch (Exception e) {
   System.out.println("Can't create the parser: " + e.getMessage());
}
如果您知道驱动程序名称,还可以将它作为 createXMLReader() 的参数来直接传递。
      创建解析器
      这个例子使用了一对类 SAXParserFactory 和 SAXParser 来创建解析器,因此您不必知道驱动程序本身的名称。
首先声明 XMLReader、xmlReader,然后使用 SAXParserFactory 来创建一个 SAXParser。 XMLReader 是由 SAXParser 提供的。
import org.xml.sax.helpers.DefaultHandler;

import javax.xml.parsers.SAXParser;
import javax.xml.parsers.SAXParserFactory;
import org.xml.sax.XMLReader;

public class SurveyReader extends DefaultHandler
{

   public SurveyReader() {
   }

   public static void main (String args[]) {
      
   XMLReader xmlReader = null;
      
      try {

         SAXParserFactory spfactory = SAXParserFactory.newInstance();
         
         SAXParser saxParser = spfactory.newSAXParser();

         xmlReader = saxParser.getXMLReader();
  
      } catch (Exception e) {
            System.err.println(e);
            System.exit(1);
      }
      

   }
}
      验证与非验证解析器
      要使用 XML 文档做任何事情,你都必须读取其中的信息。做这个工作的应用程序称为解析器。
解析器的两种类型分别是:非验证 和 验证。
• 非验证解析器是适用于格式良好(well-formed)文档的解析器。 它读取每个信息单元,并将其添加到文档 —— 或者在 SAX 应用程序的情况下处理事件,而不管实际的结构和内容如何。
• 另一方面,验证解析器根据已定义的语法检查 XML 文档的内容和结构。 有时,这个语法是文档类型定义(Document Type Definition,DTD)的形式,但是近来它更可能在 XML Schema 文档中定义。在任一种情况下,解析器都会检查文档,以确保每个元素和属性都已定义,并且包含正确类型的内容。例如,您可以指定每个 order(订单) 都有一个status(状态)。 如果在没有语法定义的情况下尝试创建文档,验证解析器将会提示错误。
已经由验证解析器检验过的文档被认为是有效的文档。
      设置验证选项
对于本教程,您将不会验证调查结果,因此可以通过设置 validating 属性,关闭 SAXParserFactory 创建的任何解析器的验证特性:
...
public static void main (String args[]) {
      
   XMLReader xmlReader = null;
      
   try {

      SAXParserFactory spfactory =
           SAXParserFactory.newInstance();

      spfactory.setValidating(false);
      
      SAXParser saxParser =
                 spfactory.newSAXParser();

      xmlReader = saxParser.getXMLReader();
  
   } catch (Exception e) {
         System.err.println(e);
         System.exit(1);
   }
}
...
      设置内容处理程序
      解析器必须将它的事件发送到一个 ContentHandler。为简单起见,SurveyReader 将同时用作主应用程序和内容处理程序,因此创建它的一个新实例,并使用 XMLReader 的 setContentHandler() 方法来将它设置为 ContentHandler:
...
    xmlReader = saxParser.getXMLReader();

    xmlReader.setContentHandler(new SurveyReader());
  
} catch (Exception e) {
...
      当然,这是内容处理程序的唯一选项。当本教程在后面考察序列化 SAX 流时,您还会看到其他选项。
      解析 InputSource
      要实际解析一个文件(或解析其他任何内容!)您需要一个 InputSource。这个 SAX 类包装了你要处理的任何数据,因此您不必(太)关心它来自何处。
现在您就准备好实际解析文件了。parse() 方法接受该文件,将它包装到 InputSource 中,然后处理它,同时将每个事件发送给 ContentHander。
...

import org.xml.sax.InputSource;

...
    xmlReader = saxParser.getXMLReader();
    xmlReader.setContentHandler(new SurveyReader());
  
    InputSource source = new InputSource("surveys.xml");
    xmlReader.parse(source);
  
} catch (Exception e) {
...
您可以编译和运行这个程序,但此时不应该会发生任何事情,因为应用程序还没有定义任何事件。
      设置 ErrorHandler
      此时什么事情也不 应该 会发生,当然,您尝试要处理的数据总是可能存在问题。在这样的情形下,有一个处理错误以及处理内容的处理程序是有所帮助的。
您可以像创建内容处理程序一样创建一个错误处理程序。通常,您会把这个处理程序创建为 ErrorHandler 的一个单独的实例,但是为简化这里的例子,我们将把错误处理直接包括在 SurveyResults 中。这种双重用途是可以实现的,因为该类扩展了 DefaultHandler,因而同时包括了 ContentHandler 方法和 ErrorHandler 方法的实现。
设置新的 ErrorHandler 就像设置 ContentHandler 一样:
...
xmlReader.setContentHandler(new SurveyReader());

xmlReader.setErrorHandler(new SurveyReader());
  
InputSource source = new InputSource("surveys.xml");
...
      同样,如果此时运行应用程序,仍然应该什么事情也不会发生,因为每个事件的默认实现不做任何事情。在下一节中,我们将考察添加新的实现来处理解析期间发生的事件。


W 3 C h i n a ( since 2003 ) 旗 下 站 点
苏ICP备05006046号《全国人大常委会关于维护互联网安全的决定》《计算机信息网络国际联网安全保护管理办法》
46.875ms