org.xml.sax.InputSource
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
java.lang.Object
public class InputSource
XML 엔티티의 단일의 입력 소스입니다.
이 모듈은 원시 코드, 문서 모두 공개 도메인에 놓여져 있습니다. 따라서, 내용에 관한보증은 일절 제공되지 않습니다. 상세한 것에 대하여는 http://www.saxproject.org 를 참조하십시오.
SAX 어플리케이션은 이 클래스를 이용해 입력 소스에 관한 정보를 단일의 객체에 캡슐화합니다. 이 객체에는 공개 식별자, 시스템 식별자, 바이트 스트림 (인코딩이 가리키는 경우도 있다), 문자 스트림등이 포함됩니다.
어플리케이션은 입력 소스를 Parser.parse 메서드의 인수로서 혹은 EntityResolver.resolveEntity 메서드의 반환값으로서 파서에 건네줄 수가 있습니다.
SAX 파서는 InputSource 객체를 사용해 XML 입력을 읽어들이는 방법을 결정합니다. 사용 가능한 문자 스트림이 있는 경우, 파서는 그 스트림내에서 발견된 텍스트 인코딩 선언을 무시해, 그 스트림을 직접 읽어들입니다. 문자 스트림이 없고, 바이트 스트림이 있는 경우, 파서는 InputSource 로 지정된 인코딩을 사용해, 그 바이트 스트림을 사용합니다. 혹은 인코딩이 지정되어 있지 않은 경우는 XML 사양에 있는 것 같은 알고리즘을 사용한 문자 인코딩을 자동 검출해, 그 바이트 스트림을 사용합니다. 문자 스트림과 바이트 스트림의 어느쪽이나 사용할 수 없는 경우, 파서는 시스템 식별자에 의해 식별된 자원에의 URI 접속을 열려고 합니다.
InputSource 객체는 어플리케이션에 소속하기 때문에 이것을 SAX 파서가 변경할 수 없습니다만, 필요에 따라서 카피하는 것은 가능합니다. 다만, 바이트 스트림과 문자 스트림의 양쪽 모두의 표준적인 처리는 그것들을 end-of-parse 클린 업의 일환으로서 닫는 것이다 모아 두어 어플리케이션은 파서에게 건네진 후에 그러한 스트림을 재이용하려고는 하지 않습니다.
XMLReader.parse(org.xml.sax.InputSource),
EntityResolver.resolveEntity(java.lang.String, java.lang.String),
InputStream,
Reader | 생성자 개요 | |
|---|---|
InputSource ()
디폴트의 인수 없음의 constructor |
|
InputSource (InputStream byteStream)
바이트 스트림을 지정해 새로운 입력 소스를 작성합니다. |
|
InputSource (Reader characterStream)
문자 스트림을 지정해 새로운 입력 소스를 작성합니다. |
|
InputSource (String systemId)
시스템 식별자를 지정해 새로운 입력 소스를 작성합니다. |
|
| 메서드 개요 | |
|---|---|
InputStream |
getByteStream ()
이 입력 소스의 바이트 스트림을 취득합니다. |
Reader |
getCharacterStream ()
이 입력 소스의 문자 스트림을 취득합니다. |
String |
getEncoding ()
바이트 스트림 또는 URL 문자 인코딩을 취득합니다. |
String |
getPublicId ()
이 입력 소스의 공개 식별자를 취득합니다. |
String |
getSystemId ()
이 입력 소스의 시스템 식별자를 취득합니다. |
void |
setByteStream (InputStream byteStream)
이 입력 소스의 바이트 스트림을 설정합니다. |
void |
setCharacterStream (Reader characterStream)
이 입력 소스의 문자 스트림을 설정합니다. |
void |
setEncoding (String encoding)
캐릭터 세트를 알 수 있는인 경우, 이것을 설정합니다. |
void |
setPublicId (String publicId)
이 입력 소스의 공개 식별자를 설정합니다. |
void |
setSystemId (String systemId)
이 입력 소스의 시스템 식별자를 설정합니다. |
| 클래스 java.lang. Object 로부터 상속된 메서드 |
|---|
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
| 생성자 상세 |
|---|
public InputSource()
setPublicId(java.lang.String),
setSystemId(java.lang.String),
setByteStream(java.io.InputStream),
setCharacterStream(java.io.Reader),
setEncoding(java.lang.String) public InputSource(String systemId)
setPublicId를 사용해, 어플리케이션에 공개 식별자를 포함할 수도 있습니다. setEncoding를 사용해 기존의 캐릭터 세트를 지정할 수도 있습니다.
시스템 식별자가 URL 인 경우, 완전하게 해결할 필요가 있습니다. 또, 상대 URL가 아닌 경우도 있습니다.
systemId - 시스템 식별자 (URI)setPublicId(java.lang.String),
setSystemId(java.lang.String),
setByteStream(java.io.InputStream),
setEncoding(java.lang.String),
setCharacterStream(java.io.Reader) public InputSource(InputStream byteStream)
어플리케이션의 작성자는 setSystemId()를 사용해 상대 URI 베이스를 제공할 필요가 있습니다. SetPublicId를 사용해 어플리케이션에 공개 식별자를 포함하거나 setEncoding를 사용해 객체의 캐릭터 세트를 지정할 수도 있습니다.
byteStream - 문서를 포함한 raw 바이트 스트림setPublicId(java.lang.String),
setSystemId(java.lang.String),
setEncoding(java.lang.String),
setByteStream(java.io.InputStream),
setCharacterStream(java.io.Reader) public InputSource(Reader characterStream)
어플리케이션의 작성자는 setSystemId()를 사용해, 상대 URI를 해결하기 위한 베이스를 제공할 필요가 있습니다. 또, setPublicId를 사용해 어플리케이션에 공개 식별자를 포함할 수 있습니다 .
바이트 순서 기호는 문자 스트림에 포함되지 않습니다.
setPublicId(java.lang.String),
setSystemId(java.lang.String),
setByteStream(java.io.InputStream),
setCharacterStream(java.io.Reader) | 메서드의 상세 |
|---|
public void setPublicId(String publicId)
공개 식별자는 항상 옵션입니다. 어플리케이션에 공개 식별자를 포함하고 싶은 경우는 위치 정보의 일부로서 지정합니다.
publicId - 공개 식별자를 나타내는 캐릭터 라인getPublicId(),
Locator.getPublicId(),
SAXParseException.getPublicId() public String getPublicId()
setPublicId(java.lang.String) public void setSystemId(String systemId)
바이트 스트림 또는 문자 스트림이 있는 경우, 시스템 식별자는 생략 가능하지만, 지정하는 것이 편리합니다. 어플리케이션은 그것을 사용해 상대 URI를 해결해, 에러 메세지나 경고에 포함할 수가 있기 때문에입니다. 파서는 바이트 스트림 또는 문자 스트림이 지정되어 있지 않은 경우에 한정해, URI 에의 접속을 열려고 합니다.
시스템 식별자가 가리키는 객체의 캐릭터 세트를 알 수 있는인 경우, 어플리케이션은 setEncoding 메서드를 사용해 이 인코딩을 등록할 수 있습니다.
시스템 식별자가 URL 인 경우, 완전하게 해결할 필요가 있습니다. 또, 상대 URL가 아닌 경우도 있습니다.
systemId - 시스템 식별자를 나타내는 캐릭터 라인setEncoding(java.lang.String),
getSystemId(),
Locator.getSystemId(),
SAXParseException.getSystemId() public String getSystemId()
getEncoding 메서드는 이 시스템 식별자가 가리키는 객체의 캐릭터 세트를 리턴합니다. 불명한 경우는 null을 리턴합니다.
시스템 식별자가 URL 인 경우, 완전하게 해결됩니다.
setSystemId(java.lang.String),
getEncoding() public void setByteStream(InputStream byteStream)
SAX 파서는 바이트 스트림 외에 문자 스트림이 가리키는 경우, 바이트 스트림을 무시합니다. 바이트 스트림은 URI 접속을 개시하는 것보다 우선적으로 사용됩니다.
바이트 스트림의 캐릭터 세트를 알 수 있는인 경우, 어플리케이션은 setEncoding 메서드를 사용해 이 인코딩을 설정할 필요가 있습니다.
byteStream - XML 문서 또는 그 외의 엔티티를 포함한 바이트 스트림setEncoding(java.lang.String),
getByteStream(),
getEncoding(),
InputStream public InputStream getByteStream()
getEncoding 메서드는 이 바이트 스트림의 캐릭터 세트를 리턴합니다. 불명한 경우는 null을 리턴합니다.
getEncoding(),
setByteStream(java.io.InputStream) public void setEncoding(String encoding)
인코딩은 XML 인코딩 선언 (XML 1.0 권고의 섹션 4.3. 3을 참조)의 규정에 맞은 캐릭터 라인이 아니면 안됩니다.
어플리케이션이 문자 스트림을 제공하는 경우, 이 메서드에는 무슨 효과도 없습니다.
encoding - 캐릭터 세트를 설명하는 캐릭터 라인setSystemId(java.lang.String),
setByteStream(java.io.InputStream),
getEncoding() public String getEncoding()
setByteStream(java.io.InputStream),
getSystemId(),
getByteStream() public void setCharacterStream(Reader characterStream)
문자 스트림이 가리키는 경우, SAX 파서는 바이트 스트림을 무시해, 또, 시스템 식별자에의 URI 접속을 개시하지 않습니다.
characterStream - XML 문서 또는 그 외의 엔티티를 포함한 문자 스트림getCharacterStream(),
Reader public Reader getCharacterStream()
setCharacterStream(java.io.Reader)
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조하십시오.