org.apache.batik.transcoder.XMLAbstractTranscoder Maven / Gradle / Ivy
The newest version!
/*
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package org.apache.batik.transcoder;
import java.io.IOException;
import org.apache.batik.dom.util.DocumentFactory;
import org.apache.batik.dom.util.SAXDocumentFactory;
import org.apache.batik.transcoder.keys.BooleanKey;
import org.apache.batik.transcoder.keys.DOMImplementationKey;
import org.apache.batik.transcoder.keys.StringKey;
import org.apache.batik.util.XMLResourceDescriptor;
import org.w3c.dom.DOMException;
import org.w3c.dom.DOMImplementation;
import org.w3c.dom.Document;
/**
* This class may be the base class of all transcoders which take an
* XML document as input and which need to build a DOM tree. In order
* to take advantage of this class, you have to specify the following
* transcoding hints:
*
*
* KEY_DOM_IMPLEMENTATION: the DOM Implementation to use
*
* KEY_DOCUMENT_ELEMENT_NAMESPACE_URI: the namespace URI of the
* document to create
*
* KEY_DOCUMENT_ELEMENT: the qualified name of the document type
* to create
*
*
* @author Thierry Kormann
* @version $Id$
*/
public abstract class XMLAbstractTranscoder extends AbstractTranscoder {
/**
* Constructs a new XMLAbstractTranscoder.
*/
protected XMLAbstractTranscoder() {
hints.put(KEY_XML_PARSER_VALIDATING, Boolean.FALSE);
}
/**
* Transcodes the specified XML input in the specified output. All
* TranscoderException exceptions not catched previously
* are tagged as fatal errors (ie. call the fatalError
* method of the ErrorHandler).
*
* @param input the XML input to transcode
* @param output the ouput where to transcode
* @exception TranscoderException if an error occured while transcoding
*/
public void transcode(TranscoderInput input, TranscoderOutput output)
throws TranscoderException {
Document document = null;
String uri = input.getURI();
if (input.getDocument() != null) {
document = input.getDocument();
} else {
String parserClassname =
(String)hints.get(KEY_XML_PARSER_CLASSNAME);
String namespaceURI =
(String)hints.get(KEY_DOCUMENT_ELEMENT_NAMESPACE_URI);
String documentElement =
(String)hints.get(KEY_DOCUMENT_ELEMENT);
DOMImplementation domImpl =
(DOMImplementation)hints.get(KEY_DOM_IMPLEMENTATION);
if (parserClassname == null) {
parserClassname = XMLResourceDescriptor.getXMLParserClassName();
}
if (domImpl == null) {
handler.fatalError(new TranscoderException(
"Unspecified transcoding hints: KEY_DOM_IMPLEMENTATION"));
return;
}
if (namespaceURI == null) {
handler.fatalError(new TranscoderException(
"Unspecified transcoding hints: KEY_DOCUMENT_ELEMENT_NAMESPACE_URI"));
return;
}
if (documentElement == null) {
handler.fatalError(new TranscoderException(
"Unspecified transcoding hints: KEY_DOCUMENT_ELEMENT"));
return;
}
// parse the XML document
DocumentFactory f = createDocumentFactory(domImpl, parserClassname);
Object xmlParserValidating = hints.get(KEY_XML_PARSER_VALIDATING);
boolean validating = xmlParserValidating != null && (Boolean) xmlParserValidating;
f.setValidating(validating);
try {
if (input.getInputStream() != null) {
document = f.createDocument(namespaceURI,
documentElement,
input.getURI(),
input.getInputStream());
} else if (input.getReader() != null) {
document = f.createDocument(namespaceURI,
documentElement,
input.getURI(),
input.getReader());
} else if (input.getXMLReader() != null) {
document = f.createDocument(namespaceURI,
documentElement,
input.getURI(),
input.getXMLReader());
} else if (uri != null) {
document = f.createDocument(namespaceURI,
documentElement,
uri);
}
} catch (DOMException ex) {
handler.fatalError(new TranscoderException(ex));
} catch (IOException ex) {
handler.fatalError(new TranscoderException(ex));
}
}
// call the dedicated transcode method
if (document != null) {
try {
transcode(document, uri, output);
} catch(TranscoderException ex) {
// at this time, all TranscoderExceptions are fatal errors
handler.fatalError(ex);
return;
}
}
}
/**
* Creates the DocumentFactory used to create the DOM
* tree. Override this method if you have to use another
* implementation of the DocumentFactory (ie. for SVG,
* you have to use the SAXSVGDocumentFactory).
*
* @param domImpl the DOM Implementation to use
* @param parserClassname the XML parser classname
*/
protected DocumentFactory createDocumentFactory(DOMImplementation domImpl,
String parserClassname) {
return new SAXDocumentFactory(domImpl, parserClassname);
}
/**
* Transcodes the specified Document in the specified output.
*
* @param document the document to transcode
* @param uri the uri of the document or null if any
* @param output the ouput where to transcode
* @exception TranscoderException if an error occured while transcoding
*/
protected abstract void transcode(Document document,
String uri,
TranscoderOutput output)
throws TranscoderException;
// --------------------------------------------------------------------
// Keys definition
// --------------------------------------------------------------------
/**
* XML parser classname key.
*
*
* Key:
* KEY_XML_PARSER_CLASSNAME
*
*
* Value:
* String
*
*
* Default:
* null
*
*
* Required:
* Yes
*
*
* Description:
* Specify the XML parser classname to use.
*
*
*/
public static final TranscodingHints.Key KEY_XML_PARSER_CLASSNAME
= new StringKey();
/**
* The validation mode of the XML parser.
*
*
* Key:
* KEY_XML_PARSER_VALIDATING
*
*
* Value:
* Boolean
*
*
* Default:
* false
*
*
* Required:
* No
*
*
* Description:
* Specify the validation mode of the XML parser.
*
*
*/
public static final TranscodingHints.Key KEY_XML_PARSER_VALIDATING
= new BooleanKey();
/**
* Document element key.
*
*
* Key:
* KEY_DOCUMENT_ELEMENT
*
*
* Value:
* String
*
*
* Default:
* null
*
*
* Required:
* Yes
*
*
* Description:
* Specify the qualified name of the document
* type to be created.
*
*
*/
public static final TranscodingHints.Key KEY_DOCUMENT_ELEMENT
= new StringKey();
/**
* Document element namespace URI key.
*
*
* Key:
* KEY_DOCUMENT_ELEMENT_NAMESPACE_URI
*
*
* Value:
* String
*
*
* Default:
* null
*
*
* Required:
* Yes
*
*
* Description:
* Specify the namespace URI of the document
* element.
*
*
*/
public static final TranscodingHints.Key KEY_DOCUMENT_ELEMENT_NAMESPACE_URI
= new StringKey();
/**
* DOM Implementation key.
*
*
* Key:
* KEY_DOM_IMPLEMENTATION
*
*
* Value:
* String
*
*
* Default:
* null
*
*
* Required:
* Yes
*
*
* Description:
* Specify the DOM Implementation to use.
*
*
*/
public static final TranscodingHints.Key KEY_DOM_IMPLEMENTATION
= new DOMImplementationKey();
}