|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
문서의 논리 컨텐츠의 통지를 받습니다.
이 모듈은 원시 코드, 문서 모두 공개 도메인에 놓여져 있습니다. 따라서, 내용에 관한프로텍션은 일절 제공되지 않습니다.
대부분의 SAX 어플리케이션이, 이 인터페이스를 구현하고 있습니다. 표준의 구문 분석 이벤트의 통지를 받을 필요가 있는 경우, 어플리케이션은 이 인터페이스를 구현해,setContentHandler 메소드를 사용해 인스턴스를 SAX 파서에 등록합니다. 파서는 이 인스턴스를 사용해, 요소나 캐릭터 데이터의 개시, 종료라고 하는 표준의 문서 관련 이벤트를 보고합니다.
이 인터페이스내의 이벤트의 순서는 문서 자체에 포함되는 정보의 순서를 밀러화한 것이어, 매우 중요합니다. 예를 들어, 어느 요소의 전컨텐츠 (캐릭터 데이터, 처리 인스트럭션, 서브 요소등)는 startElement 이벤트와 이것에 대응하는 endElement 이벤트의 사이에 차례로 늘어놓을 수 있습니다.
이 인터페이스는 현재는비추천으로 지정되고 있는 SAX 1.0 의 DocumentHandler 인터페이스와 닮아 있습니다만, 새롭게 이름 공간의 서포트와 타당성을 검증하지 않는 XML 프로세서로 스킵 된 엔티티의 보고의 서포트가 추가되고 있습니다.
구현자는 java.net 패키지에 Java 클래스 ContentHandler 가 포함되어 있는 점을 고려해, 다음과 같은 처리는 피하지 않으면 안됩니다.
import java.net. *; import org.xml.sax. *;
통상,"import ...*" (을)를 사용한 프로그램은 엉성한 (sloppy) 프로그램이라고 보여집니다. 유저는 버그보다 이 점에 주위를 기울일 필요가 있습니다.
XMLReader ,
DTDHandler ,
ErrorHandler | 메소드의 개요 | |
void |
characters (char[] ch,
int start,
int length)
캐릭터 데이터의 통지를 받습니다. |
void |
endDocument ()
문서의 종료 통지를 받습니다. |
void |
endElement (String namespaceURI,
String localName,
String qName)
요소의 종료 통지를 받습니다. |
void |
endPrefixMapping (String prefix)
전치수식자와 URI 의 매핑의 스코프를 종료합니다. |
void |
ignorableWhitespace (char[] ch,
int start,
int length)
요소 컨텐츠에 포함되는 무시할 수 있는 공백 캐릭터의 통지를 받습니다. |
void |
processingInstruction (String target,
String data)
처리 인스트럭션의 통지를 받습니다. |
void |
setDocumentLocator (Locator locator)
SAX 문서 이벤트의 발생원을 특정하는 오브젝트를 받습니다. |
void |
skippedEntity (String name)
스킵 된 엔티티의 통지를 받습니다. |
void |
startDocument ()
문서의 개시 통지를 받습니다. |
void |
startElement (String namespaceURI,
String localName,
String qName,
Attributes atts)
요소의 개시 통지를 받습니다. |
void |
startPrefixMapping (String prefix,
String uri)
전치수식자와 URI 이름 공간 매핑의 스코프를 개시합니다. |
| 메소드의 상세 |
public void setDocumentLocator(Locator locator)
locator가 필요한 경우는 필수 조건이 아닙니다만, SAX 파서를 사용하는 것을 강하게 추천합니다. SAX 파서는 ContentHandler 인터페이스내의 어느 메소드보다 먼저 이 메소드를 호출해, 어플리케이션에 locator를 제공합니다.
어플리케이션은 locator를 이용해, 파서가 에러를 보고하지 않는 경우에서도 문서 관련 이벤트의 종료 위치를 특정할 수가 있습니다. 통상, 어플리케이션은 이 정보를 사용해 고유의 에러 (캐릭터 컨텐츠가 어플리케이션의 기능 규칙에 따르지 않은 등)를 보고합니다. 일반적으로, locator로부터 돌려주어지는 정보는 불충분하고, 검색 엔진에서의 사용에 적절하고 있지 않습니다.
locator가 올바른 정보를 돌려주는 것은 이 인터페이스내에서 이벤트 호출을 하고 있는 동안 뿐입니다. 그 이외 때, 어플리케이션으로 locator의 정보를 이용해야 하는 것이 아닙니다.
locator - SAX 문서 이벤트의 위치를 돌려주는 오브젝트Locator
public void startDocument()
throws SAXException
SAX 파서는 이 메소드를 이 인터페이스내 또는 DTDHandler 내의 어느 메소드보다 먼저, 1 회만 호출합니다 (setDocumentLocator 를 제외한다).
SAXException - SAX 예외. 다른 예외를 랩 하고 있을 가능성이 있는endDocument()
public void endDocument()
throws SAXException
SAX 파서는 이 메소드를 구문 분석의 마지막에 1 회만 호출합니다. 회복 불능인 에러에 의해 구문 분석이 도중에 파기되는지 입력이 종료할 때까지 이 메소드는 불려 가지 않습니다.
SAXException - SAX 예외. 다른 예외를 랩 하고 있을 가능성이 있는startDocument()
public void startPrefixMapping(String prefix,
String uri)
throws SAXException
통상의 이름 공간 처리는 이벤트로부터 제공되는 정보를 필요로 하지 않습니다. SAX 의 XML 리더는 http://xml.org/sax/features/namespaces 기능의 값이 true (디폴트)로 설정되어 있으면, 요소 및 속성명의 전치수식자를 자동적으로 옮겨놓습니다.
그러나, 어플리케이션에 의해 캐릭터 데이터나 속성치 중(안)에서 사용되는 경우, 전치수식자를 안전하게 전개할 수 없습니다. 이러한 어플리케이션에는 필요에 따라서, start/endPrefixMapping 이벤트에 의해, 전치수식자를 어플리케이션 문맥내에서 확장하기 위해서 필요한 정보가 제공됩니다.
start/endPrefixMapping 이벤트가 각각 올바르게 상자로 될지 어떨지는 프로텍션되지 않습니다. 모든 startPrefixMapping 이벤트는 대응하는 startElement 이벤트의 전에 발생해, 모든 endPrefixMapping 이벤트는 대응하는 endElement 이벤트의 나중에 발생합니다만, 이러한 차례는 프로텍션되고 있지 않습니다.
"xml" 전치수식자는 사전에 선언되는 불변의 수식자이므로, 그 start/endPrefixMapping 이벤트는 존재하지 않습니다.
prefix - 선언되는 이름 공간앞치수식자uri - 전치수식자의 MAP 사키나 마에조라간 URI
SAXException - 처리중에 클라이언트가 예외를 슬로우 하는 일이 있는endPrefixMapping(java.lang.String) ,
startElement(java.lang.String, java.lang.String, java.lang.String, org.xml.sax.Attributes)
public void endPrefixMapping(String prefix)
throws SAXException
상세한 것에 대하여는 startPrefixMapping 를 참조해 주세요. 이 이벤트는 항상 대응하는 endElement 이벤트의 나중에 발생합니다만,endPrefixMapping 이벤트의 순서는 프로텍션되고 있지 않습니다.
prefix - 매핑 되고 있던 전치수식자
SAXException - 처리중에 클라이언트가 예외를 슬로우 하는 일이 있는startPrefixMapping(java.lang.String, java.lang.String) ,
endElement(java.lang.String, java.lang.String, java.lang.String)
public void startElement(String namespaceURI,
String localName,
String qName,
Attributes atts)
throws SAXException
파서는 XML 문서내의 각 요소의 전으로 이 메소드를 호출합니다. 각 startElement 이벤트에는 대응하는 endElement 이벤트가 있습니다. 이것은 요소가 하늘인 경우도 바뀌지 않습니다. 대응하는 endElement 이벤트의 전에, 요소의 컨텐츠 전부가 차례로 보고됩니다.
이 이벤트에서는 각 요소에 최대 3 개의 이름 컴퍼넌트를 허가합니다.
http://xml.org/sax/features/namespaces 프로퍼티 및 http://xml.org/sax/features/namespace-prefixes 프로퍼티의 값에 의해, 이러한 언젠가, 또는 전부가 제공됩니다.
제공되는 속성 리스트에는 명시적인 값 (지정된 값 또는 디폴트 값)을 가지는 속성만이 포함됩니다. #IMPLIED 속성은 포함되지 않습니다. 이 리스트에는 http://xml.org/sax/features/namespace-prefixes 프로퍼티가 true (디폴트의 설정은 false. true 의 서포트는 옵션)인 경우에 한해, 이름 공간 정의 (xmlns* 속성)에 사용되는 속성이 포함됩니다.
localName - 전치수식자를 포함하지 않는 로컬명. 이름 공간 처리를 하지 않는 경우는 공문자열qName - 전치수식자를 가지는 수식명. 수식명을 사용할 수 없는 경우는 공문자열atts - 요소에 부가된 속성. 속성이 존재하지 않는 경우, 하늘의 Attributes 오브젝트
SAXException - SAX 예외. 다른 예외를 랩 하고 있을 가능성이 있는endElement(java.lang.String, java.lang.String, java.lang.String) ,
Attributes
public void endElement(String namespaceURI,
String localName,
String qName)
throws SAXException
SAX 파서는 XML 문서내의 각 요소의 마지막에 이 메소드를 호출합니다. 각 endElement 이벤트에는 대응하는 startElement 이벤트가 있습니다. 이것은 요소가 하늘인 경우도 바뀌지 않습니다.
이름에 대해서는 startElement 를 참조해 주세요.
localName - 전치수식자를 포함하지 않는 로컬명. 이름 공간 처리를 하지 않는 경우는 공문자열qName - 전치수식자를 가지는 XML 1.0 수식명. 수식명을 사용할 수 없는 경우는 공문자열
SAXException - SAX 예외. 다른 예외를 랩 하고 있을 가능성이 있다
public void characters(char[] ch,
int start,
int length)
throws SAXException
파서는 이 메소드를 호출해, 각 캐릭터 데이타체크를 보고합니다. SAX 파서는 연속하는 캐릭터 데이터를 단일의 체크로서 또는 몇개의 체크에 분할해 돌려줍니다. 다만, locator로부터 유익한 정보를 얻기 위해서(때문에)는 단일의 이벤트에 포함되는 캐릭터가 모두 같은 외부 엔티티의 것이 아니면 안됩니다.
어플리케이션은 지정된 범위외의 배열을 읽어낼 수 없습니다.
일부의 파서는 이 메소드는 아니고 ignorableWhitespace 메소드를 사용해, 요소 컨텐츠에 포함되는 공백 캐릭터를 보고합니다. 이것은 타당성을 검증하는 파서에필수의 기능입니다.
ch - XML 문서의 캐릭터start - 배열내의 개시 위치length - 배열로부터 읽어내지는 캐릭터수
SAXException - SAX 예외. 다른 예외를 랩 하고 있을 가능성이 있는ignorableWhitespace(char[], int, int) ,
Locator
public void ignorableWhitespace(char[] ch,
int start,
int length)
throws SAXException
타당성을 검증하는 파서는 이 메소드를 사용해, 요소 컨텐츠에 포함되는 공백 캐릭터의 체크를 보고할 필요가 있습니다 (W3C XML 1.0 권고 섹션 2.10 을 참조). 타당성을 검증하지 않는 파서도, 컨텐츠 모델의 구문 분석 및 이용이 가능한 경우는 이 메소드를 사용하는 경우가 있습니다.
SAX 파서는 연속하는 모든 공백 캐릭터를 단일의 체크로서 또는 복수의 체크에 분할해 돌려줍니다. 다만, locator로부터 유익한 정보를 얻기 위해서(때문에)는 단일의 이벤트에 포함되는 캐릭터가 모두 같은 외부 엔티티의 것이 아니면 안됩니다.
어플리케이션은 지정된 범위외의 배열을 읽어낼 수 없습니다.
ch - XML 문서의 캐릭터start - 배열내의 개시 위치length - 배열로부터 읽어내지는 캐릭터수
SAXException - SAX 예외. 다른 예외를 랩 하고 있을 가능성이 있는characters(char[], int, int)
public void processingInstruction(String target,
String data)
throws SAXException
파서는 처리 인스트럭션을 검출할 때마다 1 회씩 이 메소드를 호출합니다. 처리 인스트럭션은 메인의 문서 요소의 전후에 존재할 가능성이 있습니다.
SAX 파서가, 이 메소드를 사용해 XML 선언을 보고할 것은 없습니다 (XML 1.0, 섹션 2.8). 또, 텍스트 선언을 보고하는 일도 없습니다 (XML 1.0, 섹션 4.3. 1).
target - 처리 인스트럭션의 타겟data - 처리 인스트럭션을 받는 데이터. 데이터가 제공되지 않는 경우는 null. 데이터에는 타겟과 자신을 구별하기 위한 공백 캐릭터는 포함되지 않는다
SAXException - SAX 예외. 다른 예외를 랩 하고 있을 가능성이 있다
public void skippedEntity(String name)
throws SAXException
파서는 엔티티가 스킵 될 때마다 1 회씩 이 메소드를 호출합니다. 타당성을 검증하지 않는 프로세서는 (엔티티가 외부 DTD 부분집합내에 정의되고 있는 등의 이유로써) 선언이 검출되지 않으면 엔티티를 스킵 합니다. 모든 프로세서는 http://xml.org/sax/features/external-general-entities 프로퍼티와 http://xml.org/sax/features/external-parameter-entities 프로퍼티의 값에 의해, 외부 엔티티를 스킵 할 가능성이 있습니다.
name - 스킵 된 엔티티의 이름. 파라메이타엔티티의 경우, 이 이름은 '%'로 시작된다. 외부 DTD 부분집합의 경우, 캐릭터 라인 "[dtd]" 로 시작된다
SAXException - SAX 예외. 다른 예외를 랩 하고 있을 가능성이 있다
|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.