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 추상 클래스의 구상 서브 클래스를 명명합니다. 이 프로퍼티가 정의되어 있지 않은 경우는 플랫폼의 디폴트가 사용됩니다.

생성자 개요

protected

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

메서드 개요

abstract Source	getAssociatedStylesheet (Source source, String media, String title, String charset) 「The xml-stylesheet processing instruction」로부터, 지정된 기준에 일치하는 XML Source 문서에 관련된 스타일 시트 사양을 취득합니다.
abstract Object	getAttribute (String name) 사용자가 기본이 되는 구현에 특정의 속성을 꺼낼 수가 있도록 합니다.
abstract ErrorListener	getErrorListener () TransformerFactory 에러 이벤트 핸들러를 취득합니다.
abstract boolean	getFeature (String name) 기능의 값을 검색합니다.
abstract URIResolver	getURIResolver () document(), xsl:import, 또는 xsl:include 로 사용되는 URI를 해결하기 위해서 변환시에 디폴트로 사용되는 객체를 취득합니다.
static TransformerFactory	newInstance () TransformerFactory 새로운 인스턴스를 취득합니다.
abstract Templates	newTemplates (Source source) Source를 처리해, 소스의 컴파일 표현인 Templates 객체로 합니다.
abstract Transformer	newTransformer () Source로 부터 Result에 의 복사본을 실행하는 새로운 Transformer.
abstract Transformer	newTransformer (Source source) Source를 Transformer Object에 처리합니다.
abstract void	setAttribute (String name, Object value) 사용자가 기본이 되는 구현에 특정의 속성을 설정할 수 있도록 합니다.
abstract void	setErrorListener (ErrorListener listener) TransformerFactory 에러 이벤트 리스너를 설정합니다.
abstract void	setFeature (String name, boolean value) 이 팩토리에 의해 생성된 TransformerFactory 및 Transformer 또는 Template 기능을 설정합니다.
abstract void	setURIResolver (URIResolver resolver) document(), xsl:import, 또는 xsl:include 로 사용되는 URI를 해결하기 위해서 변환시에 디폴트로 사용되는 객체를 설정합니다.

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

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

생성자 상세

TransformerFactory

protected TransformerFactory()

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

메서드의 상세

newInstance

public static TransformerFactory  newInstance()
                                      throws TransformerFactoryConfigurationError 

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

• javax.xml.transform.TransformerFactory 시스템 프로퍼티를 사용한다
• JRE 디렉토리내의 프로퍼티 파일 lib/jaxp.properties를 사용한다. 이 구성 파일은 표준의 java.util.Properties 형식이며, 상기와 같이 정의된 시스템 프로퍼티인 키를 가지는 구현 클래스의 완전 지정의 이름을 포함한다. jaxp.properties 파일은 JAXP 구현에 의해 1회 만 읽혀 그 값이 그 후의 사용을 위해 캐쉬된다. 최초의 read시에 파일이 존재하지 않으면 그 후에 그 존재가 체크될 것은 없다. 최초로 읽힌뒤 jaxp.properties 프로퍼티의 값을 변경할 수 없다.
• 가능하면, JAR 사양으로 상세하게 설명되고 있는 서비스 API를 사용해, 클래스명을 판정한다. 서비스 API는 실행시에 사용할 수 있는 jar 내의 META-INF/services/javax.xml.transform.TransformerFactory 파일로부터 클래스명을 검색한다
• 플랫폼의 디폴트의 TransformerFactory인스턴스

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

반환값:

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

예외:

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

newTransformer

public abstract Transformer  newTransformer(Source  source)
                                    throws TransformerConfigurationException 

Source를 Transformer Object에 처리합니다. Source는 「XSL Transformations (XSLT) Version 1.0」에 적합하는 XSLT 문서입니다. 이 Transformer는 동시에 동작하는 복수의 Thread로 사용할 수 없습니다. 다른 Thread에 서는 동시에 사용되는 TransformerFactories도 다릅니다.

파라미터:

source - Transformer 작성에 사용되는 XSLT 문서의 Source. XML Source 예는 DOMSource, SAXSource 및 StreamSource

반환값:

1개의 Thread로 변환을 실행하기 위해서 사용되는 Transformer 객체. null은 불가

예외:

TransformerConfigurationException - Source 구문 분석시에 에러가 발생하는지, 또는 Transformer인스턴스를 작성할 수 없는 경우에 발생되는

관련 항목:

「XSL Transformations (XSLT) Version 1.0」

newTransformer

public abstract Transformer  newTransformer()
                                    throws TransformerConfigurationException 

Source로 부터 Result에 의 복사본을 실행하는 새로운 Transformer. 즉 「항등변환」

반환값:

1개의 thread로 변환을 실행하기 위해서 사용되는 Transformer 객체. null은 불가

예외:

