제7장. Parser & DOM

제8장. SAX (Simple API for XML)

대체 API 필요성

두가지 파서
- 객체 기반 (Object-based) Interface
  - 메모리 상주 트리 이용, 응용에서 간단히 사용
- 이벤트 기반 (Event-driven) Interface
  - 파서가 간단, 응용프로그램은 복잡

이벤트 기반 인터페이스

XML 문서에서의 이벤트 발생 (파서에서)
- 문서 시작/종료, 시작태그, 종료태그, 엘리먼트 내용, 엔티티, 오류 등

이벤트 발생 예

이벤트 발생 시점	이벤트 핸들러
* <?xml version=”1.0”?>* <product>* <name>XML Training</name>* <price price=”999.0” vendor=”Play”/> <price price=”699.0” vendor=”XMLi”/> <price price=”799.0” vendor=”WT”/> <price price=”1999.0” vendor=”EM”/> </product>* *	0:startDocument() 1:processingInstruction() 2:startElement() 3:startElement() 4:characters() 5:endEl...() 6:startElement() 7:endElement() 8, 9 10, 11 속성은 매개변수로 전달 12, 13 14:endElement() 15:endDocument()

이벤트 기반 인터페이스 장단점
- DOM보다 하위 레벨 => 파싱하는 동안 많은 기능 제공 가능 => 응용 최적화
- 문서를 읽는 동안 처리 가능, 적은 시스템 자원 사용 => 큰 문서, 많은 문서 처리시 효과
- [단점] 응용 프로그램에서 많은 작업
- [단점] 문서 일부분에 대한 임의 접근 불가능, 이벤트 및 작업 상태 보관 필요성

DOM 과 SAX 비교

	DOM	SAX
접근 방법	트리 기반	이벤트 기반
장점	문서에 임의 접근	메모리 효율, 빠른 속도
단점	메모리 사용량, 속도 느리다	구조에 대한 접근 곤란, 읽기 전용, 브라우저 지원 안됨
적용분야	구조적 접근이 필요한 경우, 문서 정보를 쉽게 파악하고자 할 때	문서 일부분만 읽을 때, 데이터 변환시, 유효성 처리

SAX 이벤트 프로그래밍

이벤트 핸들러 클래스 정의 (IBM 의 Java용 파서 사용시)

import org.xml.sax.*;
import org.xml.sax.helpers.ParserFactory;

public class MyHandler extends HandlerBase
{
    public void startElement( name, ..., AttributeList) { ... }
    public void endElement( name, ...)   { ... }
    public void characters( )   { ... }
    ...
    public static void main(String[] args) throws Exception
    {
        if (args.length < 1) ...

        MyHandler myhand = new MyHandler( );

        Parser parser = ParserFactory.makeParser(...);
        parser.setDocumentHandler(myhand);

        parser.parse(args[0]);
        ...
    }
}

핸들러 클래스 정의

event Handler

메인

command line 처리

event handler 생성

parser 생성
event handler 할당

parser 호출/실행

sun의 JAXP 사용시 (SAX 2.0 이벤트 핸들러)

import javax.xml.parsers.*;
import org.xml.sax.*;
import org.xml.sax.helpers.*;

public class MyHandler extends DefaultHandler
{
    public void startDocument( ) { ... }
    public void endDocument( )   { ... }
    public void startElement(String uri, String lname, String name,
         Attributes atlist) { ... }
    public void endElement(String uri, String lname, String name)   {...}
    public void characters(char[] ch, int start, int length )   { ... }
    public void processingInstruction(String target, String data)   {...}
    ...
    public static void main(String[] args) throws Exception
    {
        if (args.length < 1) ...

        MyHandler myhand = new MyHandler( );

        SAXParserFactory factory =
                              SAXParserFactory.newInstance( );
        SAXParser parser = factory.newSAXParser( );

        parser.parse(args[0], myhand);
        ...
    }
}

핸들러 클래스 정의
(DefaultHandler)

event Handler

메인

event handler 생성

parser factory 생성

parser 생성

parser 호출/실행시
event handler 할당

설치 및 실행

Java 2 (jdk1.3.1 or j2sdk1.4.0) 설치

http://java.sun.com/download5 에서 다운로드
설치 후 Autoexec.bat 파일 내에서 Path에 C:\jdk1.3.1\bin 추가

JAXP (Java for XML Parser) 설치

http://java.sun.com/xml/download.html 에서 JAXP1.2 를 다운로드후 압축해제
압축 해제한 파일 중 다음 3개를 선택 : jaxp-api.jar, sax.jar, xercesImpl.jar
C:\jdk1.3.1\jre\lib\ext\ 폴더에 위의 3개 파일을 복사
설치 후 Autoexec.bat 파일의 마지막에 다음 한 줄을 추가
SET CLASSPATH="%CLASSPATH%";C:\jdk1.3.1\jre\lib\ext\*.jar

