JavaTM Platform
Standard Ed. 6

javax.xml.transform.stream
클래스 StreamSource

java.lang.Object 
  상위를 확장 javax.xml.transform.stream.StreamSource
모든 구현된 인터페이스:
Source


public class StreamSource
extends Object
implements Source

XML 마크 업의 스트림의 형식에서 변환 Source 의 홀더로서 동작합니다.

 

주: Reader 또는 InputStream 인스턴스가 내부 사용되기 (위해)때문에,StreamSource 인스턴스를 사용할 수 있는 것은 한 번 뿐입니다.


필드의 개요
static String FEATURE
          이 값을 인수로서 건네주었을 때에 TransformerFactory.getFeature(java.lang.String) 가 true 를 돌려주는 경우, Transformer 는 이 형태의 Source 입력을 지원합니다.
 
생성자 의 개요
StreamSource ()
          디폴트의 인수 없음의 생성자 이 생성자 이 사용되고 있어,setInputStream(java.io.InputStream inputStream) 또는 setReader(java.io.Reader reader) 를 사용해 설정된 Stream 소스가 없는 경우,Transformernew InputStream() 를 사용해 빈 상태(empty)의 소스 InputStream 를 작성합니다.
StreamSource (File  f)
          File 로부터 StreamSource 를 구축합니다.
StreamSource (InputStream  inputStream)
          바이트 스트림로부터 StreamSource 를 구축합니다.
StreamSource (InputStream  inputStream, String  systemId)
          바이트 스트림로부터 StreamSource 를 구축합니다.
StreamSource (Reader  reader)
          문자 리더로부터 StreamSource 를 구축합니다.
StreamSource (Reader  reader, String  systemId)
          문자 리더로부터 StreamSource 를 구축합니다.
StreamSource (String  systemId)
          URL 로부터 StreamSource 를 구축합니다.
 
메소드의 개요
 InputStream getInputStream ()
          setByteStream 를 사용해 설정된 바이트 스트림을 가져옵니다.
 String getPublicId ()
          setPublicId 를 사용해 설정된 공개 식별자를 가져옵니다.
 Reader getReader ()
          setReader 를 사용해 설정된 문자 스트림을 가져옵니다.
 String getSystemId ()
          setSystemId 를 사용해 설정된 시스템 식별자를 가져옵니다.
 void setInputStream (InputStream  inputStream)
          입력으로서 사용되는 바이트 스트림을 설정합니다.
 void setPublicId (String  publicId)
          이 Source 의 공개 식별자를 설정합니다.
 void setReader (Reader  reader)
          문자 리더가 되는 입력을 구축합니다.
 void setSystemId (File  f)
          File 참조로부터 시스템 식별자를 설정합니다.
 void setSystemId (String  systemId)
          이 Source 의 시스템 식별자를 설정합니다.
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait
 

필드의 상세

FEATURE

public static final String  FEATURE
이 값을 인수로서 건네주었을 때에 TransformerFactory.getFeature(java.lang.String) 가 true 를 돌려주는 경우, Transformer 는 이 형태의 Source 입력을 지원합니다.

관련 항목:
정수 필드치
생성자 의 상세

StreamSource

public StreamSource()

디폴트의 인수 없음의 생성자 이 생성자 이 사용되고 있어,setInputStream(java.io.InputStream inputStream) 또는 setReader(java.io.Reader reader) 를 사용해 설정된 Stream 소스가 없는 경우,Transformernew InputStream() 를 사용해 빈 상태(empty)의 소스 InputStream 를 작성합니다.

관련 항목:
Transformer.transform(Source xmlSource, Result outputTarget)

StreamSource

public StreamSource(InputStream  inputStream)
바이트 스트림로부터 StreamSource 를 구축합니다. 일반적으로, 리더가 아니고 스트림을 사용할 필요가 있습니다. 그러면, XML 퍼서는 XML 선언으로 지정된 캐릭터 세트를 해결할 수가 있습니다.  

이 생성자 을 사용해 스타일 시트를 처리하는 경우, 일반적으로은, 상대 URI 참조를 해결할 수 있도록(듯이) setSystemId 도 호출할 필요가 있습니다.

파라미터:
inputStream - XML 스트림에의 유효한 InputStream 참조

StreamSource

public StreamSource(InputStream  inputStream,
                    String  systemId)
바이트 스트림로부터 StreamSource 를 구축합니다. 일반적으로은, 리더가 아니고 스트림을 사용할 필요가 있습니다. 그러면, XML 퍼서는 XML 선언으로 지정된 캐릭터 세트를 해결할 수가 있습니다.  

이 생성자 에 의해, 입력 스트림에 가세해 시스템 식별자를 설정할 수가 있어 상대 URI 를 처리할 수 있게 됩니다.

파라미터:
inputStream - XML 스트림에의 유효한 InputStream 참조
systemId - URI 구문에 적합하는 String 가 아니면 안된다

StreamSource

