org.xml.sax.InputSource
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
| 개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 | |||||||||
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 ()
디폴트의 인수 없음의 생성자 |
|
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 인 경우, 완전하게 해결할 필요가 있습니다. 또, 상대 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 Platform Standard Ed. 6 |
|||||||||
| 앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
| 개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 | |||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.