패키지 org.xml.sax

이 패키지는 코어 SAX API를 제공합니다.

참조처:
설명

인터페이스 개요

AttributeList	추천하지 않습니다. 이 인터페이스는 이름 공간을 지원하는 SAX2 Attributes 인터페이스로 대체할 수 있습니다.
Attributes	XML 속성의 리스트를 위한 인터페이스입니다.
ContentHandler	문서의 논리 컨텐츠의 통지를 받습니다.
DocumentHandler	추천하지 않습니다. 이 인터페이스는 이름 공간을 지원하는 SAX2 ContentHandler 인터페이스로 대체할 수 있습니다.
DTDHandler	표준 DTD 관련 이벤트의 통지를 받습니다.
EntityResolver	엔티티를 해결하기 위한 기본 인터페이스입니다.
ErrorHandler	SAX 에러 핸들러의 기본 인터페이스입니다.
Locator	SAX 이벤트와 문서의 위치를 관련짓기 위한 인터페이스입니다.
Parser	추천하지 않습니다. 이 인터페이스는 이름 공간을 지원하는 SAX2 XMLReader 인터페이스로 대체할 수 있습니다.
XMLFilter	XML 필터의 인터페이스입니다.
XMLReader	콜백을 사용해 XML 문서를 읽어내기 위한 인터페이스입니다.

클래스 개요

HandlerBase	추천하지 않습니다. 이 클래스는 비추천 DocumentHandler 인터페이스로 동작합니다.
InputSource	XML 엔티티의 단일의 입력 소스입니다.

예외 개요

SAXException	SAX 일반적인 에러 또는 경고를 캡슐화합니다.
SAXNotRecognizedException	인식되지 않는 식별자를 위한 예외 클래스입니다.
SAXNotSupportedException	지원 대상외의 조작을 위한 예외 클래스입니다.
SAXParseException	XML 구문 분석 에러 또는 경고를 캡슐화합니다.

패키지 org.xml.sax 설명

이 패키지는 코어 SAX API를 제공합니다. 코어 SAX API 에는 이름 공간에 대응한 새로운 어플리케이션의 설계나 기존의 인프라스트럭쳐의 메인트넌스에 통합하도록 추천 되고 있는 것도 있습니다.

SAX에 대한 자세한 것은 http://www.saxproject.org 를 참조하십시오.

SAX2 표준 기능 플래그

SAX2 필수의 특성의 1개에 검증에 사용할 수 있는 기능 플래그나 변경 파서 모드 (특히 검증등의 모드)가 추가되고 있는 일이 있습니다. 기능은 (절대) URI에 의해 식별되기 때문에 누구에게나 정의할 수 있습니다. 현재 정의되고 있는 표준 기능의 URI 에는 validation 등의 식별자의 전에 있는 접두사 http://xml.org/sax/features/가 있습니다. 「setFeature」를 사용해 기능을 온 또는 오프로 합니다. 표준의 식별자는 다음과 같습니다.