TransformerConfigurationException - Transformer인스턴스를 작성할 수 없는 경우에 Throw 된다

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 

「The xml-stylesheet processing instruction」로부터, 지정된 기준에 일치하는 XML Source 문서에 관련된 스타일 시트 사양을 취득합니다. 몇개의 스타일 시트를 돌려줄 수가 있습니다. 그 경우, 그러한 스타일 시트는 1개의 스타일 시트내의 임포트 또는 cascade의 리스트인것 같이 적용됩니다.

파라미터:

source - XML 소스 문서

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

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

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

반환값:

TransformerFactory에 건네주는데 적합한 Source Object

예외:

TransformerConfigurationException - source 구문 분석시에 에러가 발생했을 경우 Exception가 발생되는

관련 항목:

「Associating Style Sheets with XML documents Version 1.0」

setURIResolver

public abstract void setURIResolver(URIResolver  resolver)

document(), xsl:import, 또는 xsl:include 로 사용되는 URI를 해결하기 위해서 변환시에 디폴트로 사용되는 객체를 설정합니다.

파라미터:

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

getURIResolver

public abstract URIResolver  getURIResolver()

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

반환값:

setURIResolver를 사용해 설정된 URIResolver

setFeature

public abstract void setFeature(String  name,
                                boolean value)
                         throws TransformerConfigurationException 

이 팩토리에 의해 생성된 TransformerFactory 및 Transformer 또는 Template 기능을 설정합니다.

기능명은 완전 수식 URI 입니다. 구현이 독자적인 기능을 정의할 수도 있습니다. 생성하는 TransformerFactory, Transformer, 또는 Template가 그 기능을 지원 할 수 없는 경우는 TransformerConfigurationException을 발생시킵니다. TransformerFactory는 기능의 값을 표시할 수 있습니다만, 그 상태를 변경할 수 없습니다.

구현은 모두 XMLConstants.FEATURE_SECURE_PROCESSING 기능을 지원 할 필요가 있습니다.

• 기능이 true인 경우, 구현은 구현 한계에 준거하는 XML 처리를 제한해, 구현으로 정의되었던 대로의 시큐러티 보호된 방식에서 동작한다. 예는 사용자 정의 스타일 시트 및 함수의 해결 등. 보안상의 이유로부터 XML 처리가 제한되는 경우는 등록을 마친 ErrorListener.fatalError(TransformerException exception)에 호출을 개입시켜 보고된다. setErrorListener(ErrorListener listener)를 참조
• 기능이 false인 경우, 구현은 구현 한계에 상관하지 않고, XML 사양에 따라 XML를 처리한다

파라미터:

name - 기능명

value - 기능 상태가 true인가 false인가

예외:

TransformerConfigurationException - 작성하는 TransformerFactory, Transformer, 또는 Template가 이 기능을 지원 할 수 없는 경우

NullPointerException - name 파라미터가 null인 경우

getFeature

public abstract boolean getFeature(String  name)

기능의 값을 검색합니다.

기능명은 완전 수식 URI 입니다. 구현이 독자적인 기능을 정의할 수도 있습니다. 생성하는 TransformerFactory, Transformer, 또는 Template가 그 기능을 지원 할 수 없는 경우는 false가 리턴됩니다 . TransformerFactory는 기능의 값을 표시할 수 있습니다만, 그 상태를 변경할 수 없습니다.

파라미터:

name - 기능명

반환값:

기능의 현재 상태. true 또는 false

예외:

NullPointerException - name 파라미터가 null인 경우

setAttribute

public abstract void setAttribute(String  name,
                                  Object  value)

사용자가 기본이 되는 구현에 특정의 속성을 설정할 수 있도록 합니다. 이 컨텍스트 의 속성은 구현이 제공하는 옵션으로서 정의됩니다. 기본이 되는 구현이 속성을 인식하지 않는 경우에 IllegalArgumentException가 발생 됩니다.

파라미터:

name - 속성의 이름

value - 속성의 값

getAttribute

public abstract Object  getAttribute(String  name)

사용자가 기본이 되는 구현에 특정의 속성을 꺼낼 수가 있도록 합니다. 기본이 되는 구현이 속성을 인식하지 않는 경우에 IllegalArgumentException가 발생 됩니다.

파라미터:

name - 속성의 이름

반환값:

속성의 값

setErrorListener

public abstract void setErrorListener(ErrorListener  listener)

TransformerFactory 에러 이벤트 리스너를 설정합니다. TransformerFactory는 변환 자체이기 때문에가 아니고, 변환 명령을 처리하기 위해서 사용됩니다. ErrorListener 리스너가 null인 경우, IllegalArgumentException가 발생 됩니다.

파라미터:

listener - 새로운 에러 리스너

getErrorListener

public abstract ErrorListener  getErrorListener()

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

반환값:

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