|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
java.lang.Object | +--org.xml.sax.InputSource
XML 엔티티의 단일의 입력 소스입니다.
이 모듈은 원시 코드, 문서 모두 공개 도메인에 놓여져 있습니다. 따라서, 내용에 관한프로텍션은 일절 제공되지 않습니다.
SAX 어플리케이션은 이 클래스를 이용해 입력 소스에 관한 정보를 단일의 오브젝트에 캡슐화합니다. 이 오브젝트에는 공개 식별자, 시스템 식별자, 바이트 스트림 (인코딩이 지정되고 있는 경우도 있다), 캐릭터 스트림등이 포함됩니다.
어플리케이션은 이 입력 소스를 Parser.parse 메소드의 인수로서 혹은 EntityResolver.resolveEntity 메소드의 반환값으로서 파서에 건네줍니다.
SAX 파서는 이 InputSource 오브젝트를 사용해 XML 입력의 읽을 방법을 결정합니다. 파서는 캐릭터 스트림을 사용할 수 있으면 이것을 직접 읽어들여, 사용할 수 없으면 바이트 스트림을 사용합니다. 캐릭터 스트림도 바이트 스트림도 사용할 수 없는 경우는 시스템 식별자로 나타난 리소스에의 URI 접속을 개시하려고 합니다.
InputSource 오브젝트는 어플리케이션에 소속하기 (위해)때문에, 이것을 SAX 파서가 변경할 수 없습니다. 다만, 필요에 따라서 카피하는 것은 가능합니다.
Parser.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 ()
바이트 스트림 또는 URI 의 캐릭터 세트를 취득합니다. |
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 인 경우, 완전하게 해결할 필요가 있습니다.
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 메소드를 사용해 이 인코딩을 등록할 수 있습니다.
시스템 ID 가 URL 인 경우, 완전하게 해결할 필요가 있습니다.
systemId - 시스템 식별자를 나타내는 캐릭터 라인setEncoding(java.lang.String) ,
getSystemId() ,
Locator.getSystemId() ,
SAXParseException.getSystemId() public String getSystemId()
getEncoding 메소드는 이 시스템 식별자가 가리키는 오브젝트의 캐릭터 세트를 돌려줍니다. 불명한 경우는 null 를 돌려줍니다.
시스템 ID 가 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 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.