제9장. SAX (Simple API for XML)

대체 API 필요성

• 두가지 파서
  • 객체 기반 (Object-based) Interface : 메모리 상주 트리 이용, 응용에서 간단히 사용
       
  • 이벤트 기반 (Event-driven) Interface : 파서가 간단, 응용프로그램은 복잡
        
• SAX history
• W3C 표준이 아니다, OASIS (http://www.oasis-open.org/)에서 시작,
• David Megginson이 조정 (http://www.megginson.com에 정보)
• 1998.5월 SAX 1.0, 2000.5월 SAX 2.0

설치 및 실행

• Java 2 (jdk1.3.1 or j2sdk1.4.0) 설치
  • http://java.sun.com/j2se/downloads.html 에서 다운로드
  • 설치 후 Autoexec.bat 파일 내에서 Path에 C:\jdk1.3.1_06\bin 추가
• JAXP (Java for XML Parser) 설치
  • http://java.sun.com/xml/download.html 에서 JAVA XML Pack을 다운로드후 압축해제
  • 파일 중 jaxp-1.2_01 폴더에 있는 jar 파일을 선택 : jaxp-api.jar, sax.jar, xercesImpl.jar 등
  • C:\jdk1.3.1_06\jre\lib\ext\ 폴더에 위의 *.jar 파일을 복사
  • Autoexec.bat 파일에 다음 한 줄을 추가
      SET CLASSPATH=%CLASSPATH%;C:\jdk1.3.1_06\jre\lib\ext\*.jar
• 실행
  • javac  MyHandler.java
  • java  MyHandler  xxx.xml

이벤트 기반 인터페이스

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

이벤트 발생 시점	이벤트 핸들러
* <?xml version="1.0" ?>* <list>*   <book InStock="2">*     <title>*XML Bible*</title>*     <author>*Gwyneth Paltrow*</author>*     <pages/>**     <price currency="usd">*39*</price>*   </book>* </list>* *	0:startDocument() 1:processingInstruction() 2:startElement()  3:startElement()    속성은 매개변수로 전달    4:startElement() 5:characters() 6:endElement()    7:startElement()  8:characters()   9:endElement()    10:startElement() 11:endElement()    이벤트 2회    12:startElement() 13:characters() 14:endElement()   15:endElement()             속성은 매개변수로 전달 16:endElement() 17:endDocument()

SAX 이벤트 프로그래밍

• Apache의 Xerces 사용시

import javax.xml.parsers.*; import org.xml.sax.*; import org.xml.sax.helpers.*; public class MyHandler extends DefaultHandler {     public static void main(String[] args) throws Exception     {         if (args.length < 1) ...에러메시지         MyHandler  myhand = new MyHandler( );         myhand.read(args[0]);      }      public void read (String fileName) throws Exception      {         XMLReader  myhand = XMLReaderFactory.createXMLReader(                                       "org.apache.xeceres.parsers.SAXParser");         myhand.setContentHandler(this);         myhand.parse(fileName);      }     public void startDocument( ) throws SAXException  { ... }     public void endDocument( )  throws SAXException  { ... }     public void startElement(String uri, String localName, String qName,          Attributes atts) throws SAXException  { ... }     public void endElement(String uri, String localName, String qName)            throws SAXException  {...}     public void characters(char[] chars, int start, int length )            throws SAXException   { ... }     public void processingInstruction(String target, String data)            throws SAXException   {...} }

필요한 클래스 포함 핸들러 클래스 정의 (DefaultHandler) 메인 event handler 생성 파싱 메소드 호출 파싱 메소드 작성 parser 생성 및 할당 event handler 할당 parser 호출/실행 event Handler

• sun의 JAXP 사용시

import ... public class MyHandler extends DefaultHandler {     public static void main(String[] args) throws Exception     {     ...      }     public void read (String fileName) throws Exception     {         SAXParserFactory  factory =                               SAXParserFactory.newInstance( );         SAXParser parser = factory.newSAXParser( );         parser.parse(filename, this);     }     public void startDocument( ) throws SAXException  { ... }     ... }

핸들러 클래스 정의 parser factory 생성 parser 생성 parser 호출/실행시   event handler 할당 event Handler

SAX 이벤트 핸들러

• 기본 예제
• public void startDocument( ) throws SAXException { ... }
• public void endDocument( )  throws SAXException { ... }
  
• public void startElement(String uri, String localName, String qName, Attributes atts) ...
  
• public void endElement(String uri, String localName, String qName) ...  
  

import javax.xml.parsers.*; import org.xml.sax.*; import org.xml.sax.helpers.*; public class reader1 extends DefaultHandler {   public static void main(String[] args) throws Exception   {     if (args.length < 1)       System.out.println("... java reader1 filename...");       reader1  myreader = new reader1( );       myreader.read(args[0]);    }   public void read(String fileName) throws Exception   {     SAXParserFactory  factory =                  SAXParserFactory.newInstance( );     SAXParser parser = factory.newSAXParser( );     parser.parse(fileName, this);   }   public void startDocument( ) throws SAXException  { System.out.println("...startDocument"); }   public void endDocument( )  throws SAXException  { System.out.println("...endDocument"); }   public void startElement(String uri, String localName,       String qName, Attributes atts) throws SAXException  { System.out.print("<"+qName+">"); }   public void endElement(String uri, String localName,       String qName) throws SAXException  { System.out.println("</"+qName+">");} }

실행 C:>javac reader1.java C:>java reader1 booklist.xml 결과 ...startDocument <list><book><title></title> <author></author> <pages></pages> <price></price> </book> <book><title></title> <author></author> <pages></pages> <price></price> </book> <book><title><subtitle></subtitle> </title> <author></author> <pages></pages> <price></price> </book> ...endDocument

• 문자 데이터 읽기
• public void characters(char[] chars, int start, int length) throws SAXException { ... }

import ... public class reader2 extends DefaultHandler {   public static void main(String[] args) throws Exception   {     if (args.length < 1)       System.out.println("... java reader2 filename...");       reader2  myreader = new reader2( );       myreader.read(args[0]);    }   public void read(String fileName) throws Exception   public void startDocument( ) throws SAXException   public void endDocument( )  throws SAXException   public void startElement(String uri, ...) ...   public void endElement(String uri, String localName,         String qName) throws SAXException  { System.out.print("</"+qName+">");}   public void characters(char[] chars, int start, int leng)           throws SAXException   {         for (int i=0;i<leng;i++)                      System.out.print(chars[start+i]);   } }

실행 C:>javac reader2.java C:>java reader2 booklist.xml ...startDocument <list> <book>     <title>XML Bible</title>     <author>Gwyneth Paltrow</author>     <pages>652</pages>     <price>39.99</price> </book> <book>     <title>XML 클래스</title>     <author>임순범</author>     <pages>458</pages>     <price>19000</price> </book> <book>     <title>         <subtitle>열혈강의</subtitle>         XML By Example</title>     <author>홍길동</author>     <pages>529</pages>     <price>25000</price> </book> </list>...endDocument

• 원하는 문자 데이터만 출력
• public void characters(char[] chars, int start, int length) throws SAXException { ... }

public class reader3 extends DefaultHandler {   private StringBuffer titles = new StringBuffer();   private StringBuffer authors = new StringBuffer();   private boolean isTitle, isAthor = false;   private int num=1;   public static void main(String[] args) throws E...   public void read(String fileName) throws Exception   public void startElement(String uri, String localName,     String qName, Attributes atts) throws SAXException   {       if (qName.equals("title")) {             isTitle=true;  titles.setLength(0);       } else if (qName.equals("author")) {             isAuthor=true;  authors.setLength(0);       }   }   public void endElement(String uri, String localName,     String qName) throws SAXException  {       if (qName.equals("book")){           System.out.println("["+num+"] "+              authors.toString()+", "+titles.toString());           num++;       }   }   public void characters(char[] chars, int start,      int leng)  throws SAXException   {         if (isTitle) {            isTitle=false;            titles.append(chars,start,leng);       } else if (isAuthor) {            isAuthor=false;            authors.append(chars,start,leng);       }   } }	C:>javac reader3.java C:>java reader3 booklist.xml [1] Gwyneth Paltrow, XML Bible [2] 임순범, XML 클래스 [3] 홍길동, C:>_
	...수정...  public void endElement(String uri, ...)         throws SAXException  {    if (qName.equals("book")){       System.out.println("[" + num + "] "             + authors.toString() + ","             + titles.toString());      num++;    } else if (isTitle) isTitle = false;    else if (isAuthor) isAuthor = false;  }  public void characters( ... )         throws SAXException  {      if (isTitle)      titles.append(chars,start,leng);    else if (isAuthor)      authors.append(chars,start,leng);  }
	실행 C:>javac reader3.java C:>java reader3 booklist.xml [1] Gwyneth Paltrow, XML Bible [2] 임순범, XML 클래스 [3] 홍길동,             열혈강의 C:>_

• 속성 읽기
• void startElement(String uri, String localName, String qName, Attributes atts) ...
  -  atts.getValue("속성명"), getLength(), getQName(번호), getValue(번호)

public class reader4 extends DefaultHandler {   private ... titles, authors, isTitle, isAthor, num ... ;   private String stock = new String();   public static void main(String[] args) throws Ex...   public void read(String fileName) throws Exception   public void startElement(String uri, String localName,     String qName, Attributes atts) throws SAXException   {       if (qName.equals("book"))             stock = atts.getValue("InStock");       else if (qName.equals("title")) {             isTitle=true;   titles.setLength(0);       } else if (qName.equals("author")) {             isAuthor=true;   authors.setLength(0);       }   }   public void endElement(String uri, ...) ...   {       if (qName.equals("book")){           System.out.println("["+num+"] "+           authors...+"(재고:"+stock+"권)");           num++;       }   }   public void characters(char[] chars, ...) ... }

실행 C:>javac reader3.java C:>java reader3 booklist.xml [1] Gwyneth Paltrow, XML Bible(재고:2권) [2] 임순범, XML 클래스(재고:0권) [3] 홍길동,             열혈강의(재고:8권) C:>_

문서 변환 예제

주요 인터페이스 및 메소드

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()

SAX 이벤트 프로그래밍

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

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