javax.xml.transform
클래스 Transformer

java.lang.Object 
  javax.xml.transform.Transformer

public abstract class Transformer
extends Object 

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

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

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

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

생성자 개요

protected

Transformer () 디폴트의 생성자가 도적으로 보호됩니다.

메서드 개요

abstract void	clearParameters () setParameter를 사용해 설정된 모든 파라미터를 클리어 합니다.
abstract ErrorListener	getErrorListener () 변환에 유효한 에러 이벤트 핸들러를 취득합니다.
abstract Properties	getOutputProperties () 변환을 위한 출력 프로퍼티의 복사본을 취득합니다.
abstract String	getOutputProperty (String name) transformer에 유효한 출력 프로퍼티를 취득합니다.
abstract Object	getParameter (String name) setParameter를 사용해 명시적으로 설정된 파라미터를 취득합니다.
abstract URIResolver	getURIResolver () document()로 사용되는 URI를 해결하는데 사용되는 객체를 취득합니다.
void	reset () 이 Transformer를 원의 설정에 리셋 합니다.
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) XML Source를 Result로 변환합니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

Transformer

protected Transformer()

디폴트의 생성자가 도적으로 보호됩니다.

메서드의 상세

reset

public void reset()

이 Transformer를 원의 설정에 리셋 합니다.

Transformer는 TransformerFactory.newTransformer(), TransformerFactory.newTransformer(Source source), 또는 Templates.newTransformer() 로 작성된 시점 상태에 리셋 됩니다. reset()는 기존의 Transformer 재사용을 허가하도록 설정되어 있기 때문에 새로운 Transformer 작성에 관련된 자원을 절약할 수 있습니다.

Transformer를 리셋 했을 경우, 같은 URIResolver 또는 ErrorListener Object를 가지는 것은 보증되지 않습니다. 예를 들어, Object.equals(Object obj) 등입니다. 기능적으로 같은 URIResolver 나 ErrorListener를 가지는 것은 보증됩니다.

도입된 버전 :

1.5

transform

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

XML Source를 Result로 변환합니다. Transformer가 인스턴스화 되어Transformer인스턴스가 변경되었을 때의 특정의 변환 동작은 유효한 TransformerFactory 설정에 의해 판정됩니다.

비어있는 Source는 DocumentBuilder.newDocument() 에 의해 구축된 비어있는 문서로서 나타내집니다. 비어있는 Source 변환 결과는 변환 동작에 따라서 달라, 항상 비어있는 Result이 되는 것은 아닙니다.

파라미터:

xmlSource - 변환하는 XML 입력

outputTarget - xmlSource 변환의 Result

예외:

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 객체가 가능. 적절한 객체의 강제를 제공하는 것, 또는 전개로 사용하기 위해서 단지 객체를 건네주는 것은 처리하는 측에서 실시한다

예외:

NullPointerException - value가 null인 경우

getParameter

public abstract Object  getParameter(String  name)

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

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

파라미터:

name - 얻는 Object 이름

반환값:

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

clearParameters

public abstract void clearParameters()

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

setURIResolver

public abstract void setURIResolver(URIResolver  resolver)

document()로 사용되는 URI를 해결하는데 사용되는 객체를 설정합니다.

resolver 인수가 null인 경우, URIResolver 치는 클리어 되어 transformer는 resolver를 가지지 않게 됩니다.

파라미터:

resolver - URIResolver 인터페이스를 구현하는 객체, 또는 null

getURIResolver

public abstract URIResolver  getURIResolver()

document()로 사용되는 URI를 해결하는데 사용되는 객체를 취득합니다.

반환값:

URIResolver 인터페이스를 구현하는 객체, 또는 null

setOutputProperties

public abstract void setOutputProperties(Properties  oformat)

변환의 출력 프로퍼티를 설정합니다. 이러한 프로퍼티는 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가 되어, 접두사는 사용되지 않습니다.

어느 인수 키도 인식되지 않고, 이름 공간에서 수식되어 있지 않은 경우, IllegalArgumentException가 발생 됩니다.

파라미터:

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

관련 항목:

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 객체의 변경은 transformer에 포함되는 프로퍼티에는 영향을 주지 않습니다.

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

반환값:

다음의 변환에 유효한 출력 프로퍼티세트의 카피

관련 항목:

OutputKeys, Properties, 「XSL Transformations (XSLT) Version 1.0」

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 

transformer에 유효한 출력 프로퍼티를 취득합니다. 지정된 프로퍼티는 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은 불가