javax.xml.transform
클래스 Transformer

java.lang.Object 
  |
  +--javax.xml.transform.Transformer

public abstract class Transformer

extends Object

이 추상 클래스의 인스턴스는 소스 트리를 결과 트리로 변환할 수가 있습니다.

이 클래스의 인스턴스를 취득하려면 , TransformerFactory.newTransformer 메소드를 사용합니다. 그 후, 이 인스턴스를 사용해, 다양한 소스로부터 XML 를 처리해, 변환 결과를 다양한 sink에 출력할 수가 있습니다.

이 클래스의 오브젝트는 동시에 동작하는 복수의 thread로 사용할 수 없습니다. 다른 thread에서는 동시에 사용되는 Transformer 도 다릅니다.

Transformer 는 여러 차례 사용할 수 있습니다. 파라미터와 출력 프로퍼티는 변환 전체를 통해 보관 유지됩니다.

생성자의 개요

protected

Transformer () 디폴트의 constructor 이 의도적으로 보호됩니다.

메소드의 개요

abstract void	clearParameters () setParameter 를 사용해 설정된 모든 파라미터를 클리어 합니다.
abstract ErrorListener	getErrorListener () 변환에 유효한 에러 이벤트 핸들러를 취득합니다.
abstract Properties	getOutputProperties () 변환을 위한 출력 프로퍼티의 카피를 취득합니다.
abstract String	getOutputProperty (String name) 변환에 유효한 출력 프로퍼티를 취득합니다.
abstract Object	getParameter (String name) setParameter 또는 setParameters 를 사용해 명시적으로 설정된 파라미터를 취득합니다.
abstract URIResolver	getURIResolver () document()등으로 사용되는 URI 를 해결하는데 사용되는 오브젝트를 취득합니다.
abstract void	setErrorListener (ErrorListener listener) 변환에 유효한 에러 이벤트 청취자를 설정합니다.
abstract void	setOutputProperties (Properties oformat) 변환의 출력 프로퍼티를 설정합니다.
abstract void	setOutputProperty (String name, String value) 변환에 유효한 출력 프로퍼티를 설정합니다.
abstract void	setParameter (String name, Object value) 변환의 파라미터를 추가합니다.
abstract void	setURIResolver (URIResolver resolver) document()로 사용되는 URI 를 해결하는데 사용되는 오브젝트를 설정합니다.
abstract void	transform (Source xmlSource, Result outputTarget) 소스 트리를 출력 결과에 처리합니다.

클래스 java.lang. Object 에서 상속받은 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

생성자의 상세

Transformer

protected Transformer()

디폴트의 constructor 이 의도적으로 보호됩니다.

메소드의 상세

transform

public abstract void transform(Source  xmlSource,
                               Result  outputTarget)
                        throws TransformerException 

소스 트리를 출력 결과에 처리합니다.

파라미터:

xmlSource - 소스 트리의 입력

outputTarget - 출력 타겟

예외:

TransformerException - 변환중에 회복 불능인 에러가 발생했을 경우

setParameter

public abstract void setParameter(String  name,
                                  Object  value)

변환의 파라미터를 추가합니다.

