/* Copyright (c) 2001 - 2013 OpenPlans - www.openplans.org. All rights reserved.
* This code is licensed under the GPL 2.0 license, available at the root
* application directory.
*/
package org.geoserver.wps.ppio;
import java.io.OutputStream;
import javax.xml.namespace.QName;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.sax.SAXTransformerFactory;
import javax.xml.transform.sax.TransformerHandler;
import javax.xml.transform.stream.StreamResult;
import org.xml.sax.ContentHandler;
/**
* Process parameter input / output for objects which are XML based.
*
* @author Justin Deoliveira, OpenGEO
*/
public abstract class XMLPPIO extends ComplexPPIO {
/** */
protected QName element;
/**
* Constructor specifying 'text/xml' as mime type.
*/
protected XMLPPIO(Class externalType, Class internalType, QName element) {
this( externalType, internalType, "text/xml", element );
}
/**
* Constructor explicitly specifying mime type.
*/
protected XMLPPIO(Class externalType, Class internalType, String mimeType, QName element) {
super( externalType, internalType, mimeType);
if (element == null) {
throw new NullPointerException("element must not be null");
}
this.element = element;
}
/**
* The qualified name of the XML element in the XML representation of the object.
*/
public QName getElement() {
return element;
}
/**
* Encodes the internal representation of the object to an XML stream.
*
* @param object An object of type {@link #getType()}.
* @param handler An XML content handler.
*/
public abstract void encode( Object object, ContentHandler handler ) throws Exception;
/**
* Encodes the internal object representation of a parameter as a string.
*/
public void encode( Object value, OutputStream os) throws Exception {
// create the document serializer
TransformerHandler serializer =
((SAXTransformerFactory)SAXTransformerFactory.newInstance()).newTransformerHandler();
serializer.setResult(new StreamResult(os));
// cascade on the other encode method
encode(value, serializer);
}
@Override
public String getFileExtension() {
return "xml";
}
}