실행

javac MyHandler.java
java MyHandler xxx.xml

SAX 시작 예제

리스트 8.2 [p.252] 수정 (Cheap1.java )

import javax.xml.parsers.*;
import org.xml.sax.*;
import org.xml.sax.helpers.*;

public class Cheap1 extends DefaultHandler
{
protected double min = Double.MAX_VALUE;
protected String vendor = null; // 최저가, 회사명

/* startElement event */
public void startElement(String uri, String lname,
                            String name, Attributes atlist)
{
    if (name.equals("price"))
    {
      String attr = atlist.getValue("price");
      if (attr != null) {
          double price = toDouble(attr);
          if (min > price) {
              min = price;
              vendor = atlist.getValue("vendor");
        }
      }
    }
}
/* helper method */
protected double toDouble(String str)
{
    Double strDouble = Double.valueOf(str);
    if (strDouble != null)
     return strDouble.doubleValue( );
    else return 0.0;
}

/* property access : 회사명, 최저가 */
public String getVendor( )
{ return vendor; }
public double getMin( )
{ return min; }

/* main() for command-line & parser 실행 */
public static void main(String[] args)
                                      throws Exception
{
    if (args.length < 1)
    {
      System.out.println("java Cheap1 filename");
      return;
    }

    // event handler 생성
    Cheap1 cheap = new Cheap1( );

    // parser factory 및 parser 생성
    SAXParserFactory factory =
          SAXParserFactory.newInstance( );
    SAXParser parser = factory.newSAXParser( );

    // parser 호출/실행
    parser.parse(args[0], cheap);

    // 결과 출력
    System.out.println("최저가격은 " +
            cheap.getVendor() + " 회사의 $" +
            cheap.getMin() + " 이다.");
}
}

javac Cheap1.java
java Cheap1 price.xml
결과 => 최저가격은 XMLi 회사의 $699.0 이다.

주요 인터페이스 및 메소드

Parser
- parse(), setDocumentHandler(), setDTDHandler(), setEntityResolver(), setErrorHandler()
DocumentHandler
- startDocument(), endDocument(), startElement(), endElement(), characters(), ignorableWhitespace(), processingInstruction(), setDocumentLocator()
DTDHandler
- notationDecl(), unparsedEntityDecl()
ErrorHandler
- warning(), error(), fatalError()
Attributes
- getLength(), getQName(i), getType(i), getValue(i)
Locator
- getColumnNumber(), getLineNumber(), getPublicId(), getSystemId()

문서 변환 예제

(conv.java )

import javax.xml.parsers.*; ... // 위와 동일
...
public class conv extends DefaultHandler
{
protected int indent = 0; // indentation level

public void setDocumentLocator(Locator loc)
{
    System.out.println("[파일주소] " +
                            loc.getSystemId());
}

public void startDocument( )
{ System.out.print("[level]"); }

public void endDocument( )
{ System.out.println("\n==============="); }

public void startElement(String uri, String lname,
                  String name, Attributes atlist)
{
    String str = "[" + indent + "] " + name;
    int leng = atlist.getLength();
    if (leng > 0)
     for (int i=0; i<leng; i++)
        str += " ("+i+")"+atlist.getQName(i)+"=\""
                               +atlist.getValue(i)+"\"";
    System.out.print("\n"+str);
    indent++;
}

public void endElement(String uri, String lname,
                                   String name)
{    indent--; }

public void characters(char[] ch, int start, int length)
{
    String str="";
    if (length == 0) return;
    for (int i=0; i<length; i++)
        if (ch[start+i] != '\n') str += ch[start+i];
    str = str.trim();
    if (str != "")
        System.out.print(" {" + str + "} ");
}

public void processingInstruction(String target, String data)
{
    System.out.print("\n<? " + target + data + " ?>");
}

public static void main(String[] args)
                                      throws Exception
{
    if (args.length < 1) {
        System.out.println("java conv filename");
        return;
    }
    conv con = new conv( );
    SAXParserFactory factory =
            SAXParserFactory.newInstance( );
    SAXParser parser = factory.newSAXParser( );

    parser.parse(args[0], con);
}
}

실행 :
java conv price.xml java conv prices.xml

[파일주소] file:/C:/Lec/Ex-08/price.xml
[level]
[0] product
[1] name {XML Training}
[1] price (0)price="999.0" (1)vendor="Playfield"
[1] price (0)price="699.0" (1)vendor="XMLi"
[1] price (0)price="799.0" (1)vendor="WT"
[1] price (0)price="1999.0" (1)vendor="EM"
===============

[파일주소] file:/C:/Lec/Ex-08/prices.xml
[level]
[0] products {}
[1] product {}
[2] name {XML Editor} {}
[2] price (0)currency="usd" {499.0} {} {}
[1] product {}
[2] name {DTD Editor} {}
[2] price (0)currency="usd" {199.0} {} {}
...
===============