javax.xml.transform
클래스 TransformerFactory

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

직계의 기존의 서브 클래스:

SAXTransformerFactory

public abstract class TransformerFactory

extends Object

TransformerFactory 인스턴스를 사용해,Transformer 및 Templates 오브젝트를 작성할 수가 있습니다.

어느 팩토리 구현을 작성할까를 결정하는 시스템 프로퍼티의 이름은 javax.xml.transform.TransformerFactory 입니다. 이 프로퍼티는 TransformerFactory 추상 클래스의 구상 서브 클래스를 명명합니다. 이 프로퍼티가 정의되어 있지 않은 경우는 플랫폼의 디폴트가 사용됩니다.

TransformerFactory 클래스의 구현은 thread 세이프인 것은 프로텍션 「되지 않습니다」. 복수의 thread로부터 TransformerFactory 가 사용될지 어떨지의 확인은 유저 어플리케이션으로 실시합니다. 다른 방법으로서 어플리케이션은 thread 당 TransformerFactory 의 1 개의 인스턴스를 가질 수가 있습니다. 팩토리의 인스턴스가 복수의 thread로 동시에 사용되지 않으면, 어플리케이션은 팩토리의 같은 인스턴스를 사용해 Transformer 또는 Templates 의 1 개 이상의 인스턴스를 취득할 수가 있습니다.

생성자의 개요

protected

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

메소드의 개요

