패키지 javax.xml.transform.sax

이 패키지는 SAX2 고유의 변환 API 를 구현해,ContentHandler 이벤트를 받아들이는 클래스, 및 org.xml.sax.ContentHandler 에의 이벤트를 발생시키는 클래스를 제공합니다.

참조:
설명

인터페이스의 개요

TemplatesHandler	SAX 구문 분석 이벤트 (변환 인스트럭션을 구문 분석 한다)를 처리해 Templates 오브젝트로 하는데 사용할 수 있는 SAX ContentHandler 입니다.
TransformerHandler	TransformerHandler 는 SAX ContentHandler 구문 분석 이벤트를 대기해, 그것을 Result 로 변환합니다.

클래스의 개요

SAXResult	변환 Result 의 홀더로서 동작합니다.
SAXSource	SAX 스타일의 Source 의 홀더로서 동작합니다.
SAXTransformerFactory	이 클래스는 TransformerFactory 를 확장해 SAX 고유의 팩토리 메소드를 제공합니다.

패키지 javax.xml.transform.sax 의 설명

이 패키지는 SAX2 고유의 변환 API 를 구현해,ContentHandler 이벤트를 받아들이는 클래스, 및 org.xml.sax.ContentHandler 에의 이벤트를 발생시키는 클래스를 제공합니다. 또, 입력 소스를 XMLReader 로서 설정하는 메소드, 또는 InputSource 를 소스로서 사용하는 메소드도 제공합니다. 이 패키지는 XMLFilter 의 작성도 가능하게 해, 이것에 의해 다른 변환으로부터 변환을 「개시시키고」, Transformer 를 XMLReader 로서 다형적으로 사용할 수가 있습니다.

SAXSource 클래스에 의해,XMLReader 의 설정을, 구문 분석 이벤트, 및 SAX 소스를 지정하는데 사용할 수 있는 InputSource 를 「개시시킨다」위해(때문에) 사용할 수가 있습니다.

SAXResult 클래스에 의해,ContentHandler 의 설정을, 변환으로부터의 SAX2 이벤트의 수취하는 측으로 할 수 있습니다.

SAXTransformerFactory 는 TransformerFactory 를 확장해,TemplatesHandler ,TransformerHandler , 및 XMLReader 인스턴스를 작성하기 위한 팩토리 메소드를 제공합니다.

SAXTransformerFactory 를 취득하려면 ,TransformerFactory.newInstance() 로부터 돌려주어진 TransformerFactory 인스턴스를 호출해 옆에서 캐스트 할 필요가 있습니다.

TransformerHandler 인터페이스에 의해, SAX2 구문 분석 이벤트로부터 변환을 작성할 수 있게 됩니다. SAX2 구문 분석 이벤트는 통상 변환에 대해서 발생하는 「풀」모델이 아니고, 「푸쉬」모델입니다. 통상의 구문 분석 이벤트는 ContentHandler 인터페이스를 사용하고 받아, startCDATA 나 endCDATA 등의 자구 이벤트는 LexicalHandler 인터페이스를 사용하고 받아, 출력 이스케이프의 무효화의 개시 또는 종료를 나타내는 이벤트는 ContentHandler.processingInstruction(java.lang.String, java.lang.String) 를 개입시켜, 타겟 파라미터에 Result.PI_DISABLE_OUTPUT_ESCAPING 와 Result.PI_ENABLE_OUTPUT_ESCAPING 를 지정하고 받습니다. 파라미터, 출력 프로퍼티, 그 외의 기능을 Transformer 핸들러로 설정할 필요가 있는 경우는 TransformerHandler.getTransformer() 로부터 Transformer 참조를 취득할 필요가 있어, 또 그 참조로부터 불려 가는 메소드도 취득할 필요가 있습니다.

TemplatesHandler 인터페이스에 의해, SAX2 구문 분석 이벤트로부터 Templates 오브젝트를 작성할 수 있게 됩니다. ContentHandler 이벤트가 완료하면(자),TemplatesHandler.getTemplates() 로부터 Templates 오브젝트를 취득할 수가 있습니다. 상대 URL 를 해결하기 위한 기본 시스템 ID 를 확립하기 위해서, 통상은 TemplatesHandler.setSystemId(java.lang.String) 를 호출할 필요가 있습니다.

SAXTransformerFactory.newXMLFilter(javax.xml.transform.Source) 메소드에 의해, 「풀」변환의 SAX2 개념을 캡슐화하는 XMLFilter 를 작성할 수가 있습니다. 다음에, 연결되어 따분한가의 변환을 나타냅니다. 각 필터는 부모의 XMLReader 를 가리켜, 마지막 변환은 체인내의 마지막 리더로 XMLReader.parse(org.xml.sax.InputSource) 를 호출하는 것으로 기동됩니다.