SAXParser (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세: 필드 | 생성자 | 메소드

javax.xml.parsers
클래스 SAXParser

java.lang.Object 
  javax.xml.parsers.SAXParser

public abstract class SAXParser
extends Object
extends Object

XMLReader 구현 클래스를 랩 하는 API 를 정의합니다. JAXP 1.0 에서는, 이 클래스는 Parser 인터페이스를 랩 했습니다만, 이 인터페이스는 XMLReader 로 옮겨졌습니다. 이행을 간단하게 하기 위해서, 이 클래스는 새로운 메소드의 지원와 같이, 같은 이름과 인터페이스의 지원도 계속합니다. 이 클래스의 인스턴스는 SAXParserFactory.newSAXParser() 메소드에 의해 취득할 수 있습니다. 이 클래스의 인스턴스를 취득하면(자), 다양한 입력 소스로부터 XML 문서를 구문 분석 할 수 있습니다. 이러한 입력 소스에는, InputStream, File, URL, 및 SAX InputSource 가 있습니다.

이 static 메소드는, 시스템 프로퍼티 설정에 근거해 새로운 팩토리 인스턴스를 작성하는지, 또는 프로퍼티이 정의되어 있지 않은 경우에 플랫폼의 디폴트를 사용합니다.

어느 팩토리 구현을 작성할까를 결정하는 시스템 프로퍼티의 이름은 "javax.xml.parsers.SAXParserFactory" 입니다. 이 프로퍼티은, 이 abstract 클래스의 구상 서브 클래스를 명명합니다. 프로퍼티이 정의되어 있지 않은 경우는, 플랫폼의 디폴트가 사용됩니다.

컨텐츠는 기본이 되는 퍼서로 구문 분석 되기 (위해)때문에, 지정된 HandlerBase 또는 DefaultHandler 의 메소드가 불려 갑니다.

기본이 되는 구현을 랩 하는 이 클래스의 구현측에서는,ParserAdapter 클래스를 사용해, 그 SAX1 구현을 이 개정된 클래스아래에서 동작하도록(듯이), 최초로 적합시키는 것을 고려할 수 있습니다.

생성자 의 개요
`protected`	`SAXParser ()` 인스톨을 방해하는 protected 생성자 입니다.

메소드의 개요
`abstract Parser`	`getParser ()` 이 클래스의 구현에 의해 캡슐화되는 SAX 퍼서를 돌려줍니다.
`abstract Object`	`getProperty (String name)` `XMLReader` 의 기본이 되는 구현으로 요구된 특정의 프로퍼티을 돌려줍니다.
`Schema`	`getSchema ()` XML 프로세서에 의해 사용되는 `Schema` 에의 참조를 가져옵니다.
`abstract XMLReader`	`getXMLReader ()` 이 클래스의 구현에 의해 캡슐화되는 `XMLReader` 를 돌려줍니다.
`abstract boolean`	`isNamespaceAware ()` 이 퍼서가 이름 공간을 인식하도록(듯이) 설정되어 있는지 어떤지를 나타냅니다.
`abstract boolean`	`isValidating ()` 이 퍼서가 XML 문서를 검증하도록(듯이) 설정되어 있는지 어떤지를 나타냅니다.
`boolean`	`isXIncludeAware ()` 이 퍼서의 XInclude 처리 모드를 가져옵니다.
`void`	`parse (File f, DefaultHandler dh)` 지정된 파일의 컨텐츠를, 지정된 `DefaultHandler` 를 사용해 XML 로서 구문 분석 합니다.
`void`	`parse (File f, HandlerBase hb)` 지정된 파일의 컨텐츠를, 지정된 `HandlerBase` 를 사용해 XML 로서 구문 분석 합니다.
`void`	`parse (InputSource is, DefaultHandler dh)` 지정된 `InputSource` 의 컨텐츠를, 지정된 `DefaultHandler` 를 사용해 XML 로서 구문 분석 합니다.
`void`	`parse (InputSource is, HandlerBase hb)` 지정된 `InputSource` 의 컨텐츠를, 지정된 `HandlerBase` 를 사용해 XML 로서 구문 분석 합니다.
`void`	`parse (InputStream is, DefaultHandler dh)` 지정된 `InputStream` 인스턴스의 컨텐츠를, 지정된 `DefaultHandler` 를 사용해 XML 로서 구문 분석 합니다.
`void`	`parse (InputStream is, DefaultHandler dh, String systemId)` 지정된 `InputStream` 인스턴스의 컨텐츠를, 지정된 `DefaultHandler` 를 사용해 XML 로서 구문 분석 합니다.
`void`	`parse (InputStream is, HandlerBase hb)` 지정된 `InputStream` 인스턴스의 컨텐츠를, 지정된 `HandlerBase` 를 사용해 XML 로서 구문 분석 합니다.
`void`	`parse (InputStream is, HandlerBase hb, String systemId)` 지정된 `InputStream` 인스턴스의 컨텐츠를, 지정된 `HandlerBase` 를 사용해 XML 로서 구문 분석 합니다.
`void`	`parse (String uri, DefaultHandler dh)` 지정된 URI (Uniform Resource Identifier)로 표현된 컨텐츠를, 지정된 `DefaultHandler` 를 사용해 XML 로서 구문 분석 합니다.
`void`	`parse (String uri, HandlerBase hb)` 지정된 URI (Uniform Resource Identifier)로 표현된 컨텐츠를, 지정된 `HandlerBase` 를 사용해 XML 로서 구문 분석 합니다.
`void`	`reset ()` 이 `SAXParser` 를 원의 설정에 리셋 합니다.
`abstract void`	`setProperty (String name, Object value)` `XMLReader` 의 기본이 되는 구현에 특정의 프로퍼티을 설정합니다.

클래스 java.lang. Object 로부터 상속된 메소드
`clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait`

생성자 의 상세

SAXParser

protected SAXParser()

인스톨을 방해하는 protected 생성자 입니다. SAXParserFactory.newSAXParser() 를 사용합니다.

메소드의 상세

reset

public void reset()

이 SAXParser 를 원의 설정에 리셋 합니다.

SAXParser 는,SAXParserFactory.newSAXParser() 로 작성된 시점 상태에 리셋 됩니다. reset() 는, 기존의 SAXParser 의 재사용을 허가하도록(듯이) 설정되어 있기 (위해)때문에, 새로운 SAXParser 의 작성에 관련하는 자원을 절약할 수 있습니다.

SAXParser 를 리셋 했을 경우,Object.equals(Object obj) 등의 같은 Schema Object 를 가지는 것은 보증되지 않습니다. 기능적으로 같은 Schema 를 가지는 것은 보증됩니다.

예외:: UnsupportedOperationException - 구현이 이 메소드를 오버라이드(override) 하지 않는 경우
도입된 버젼:: 1.5

parse

public void parse(InputStream  is,
                  HandlerBase  hb)
           throws SAXException ,
                  IOException

지정된 InputStream 인스턴스의 컨텐츠를, 지정된 HandlerBase 를 사용해 XML 로서 구문 분석 합니다. HandlerBase 클래스는 SAX 2.0 에서는 추천 되지 않기 때문에, 이 메소드의 DefaultHandler 버젼을 사용하는 것을 추천합니다.

파라미터:: is - 구문 분석 되는 컨텐츠를 포함한 InputStream; hb - 사용하는 SAX HandlerBase
예외:: IllegalArgumentException - 지정된 InputStream 가 null 의 경우; SAXException - 구문 분석으로 SAX 에러가 생성되었을 경우; IOException - InputStream 와의 교환으로 입출력 에러가 발생했을 경우
관련 항목:: DocumentHandler

parse

public void parse(InputStream  is,
                  HandlerBase  hb,
                  String  systemId)
           throws SAXException ,
                  IOException

파라미터:: is - 구문 분석 되는 컨텐츠를 포함한 InputStream; hb - 사용하는 SAX HandlerBase; systemId - 상대 URI 를 해결하는데 필요한 시스템 식별자
예외:: IllegalArgumentException - 지정된 InputStream 가 null 의 경우; IOException - InputStream 와의 교환으로 입출력 에러가 발생했을 경우; SAXException - 처리중에 SAX 에러가 발생했을 경우
관련 항목:: 대신의 이 메소드의 버젼

parse

public void parse(InputStream  is,
                  DefaultHandler  dh)
           throws SAXException ,
                  IOException

지정된 InputStream 인스턴스의 컨텐츠를, 지정된 DefaultHandler 를 사용해 XML 로서 구문 분석 합니다.

파라미터:: is - 구문 분석 되는 컨텐츠를 포함한 InputStream; dh - 사용하는 SAX DefaultHandler
예외:: IllegalArgumentException - 지정된 InputStream 가 null 의 경우; IOException - 입출력 에러가 발생했을 경우; SAXException - 처리중에 SAX 에러가 발생했을 경우
관련 항목:: DocumentHandler

parse

public void parse(InputStream  is,
                  DefaultHandler  dh,
                  String  systemId)
           throws SAXException ,
                  IOException

지정된 InputStream 인스턴스의 컨텐츠를, 지정된 DefaultHandler 를 사용해 XML 로서 구문 분석 합니다.

파라미터:: is - 구문 분석 되는 컨텐츠를 포함한 InputStream; dh - 사용하는 SAX DefaultHandler; systemId - 상대 URI 를 해결하는데 필요한 시스템 식별자
예외:: IllegalArgumentException - 지정된 InputStream 가 null 의 경우; IOException - 입출력 에러가 발생했을 경우; SAXException - 처리중에 SAX 에러가 발생했을 경우
관련 항목:: 대신의 이 메소드의 버젼

parse

public void parse(String  uri,
                  HandlerBase  hb)
           throws SAXException ,
                  IOException

지정된 URI (Uniform Resource Identifier)로 표현된 컨텐츠를, 지정된 HandlerBase 를 사용해 XML 로서 구문 분석 합니다. HandlerBase 클래스는 SAX 2.0 에서는 추천 되지 않기 때문에, 이 메소드의 DefaultHandler 버젼을 사용하는 것을 추천합니다.

파라미터:: uri - 구문 분석 되는 컨텐츠의 장소; hb - 사용하는 SAX HandlerBase
예외:: IllegalArgumentException - uri 가 null 의 경우; IOException - 입출력 에러가 발생했을 경우; SAXException - 처리중에 SAX 에러가 발생했을 경우
관련 항목:: DocumentHandler

parse

public void parse(String  uri,
                  DefaultHandler  dh)
           throws SAXException ,
                  IOException

지정된 URI (Uniform Resource Identifier)로 표현된 컨텐츠를, 지정된 DefaultHandler 를 사용해 XML 로서 구문 분석 합니다.

파라미터:: uri - 구문 분석 되는 컨텐츠의 장소; dh - 사용하는 SAX DefaultHandler
예외:: IllegalArgumentException - uri 가 null 의 경우; IOException - 입출력 에러가 발생했을 경우; SAXException - 처리중에 SAX 에러가 발생했을 경우
관련 항목:: DocumentHandler

parse

public void parse(File  f,
                  HandlerBase  hb)
           throws SAXException ,
                  IOException

지정된 파일의 컨텐츠를, 지정된 HandlerBase 를 사용해 XML 로서 구문 분석 합니다. HandlerBase 클래스는 SAX 2.0 에서는 추천 되지 않기 때문에, 이 메소드의 DefaultHandler 버젼을 사용하는 것을 추천합니다.

파라미터:: f - 구문 분석 대상의 XML 를 포함한 파일; hb - 사용하는 SAX HandlerBase
예외:: IllegalArgumentException - File 객체가 null 의 경우; IOException - 입출력 에러가 발생했을 경우; SAXException - 처리중에 SAX 에러가 발생했을 경우
관련 항목:: DocumentHandler

parse

public void parse(File  f,
                  DefaultHandler  dh)
           throws SAXException ,
                  IOException

지정된 파일의 컨텐츠를, 지정된 DefaultHandler 를 사용해 XML 로서 구문 분석 합니다.

파라미터:: f - 구문 분석 대상의 XML 를 포함한 파일; dh - 사용하는 SAX DefaultHandler
예외:: IllegalArgumentException - File 객체가 null 의 경우; IOException - 입출력 에러가 발생했을 경우; SAXException - 처리중에 SAX 에러가 발생했을 경우
관련 항목:: DocumentHandler

parse

public void parse(InputSource  is,
                  HandlerBase  hb)
           throws SAXException ,
                  IOException

지정된 InputSource 의 컨텐츠를, 지정된 HandlerBase 를 사용해 XML 로서 구문 분석 합니다. HandlerBase 클래스는 SAX 2.0 에서는 추천 되지 않기 때문에, 이 메소드의 DefaultHandler 버젼을 사용하는 것을 추천합니다.

파라미터:: is - 구문 분석 되는 컨텐츠를 포함한 InputSource; hb - 사용하는 SAX HandlerBase
예외:: IllegalArgumentException - InputSource 객체가 null 의 경우; IOException - 입출력 에러가 발생했을 경우; SAXException - 처리중에 SAX 에러가 발생했을 경우
관련 항목:: DocumentHandler

parse

public void parse(InputSource  is,
                  DefaultHandler  dh)
           throws SAXException ,
                  IOException

지정된 InputSource 의 컨텐츠를, 지정된 DefaultHandler 를 사용해 XML 로서 구문 분석 합니다.

파라미터:: is - 구문 분석 되는 컨텐츠를 포함한 InputSource; dh - 사용하는 SAX DefaultHandler
예외:: IllegalArgumentException - InputSource 객체가 null 의 경우; IOException - 입출력 에러가 발생했을 경우; SAXException - 처리중에 SAX 에러가 발생했을 경우
관련 항목:: DocumentHandler

getParser

public abstract Parser  getParser()
                          throws SAXException

이 클래스의 구현에 의해 캡슐화되는 SAX 퍼서를 돌려줍니다.

반환값:: 이 클래스의 구현에 의해 캡슐화된다 SAX 퍼서
예외:: SAXException - 처리중에 SAX 에러가 발생했을 경우

getXMLReader

public abstract XMLReader  getXMLReader()
                                throws SAXException

이 클래스의 구현에 의해 캡슐화되는 XMLReader 를 돌려줍니다.

반환값:: 이 클래스의 구현에 의해 캡슐화된다 XMLReader
예외:: SAXException - 처리중에 SAX 에러가 발생했을 경우

isNamespaceAware

public abstract boolean isNamespaceAware()

이 퍼서가 이름 공간을 인식하도록(듯이) 설정되어 있는지 어떤지를 나타냅니다.

반환값:: 이 퍼서가 이름 공간을 인식하도록(듯이) 설정되어 있는 경우는 true, 그렇지 않은 경우는 false

isValidating

public abstract boolean isValidating()

이 퍼서가 XML 문서를 검증하도록(듯이) 설정되어 있는지 어떤지를 나타냅니다.

반환값:: 이 퍼서가 XML 문서를 검증하도록(듯이) 설정되어 있는 경우는 true, 그렇지 않은 경우는 false

setProperty

public abstract void setProperty(String  name,
                                 Object  value)
                          throws SAXNotRecognizedException ,
                                 SAXNotSupportedException

XMLReader 의 기본이 되는 구현에 특정의 프로퍼티을 설정합니다. 코어 기능과 코어 프로퍼티의 리스트에 대해서는, http://sax.sourceforge.net/? selected=get-set 의 사이트를 참조해 주세요.

파라미터:: name - 설정되는 프로퍼티의 이름; value - 설정되는 프로퍼티의 값
예외:: SAXNotRecognizedException - 기본이 되는 XMLReader 가 프로퍼티명을 인식하지 않는 경우; SAXNotSupportedException - 기본이 되는 XMLReader 는 프로퍼티명을 인식하지만, 그 프로퍼티을 지원하지 않는 경우
관련 항목:: XMLReader.setProperty(java.lang.String, java.lang.Object)

getProperty

public abstract Object  getProperty(String  name)
                            throws SAXNotRecognizedException ,
                                   SAXNotSupportedException

XMLReader 의 기본이 되는 구현으로 요구된 특정의 프로퍼티을 돌려줍니다.

파라미터:: name - 꺼내지는 프로퍼티의 이름
반환값:: 요구된 프로퍼티의 값
예외:: SAXNotRecognizedException - 기본이 되는 XMLReader 가 프로퍼티명을 인식하지 않는 경우; SAXNotSupportedException - 기본이 되는 XMLReader 는 프로퍼티명을 인식하지만, 그 프로퍼티을 지원하지 않는 경우
관련 항목:: XMLReader.getProperty(java.lang.String)

getSchema

public Schema  getSchema()

XML 프로세서에 의해 사용되는 Schema 에의 참조를 가져옵니다.

schema를 사용하고 있지 않는 경우는 null 가 돌려주어집니다.

반환값:: 사용되고 있는 Schema 또는 사용되어 있지 않은 경우는 null
예외:: UnsupportedOperationException - 구현이 이 메소드를 오버라이드(override) 하지 않는 경우
도입된 버젼:: 1.5

isXIncludeAware

public boolean isXIncludeAware()

이 퍼서의 XInclude 처리 모드를 가져옵니다.

반환값:: 이 퍼서가 팩토리로부터 작성되었을 때에 SAXParserFactory.isXIncludeAware() 로부터 되돌려지는 값
예외:: UnsupportedOperationException - 구현이 이 메소드를 오버라이드(override) 하지 않는 경우
도입된 버젼:: 1.5
관련 항목:: SAXParserFactory.setXIncludeAware(boolean)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세: 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

javax.xml.parsers 클래스 SAXParser

SAXParser

reset

parse

parse

parse

parse

parse

parse

parse

parse

parse

parse

getParser

getXMLReader

isNamespaceAware

isValidating

setProperty

getProperty

getSchema

isXIncludeAware

javax.xml.parsers
클래스 SAXParser