abstract Source	getAssociatedStylesheet (Source source, String media, String title, String charset) xml-stylesheet 의 처리 인스트럭션 (http://www.w3.org/TR/xml-stylesheet/ 를 참조)에 의해 소스 파라미터로 지정된 문서에 관련지을 수 있던, 지정된 기준에 일치하는 스타일 시트 사양을 취득합니다.
abstract Object	getAttribute (String name) 유저가 기본이 되는 구현의 특정의 속성을 꺼낼 수가 있게 합니다.
abstract ErrorListener	getErrorListener () TransformerFactory 의 에러 이벤트 핸들러를 취득합니다.
abstract boolean	getFeature (String name) 기능의 값을 검색합니다.
abstract URIResolver	getURIResolver () document(), xsl:import, 또는 xsl:includeSet 로 사용되는 URI 를 해결하기 위해서 변환시에 디폴트로 사용되는 오브젝트를 취득합니다.
static TransformerFactory	newInstance () TransformerFactory 의 새로운 인스턴스를 취득합니다.
abstract Templates	newTemplates (Source source) Source 를 처리해, 소스의 컴파일 표현인 Templates 오브젝트로 합니다.
abstract Transformer	newTransformer () 결과에의 소스의 카피를 실행하는 새로운 Transformer 오브젝트를 작성합니다.
abstract Transformer	newTransformer (Source source) Source 를 Transformer 오브젝트에 처리합니다.
abstract void	setAttribute (String name, Object value) 유저가 기본이 되는 구현에 특정의 속성을 설정할 수 있게 합니다.
abstract void	setErrorListener (ErrorListener listener) TransformerFactory 의 에러 이벤트 청취자를 설정합니다.
abstract void	setURIResolver (URIResolver resolver) xsl:import 또는 xsl:includeSet 로 사용되는 URI 를 해결하기 위해서 변환시에 디폴트로 사용되는 오브젝트를 설정합니다.

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

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

생성자의 상세

TransformerFactory

protected TransformerFactory()

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

메소드의 상세

newInstance

public static TransformerFactory  newInstance()
                                      throws TransformerFactoryConfigurationError 

TransformerFactory 의 새로운 인스턴스를 취득합니다. 이 static 메소드는 새로운 팩토리 인스턴스를 작성합니다. 이 메소드는 다음의 순서의 look 업 순서로, 로드하는 TransformerFactory 구현 클래스를 판정합니다.

• javax.xml.transform.TransformerFactory 시스템 프로퍼티를 사용한다
• JRE 디렉토리내의 프로퍼티 파일 lib/jaxp.properties 를 사용한다. 이 구성 파일은 표준의 java.util.Properties 형식이며, 상기와 같이 정의된 시스템 프로퍼티인 키를 가지는 구현 클래스의 완전 지정의 이름을 포함한다
• 가능하면, JAR 사양으로 상세하게 설명되고 있는 서비스 API 를 사용해, 클래스명을 판정한다. 서비스 API 는 실행시에 사용할 수 있는 jar 내의 META-INF/services/javax.xml.transform.TransformerFactory 파일로부터 클래스명을 검색한다
• 플랫폼의 디폴트의 TransformerFactory 인스턴스

어플리케이션이 TransformerFactory 에의 참조를 취득하면(자), 팩토리를 사용해 파서의 인스턴스를 설정 및 취득할 수가 있습니다.

반환값:

새로운 TransformerFactory 인스턴스. null 는 불가

예외:

TransformerFactoryConfigurationError - 구현을 사용할 수 없는가 인스턴스화할 수 없는 경우

newTransformer

public abstract Transformer  newTransformer(Source  source)
                                    throws TransformerConfigurationException 

Source 를 Transformer 오브젝트에 처리합니다. 이 오브젝트를 동시에 동작하는 복수의 thread로 사용하지 않게 주의를 줄 필요가 있습니다. 다른 thread에서는 동시에 사용되는 TransformerFactories 도 다릅니다.

파라미터:

source - URI, 입력 스트림등을 보관 유지하는 오브젝트

반환값:

1 개의 thread로 변환을 실행하기 위해서 사용되는 Transformer 오브젝트. null 는 불가

예외:

TransformerConfigurationException - Templates 오브젝트의 구축으로 실패했을 경우에 구문 분석시에 슬로우 되는 경우가 있다

newTransformer

public abstract Transformer  newTransformer()
                                    throws TransformerConfigurationException 

결과에의 소스의 카피를 실행하는 새로운 Transformer 오브젝트를 작성합니다.

반환값:

1 개의 thread로 변환을 실행하기 위해서 사용되는 Transformer 오브젝트. null 는 불가

예외:

TransformerConfigurationException - Templates 오브젝트의 구축으로 실패했을 경우에 구문 분석시에 슬로우 되는 경우가 있다

newTemplates

public abstract Templates  newTemplates(Source  source)
                                throws TransformerConfigurationException 

Source 를 처리해, 소스의 컴파일 표현인 Templates 오브젝트로 합니다. 이 Templates 오브젝트는 복수의 thread로 동시에 사용할 수가 있습니다. Templates 오브젝트를 작성하는 것으로써, TransformerFactory 는 변환 인스트럭션의 퍼포먼스의 최적화를 상세하게 실시할 수가 있어 실행시 변환이 저하할 것은 없습니다.

파라미터:

source - URL, 입력 스트림등을 보관 유지하는 오브젝트

반환값:

변환을 위해서(때문에) 사용할 수 있는 Templates 오브젝트. null 는 불가

예외:

TransformerConfigurationException - Templates 오브젝트의 구축으로 실패했을 경우에 구문 분석시에 슬로우 되는 경우가 있다

getAssociatedStylesheet

public abstract Source  getAssociatedStylesheet(Source  source,
                                               String  media,
                                               String  title,
                                               String  charset)
                                        throws TransformerConfigurationException 

xml-stylesheet 의 처리 인스트럭션 (http://www.w3.org/TR/xml-stylesheet/ 를 참조)에 의해 소스 파라미터로 지정된 문서에 관련지을 수 있던, 지정된 기준에 일치하는 스타일 시트 사양을 취득합니다. 몇개의 스타일 시트를 돌려줄 수가 있습니다. 그 경우, 그러한 스타일 시트는 1 개의 스타일 시트내의 임포트 또는 cascade의 리스트인것 같이 적용됩니다.

파라미터:

source - XML 소스 문서

media - 일치하는 미디어 속성. null 의 경우가 있어, 그 경우는 설정되어 있는 템플릿이 사용되는 (즉 alternate = no)

title - 일치하는 타이틀 속성의 값. null 의 경우 있어

charset - 일치하는 캐릭터 세트 속성의 값. null 의 경우 있어

반환값:

TransformerFactory 에 건네주는데 적합한 Source 오브젝트

예외:

TransformerConfigurationException.

TransformerConfigurationException

setURIResolver

public abstract void setURIResolver(URIResolver  resolver)

xsl:import 또는 xsl:includeSet 로 사용되는 URI 를 해결하기 위해서 변환시에 디폴트로 사용되는 오브젝트를 설정합니다.

파라미터:

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

getURIResolver

public abstract URIResolver  getURIResolver()

document(), xsl:import, 또는 xsl:includeSet 로 사용되는 URI 를 해결하기 위해서 변환시에 디폴트로 사용되는 오브젝트를 취득합니다.

반환값:

setURIResolver 를 사용해 설정된 URIResolver

getFeature

public abstract boolean getFeature(String  name)

기능의 값을 검색합니다.

기능명은 임의의 절대 URI 입니다.

파라미터:

name - 절대 URI 인 기능명

반환값:

기능의 현재 상태 (true 또는 false)

setAttribute

public abstract void setAttribute(String  name,
                                  Object  value)
                           throws IllegalArgumentException 

유저가 기본이 되는 구현에 특정의 속성을 설정할 수 있게 합니다. 이 문맥의 속성은 구현이 제공하는 옵션으로서 정의됩니다.

파라미터:

name - 속성의 이름

value - 속성의 값

예외:

IllegalArgumentException - 기본이 되는 구현이 속성을 인식하지 않는 경우에 슬로우 된다

getAttribute

public abstract Object  getAttribute(String  name)
                             throws IllegalArgumentException 

유저가 기본이 되는 구현의 특정의 속성을 꺼낼 수가 있게 합니다.

파라미터:

name - 속성의 이름

반환값:

속성의 값

예외:

IllegalArgumentException - 기본이 되는 구현이 속성을 인식하지 않는 경우에 슬로우 된다

setErrorListener

public abstract void setErrorListener(ErrorListener  listener)
                               throws IllegalArgumentException 

TransformerFactory 의 에러 이벤트 청취자를 설정합니다. TransformerFactory 는 변환 자체이기 때문에는 아니고, 변환 인스트럭션을 처리하기 위해서 사용됩니다.

파라미터:

listener - 새로운 에러 청취자

예외:

IllegalArgumentException - 청취자가 null 의 경우

getErrorListener

public abstract ErrorListener  getErrorListener()

TransformerFactory 의 에러 이벤트 핸들러를 취득합니다.

반환값:

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