기능 ID	액세스	디폴트	설명
external-general-entities	읽어내/출력	지정 이루어	이 파서가 일반적인 외부 엔티티를 처리할지 어떨지를 보고한다. 검증하는 경우는 항상 true
external-parameter-entities	읽어내/출력	지정 이루어	이 파서가 외부 파라메이타엔티티를 처리할지 어떨지를 보고한다. 검증하는 경우는 항상 true
is-standalone	(구문 분석 한다) 읽기 전용, (구문 분석 하지 않는다) 없음	적용외	「startDocument()」콜백이 종료한뒤 구문 분석중만 검증된다. 읽기 전용 . 문서가 XML 선언내의 standalone="yes"를 지정했을 경우, 값은 true. 그렇지 않은 경우는 false
lexical-handler/parameter-entities	읽어내/출력	지정 없음	「true」의 값은 LexicalHandler가 파라메이타엔티티의 개시와 종료를 보고하는 것을 나타낸다
namespaces	읽어내/출력	true	「true」의 값은 사용 가능한 요소명 및 속성명의 이름 공간 URI와 접두사를 가지지 않는 로컬명을 나타낸다
namespace-prefixes	읽어내/출력	false	「true」의 값은 접두사 첨부의 XML 수식명과 「xmlns*」속성을 포함한 속성을 사용할 수 있는 것을 나타낸다
resolve-dtd-uris	읽어내/출력	true	「true」의 값은 선언의 시스템 ID가 기저 URI를 기준으로의해 보고전에 절대화 되는 것을 나타낸다 (디폴트에 한 모든 SAX2 XML 파서의 동작). false 값은 ID가 절대화 되지 않는 것을 나타낸다. 파서는 「Locator.getSystemId()」의 기저 URI를 제공한다. 이것은 건네받은 시스템 ID에 적용된다 DTDHandler.notationDecl() DTDHandler.unparsedEntityDecl() DeclHandler.externalEntityDecl() 이것은 선언의 보고에 사용하지 않는 「EntityResolver.resolveEntity()」나 절대화되어 있지 않은 URI를 이미 제공하고 있는 「LexicalHandler.startDTD()」에는 적용되지 않는다
string-interning	읽어내/출력	지정 없음	요소, 접두사, 속성, 엔티티, 표기법 및 로컬명의 모든 XML 명과 이름 공간 URI가 「java.lang.String.intern」를 사용해 보관 유지되는 경우는 「true」의 값을 가진다. 이것에 의해 「String.equals()」에 대해서 강제적으로 호출을 늦추는 것이 아니라, 문자의 정수에 대해서 동일한지 어떤지의 판정을 재빠르게 하도록 지원 한다
unicode-normalization-checking	읽어내/출력	false	XML 1.1 권고의 섹션 2.13 으로 부록 B 로 설명되고 있는 것 같은 Unicode 정규화 에러를 파서가 보고할지 어떨지를 제어한다. true인 경우, Unicode 정규화 에러는 ErrorHandler.error()를 사용해 보고된다. 이러한 에러는 다른 Unicode 관련의 인코딩 에러와는 달라, 그 자체가 치명적인 에러가 아닌
use-attributes2	읽기 전용	적용외	「ContentHandler.startElement()」로 이 파서에 의해 건네받는 「Attributes」객체가 「org.xml.sax.ext.Attributes2」 인터페이스를 구현하고 있는 경우는 「true」를 돌려준다. 이 인터페이스는 속성이 디폴트로 설정되었는지 어떠했는지가 아니고, 소스 텍스트로 지정되었는지 어떠했는지등의 DTD 관련의 추가 정보를 공개한다
use-locator2	읽기 전용	적용외	「ContentHandler.setDocumentLocator()」로 이 파서에 의해 건네받은 「Locator」객체가 「org.xml.sax.ext.Locator2」인터페이스를 구현하고 있는 경우는 「true」를 돌려준다. 이 인터페이스는 사용되고 있는 문자 인코딩이나 XML 버전 등의 엔티티의 추가 정보를 공개한다
use-entity-resolver2	읽어내/출력	true	「setEntityResolver」에 「org.xml.sax.ext.EntityResolver2」 인터페이스를 구현하고 있는 객체가 제공되는 경우에 그러한 새로운 메서드가 사용될 때는 「true」를 돌려준다. 새로운 메서드가 사용되지 않는 것을 나타내는 경우는 「false」를 돌려준다
validation	읽어내/출력	지정 없음	파서 이 모든 타당성 에러를 보고하고 있는지를 제어한다. true인 경우, 모든 외부 엔티티가 읽어내진다
xmlns-uris	읽어내/출력	false	「namespace-prefixes」기능이 설정되었을 때, 파서가 이름 공간 선언의 속성을 「http://www.w3.org/2000/xmlns/」이름 공간에 존재하는 것으로서 처리할지 어떨지를 제어한다. 디폴트에서는 SAX2는 이러한 속성이 어느 이름 공간에도 존재하지 않는다고 하는 것을 명시하고 있는 원의 「Namespaces in XML」권고에 따른다. 이 옵션의 플래그를 true 로 설정하는 것에의해 SAX2 이벤트를 하위 호환 할 수 없는 원의 권고의 향후의 개정판에 따르게의해 그러한 속성을 이름 공간에 둔다
xml-1. 1	읽기 전용	적용외	파서가 XML 1.1 으로 XML 1.0 양쪽 모두를 지원하는인 경우는 true를 돌려주고, XML 1.0 만을 지원하는인 경우는 false를 돌려준다

「namespaces」프로퍼티와 「namespace-prefixes」프로퍼티의 기본값을 지원 할 필요가 있습니다. 그 이외의 기능 플래그의 지원은 완전하게 옵션입니다.

SAX2 로 지정되어 있지 않은 기본값 의 경우, 각각의 XMLReader 구현에 의해 그 디폴트를 지정합니다만, 기능 플래그를 공개하지 않게 선택할 수도 있습니다. 여기서 지정되지 않는 한, 구현에 의해 이러한 표준 기능 플래그의 현재의 값을 변경할 수 있습니다만, 구문 분석중은 변경할 수 없습니다.

SAX2 표준 핸들러 및 프로퍼티 ID

파서 인터페이스의 특성을 객체로서 설명하는 경우, 다른 이름 공간이 정의됩니다. 이 이름 공간의 객체는 URI에 의해 재차 식별됩니다. 표준의 프로퍼티 URI 에는 lexical-handler 나 dom-node 등의 식별자의 전에 접두사 http://xml.org/sax/properties/가 붙습니다. 그러한 프로퍼티는 「setProperty()」를 사용해 관리합니다. 식별자는 다음과 같습니다.

프로퍼티 ID	설명
declaration-handler	자구 구문 규칙 ( 「문서의 요소명은 ...」)로서 다루어지는 것이나 모든 SAX 파서에 대해서 필수인 것을 제외해 ( 「DTDHandler」) 대부분의 DTD 선언을 보기 위해서 사용한다. 객체는 「org.xml.sax.ext.DeclHandler」 를 구현하고 있을 필요가 있다
document-xml-version	startDocument() 콜백이 종료한뒤 구문 분석중만 검증된다. 읽기 전용 . 이 프로퍼티는 XML 1.0 이나 XML 1.1 등, 문서의 실제의 XML 버전을 설명하는 리터럴 캐릭터 라인
dom-node	DOM Walker 형 파서가 「parser.parse()」파라미터를 무시하는 경우, 이것은 파서에 의해 이동되는 DOM (서브) 트리의 지정에 사용한다. 객체에는 「org.w3c.dom.Node」인터페이스를 구현할 필요가 있다
lexical-handler	코멘트, CDATA 단락 문자, 선택된 일반의 엔티티의 수중에 넣어, DTD 최초와 최후 ( 및 문서 요소명의 선언)라고 하는 일부의 어플리케이션으로 필수의 구문 이벤트를 보기 위해서 사용한다. 객체에는 「org.xml.sax.ext.LexicalHandler」 를 구현할 필요가 있다
xml-string	파서의 콜백중은 읽기 전용 . 이것에 의해 현재의 이벤트를 취급하는 캐릭터 라인의 TBS 체크를 공개한다

이러한 표준 프로퍼티는 모두 옵션입니다. XMLReader 구현의 경우, 이것들을 지원 할 필요는 없습니다.