수식명을, 안괄호 ({})로 둘러싸인 이름 공간 URI 의 후에 로컬명이 계속되는 2 부 형식의 캐릭터 라인으로서 건네줍니다. 이름이 null 의 URL 를 가지는 경우, String 에는 로컬명만이 포함됩니다. 어플리케이션은 이름의 최초의 캐릭터가 「{」캐릭터일지 어떨지를 판정해, null 가 아닌 URI 를 안전하게 체크할 수 있습니다.

예를 들어, <xyz:foo xmlns:xyz="http://xyz.foo.com/yada/baz.html"/> 로 정의된 요소로부터 URI 와 로컬명을 취득했을 경우, 수식명은 {http://xyz.foo.com/yada/baz.html}foo 가 되어, 접두사는 사용되지 않습니다.

파라미터:

name - 파라미터의 이름. 안괄호 ({})로 둘러싸인 이름 공간 URI 로 시작되는 경우가 있는

value - 치 오브젝트. 임의의 유효한 Java 오브젝트가 가능. 적절한 오브젝트의 강제를 제공하는 것, 또는 전개로 사용하기 위해서 단지 오브젝트를 건네주는 것은 처리하는 측에서 실시한다

getParameter

public abstract Object  getParameter(String  name)

setParameter 또는 setParameters 를 사용해 명시적으로 설정된 파라미터를 취득합니다.

이 메소드는 디폴트의 파라미터치를 돌려주지 않습니다. 파라미터치는 변환 처리중에 노드 문맥이 평가될 때까지 결정할 수 없습니다.

반환값:

setParameter 를 사용해 설정된 파라미터

clearParameters

public abstract void clearParameters()

setParameter 를 사용해 설정된 모든 파라미터를 클리어 합니다.

setURIResolver

public abstract void setURIResolver(URIResolver  resolver)

document()로 사용되는 URI 를 해결하는데 사용되는 오브젝트를 설정합니다.

resolver의 인수가 null 의 경우, URIResolver 치는 클리어 되어 디폴트의 동작이 사용됩니다.

파라미터:

resolver - URIResolver 인터페이스를 구현하는 오브젝트, 또는 null

getURIResolver

public abstract URIResolver  getURIResolver()

document()등으로 사용되는 URI 를 해결하는데 사용되는 오브젝트를 취득합니다.

반환값:

URIResolver 인터페이스를 구현하는 오브젝트, 또는 null

setOutputProperties

public abstract void setOutputProperties(Properties  oformat)
                                  throws IllegalArgumentException 

변환의 출력 프로퍼티를 설정합니다. 이러한 프로퍼티는 xsl:output 로 Templates 로 설정된 프로퍼티를 오버라이드(override) 합니다.

이 함수의 인수가 null 의 경우, 이전으로 설정된 프로퍼티는 삭제되어 값은 템플릿 오브젝트로 정의된 값에 되돌려집니다.

수식된 프로퍼티 키명을, 안괄호 ({})로 둘러싸인 이름 공간 URI 의 후에 로컬명이 계속되는 2 부 형식의 캐릭터 라인으로서 건네줍니다. 이름이 null 의 URL 를 가지는 경우, String 에는 로컬명만이 포함됩니다. 어플리케이션은 이름의 최초의 캐릭터가 「{」캐릭터일지 어떨지를 판정해, null 가 아닌 URI 를 안전하게 체크할 수 있습니다.

예를 들어, <xyz:foo xmlns:xyz="http://xyz.foo.com/yada/baz.html"/> 로 정의된 요소로부터 URI 와 로컬명을 취득했을 경우, 수식명은 {http://xyz.foo.com/yada/baz.html}foo 가 되어, 접두사는 사용되지 않습니다.

파라미터:

oformat - 변환에 영향을 주는 같은 프로퍼티를 오버라이드(override) 하기 위해서 사용되는 출력 프로퍼티세트

예외:

IllegalArgumentException - 어느 인수 키도 인식되지 않는가, 이름 공간에서 수식되어 있지 않은 경우

관련 항목:

OutputKeys , Properties

getOutputProperties

public abstract Properties  getOutputProperties()

변환을 위한 출력 프로퍼티의 카피를 취득합니다.

돌려주어진 프로퍼티에는 유저가 설정한 프로퍼티와 스타일 시트로 설정된 프로퍼티가 포함되어 이러한 프로퍼티는「XSL Transformations (XSLT) W3C Recommendation 의 섹션 16」으로 지정된 디폴트의 프로퍼티로 「디폴트화」됩니다. 유저 또는 스프레드쉬트에 의해 특히 설정된 프로퍼티는 기본의 Properties 리스트에 있어, 특히 설정되지 않았던 XSLT 디폴트 프로퍼티는 디폴트의 Properties 리스트에 있습니다. 따라서, getOutputProperties(). getProperty(String key)는 스타일 시트의 setOutputProperty(java.lang.String, java.lang.String) ,setOutputProperties(java.util.Properties) 로 설정된 프로퍼티, 또는 디폴트의 프로퍼티를 취득해, getOutputProperties(). get(String key)는 setOutputProperty(java.lang.String, java.lang.String) ,setOutputProperties(java.util.Properties) , 또는 스타일 시트로 명시적으로 설정된 프로퍼티만을 취득합니다.

돌려주어진 Properties 오브젝트의 변경은 변환에 포함되는 프로퍼티에는 영향을 주지 않습니다.

어느 인수 키도 인식되지 않고 이름 공간에서 수식되어 있지 않은 경우, 프로퍼티는 무시됩니다. 즉, 동작은 setOutputProperties 와 교착하지 않습니다.

관련 항목:

OutputKeys , Properties

setOutputProperty

public abstract void setOutputProperty(String  name,
                                       String  value)
                                throws IllegalArgumentException 

변환에 유효한 출력 프로퍼티를 설정합니다.

수식된 프로퍼티명을, 안괄호 ({})로 둘러싸인 이름 공간 URI 의 후에 로컬명이 계속되는 2 부 형식의 캐릭터 라인으로서 건네줍니다. 이름이 null 의 URL 를 가지는 경우, String 에는 로컬명만이 포함됩니다. 어플리케이션은 이름의 최초의 캐릭터가 「{」캐릭터일지 어떨지를 판정해, null 가 아닌 URI 를 안전하게 체크할 수 있습니다.

예를 들어, <xyz:foo xmlns:xyz="http://xyz.foo.com/yada/baz.html"/> 로 정의된 요소로부터 URI 와 로컬명을 취득했을 경우, 수식명은 {http://xyz.foo.com/yada/baz.html}foo 가 되어, 접두사는 사용되지 않습니다.

setOutputProperties(java.util.Properties) 에게 건네진 Properties 오브젝트는 이 메소드의 호출의 영향을 받지 않습니다.

파라미터:

name - 출력 프로퍼티명을 지정하는 null 이외의 String. 이름 공간에서 수식되고 있는 경우가 있는

value - 출력 프로퍼티의 null 이외의 캐릭터 라인치

예외:

IllegalArgumentException - 프로퍼티가 서포트되어 있지 않은지 이름 공간에서 수식되어 있지 않은 경우

관련 항목:

OutputKeys

getOutputProperty

public abstract String  getOutputProperty(String  name)
                                  throws IllegalArgumentException 

변환에 유효한 출력 프로퍼티를 취득합니다. 지정된 프로퍼티는 setOutputProperty 를 사용해 설정된 프로퍼티인가, 스타일 시트로 지정된 프로퍼티인 경우가 있습니다.

파라미터:

name - 출력 프로퍼티명을 지정하는 null 이외의 String. 이름 공간에서 수식되고 있는 경우가 있다

반환값:

출력 프로퍼티의 캐릭터 라인치. 프로퍼티가 발견되지 않았던 경우는 null

예외:

IllegalArgumentException - 프로퍼티가 서포트되어 있지 않은 경우

관련 항목:

OutputKeys

setErrorListener

public abstract void setErrorListener(ErrorListener  listener)
                               throws IllegalArgumentException 

변환에 유효한 에러 이벤트 청취자를 설정합니다.

파라미터:

listener - 새로운 에러 청취자

예외:

IllegalArgumentException - 청취자가 null 의 경우

getErrorListener

public abstract ErrorListener  getErrorListener()

변환에 유효한 에러 이벤트 핸들러를 취득합니다.

반환값:

현재의 에러 핸들러. null 는 불가