public StreamSource(Reader  reader)
문자 리더로부터 StreamSource 를 구축합니다. 일반적으로은, 리더가 아니고 스트림을 사용할 필요가 있습니다. 그러면, XML 퍼서는 XML 선언으로 지정된 캐릭터 세트를 해결할 수가 있습니다. 다만, StringReader 로부터 XML 를 읽어들이는 경우와 같이, 많은 경우, 입력 스트림의 인코딩은 벌써 해결되고 있습니다.

파라미터:
reader - XML 문자 스트림에의 유효한 Reader 참조

StreamSource

public StreamSource(Reader  reader,
                    String  systemId)
문자 리더로부터 StreamSource 를 구축합니다. 일반적으로은, 리더가 아니고 스트림을 사용할 필요가 있습니다. 그러면, XML 퍼서는 XML 선언으로 지정된 캐릭터 세트를 해결할 수가 있습니다. 다만, StringReader 로부터 XML 를 읽어들이는 경우와 같이, 많은 경우, 입력 스트림의 인코딩은 벌써 해결되고 있습니다.

파라미터:
reader - XML 문자 스트림에의 유효한 Reader 참조
systemId - URI 구문에 적합하는 String 가 아니면 안된다

StreamSource

public StreamSource(String  systemId)
URL 로부터 StreamSource 를 구축합니다.

파라미터:
systemId - URI 구문에 적합하는 String 가 아니면 안된다

StreamSource

public StreamSource(File  f)
File 로부터 StreamSource 를 구축합니다.

파라미터:
f - null 이외의 File 참조가 아니면 안된다
메소드의 상세

setInputStream

public void setInputStream(InputStream  inputStream)
입력으로서 사용되는 바이트 스트림을 설정합니다. 일반적으로은, 리더가 아니고 스트림을 사용할 필요가 있습니다. 그러면, XML 퍼서는 XML 선언으로 지정된 캐릭터 세트를 해결할 수가 있습니다.  

이 Source 객체를 사용해 스타일 시트를 처리하는 경우, 일반적으로은, 상대 URL 참조를 해결할 수 있도록(듯이) setSystemId 도 호출할 필요가 있습니다.

파라미터:
inputStream - XML 스트림에의 유효한 InputStream 참조

getInputStream

public InputStream  getInputStream()
setByteStream 를 사용해 설정된 바이트 스트림을 가져옵니다.

반환값:
setByteStream 를 사용해 설정된 바이트 스트림. setByteStream 또는 ByteStream 생성자 이 불려 가지 않았던 경우는 null

setReader

public void setReader(Reader  reader)
문자 리더가 되는 입력을 구축합니다. 일반적으로은, 리더가 아니고 스트림을 사용할 필요가 있습니다. 그러면, XML 퍼서는 XML 선언으로 지정된 캐릭터 세트를 해결할 수가 있습니다. 다만, StringReader 로부터 XML 를 읽어들이는 경우와 같이, 많은 경우, 입력 스트림의 인코딩은 벌써 해결되고 있습니다.

파라미터:
reader - XML CharacterStream 에의 유효한 Reader 참조

getReader

public Reader  getReader()
setReader 를 사용해 설정된 문자 스트림을 가져옵니다.

반환값:
setReader 를 사용해 설정된 문자 스트림. setReader 또는 Reader 생성자 이 불려 가지 않았던 경우는 null

setPublicId

public void setPublicId(String  publicId)
이 Source 의 공개 식별자를 설정합니다.  

공개 식별자는 항상 생략 가능합니다. 어플리케이션에 공개 식별자를 포함하고 싶은 경우는, 위치 정보의 일부로서 지정합니다.

파라미터:
publicId - 공개 식별자를 나타내는 캐릭터 라인

getPublicId

public String  getPublicId()
setPublicId 를 사용해 설정된 공개 식별자를 가져옵니다.

반환값:
setPublicId 를 사용해 설정된 공개 식별자. setPublicId 가 불려 가지 않았던 경우는 null

setSystemId

public void setSystemId(String  systemId)
이 Source 의 시스템 식별자를 설정합니다.  

바이트 스트림 또는 문자 스트림이 있는 경우, 시스템 식별자는 생략 가능합니다만, 지정하는 것이 편리합니다. 어플리케이션은 그것을 사용해 상대 URI 를 해결해, 에러 메세지나 경고에 포함할 수가 있기 (위해)때문에입니다. 퍼서는, 바이트 스트림 또는 문자 스트림이 지정되어 있지 않은 경우에 한해, URI 에의 접속을 열려고 합니다.

정의:
인터페이스 Source 내의 setSystemId
파라미터:
systemId - URL 캐릭터 라인으로서의 시스템 식별자

getSystemId

public String  getSystemId()
setSystemId 를 사용해 설정된 시스템 식별자를 가져옵니다.

정의:
인터페이스 Source 내의 getSystemId
반환값:
setSystemId 를 사용해 설정된 시스템 식별자. setSystemId 가 불려 가지 않았던 경우는 null

setSystemId

public void setSystemId(File  f)
File 참조로부터 시스템 식별자를 설정합니다.

파라미터:
f - null 이외의 File 참조가 아니면 안된다

JavaTM Platform
Standard Ed. 6

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

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.