org.apache.avalon.framework.configuration
Class DefaultConfigurationSerializer

java.lang.Object
  |
  +--org.apache.avalon.framework.configuration.DefaultConfigurationSerializer

public class DefaultConfigurationSerializer
extends Object

A ConfigurationSerializer serializes configurations via SAX2 compliant parser.

Version:
CVS $Revision: 1.24 $ $Date: 2003/02/11 15:58:39 $
Author:
Avalon Development Team

Constructor Summary
DefaultConfigurationSerializer()
           
 
Method Summary
protected  ContentHandler createContentHandler(Result result)
          Create a ContentHandler for an OutputStream
protected  SAXTransformerFactory getTransformerFactory()
          Get the SAXTransformerFactory so we can get a serializer without being tied to one vendor.
 String serialize(Configuration source)
          Serialize the configuration object to a string
 void serialize(ContentHandler handler, Configuration source)
          Serialize the configuration to a ContentHandler
 void serialize(OutputStream outputStream, Configuration source)
          Serialize the configuration object to an output stream.
 void serialize(String uri, Configuration source)
          Serialize the configuration object to an output stream derived from an URI.
protected  void serializeElement(ContentHandler handler, NamespaceSupport namespaceSupport, Configuration element)
          Serialize each Configuration element.
 void serializeToFile(File file, Configuration source)
          Serialize the configuration object to a file using a File object.
 void serializeToFile(String filename, Configuration source)
          Serialize the configuration object to a file using a filename.
 void setIndent(boolean indent)
          Sets the Serializer's use of indentation.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DefaultConfigurationSerializer

public DefaultConfigurationSerializer()
Method Detail

setIndent

public void setIndent(boolean indent)
Sets the Serializer's use of indentation. This will cause linefeeds to be added after each element, but it does not add any indentation via spaces.

Parameters:
indent - a boolean value

createContentHandler

protected ContentHandler createContentHandler(Result result)
Create a ContentHandler for an OutputStream

Parameters:
result - the result
Returns:
contenthandler that goes to specified OutputStream

getTransformerFactory

protected SAXTransformerFactory getTransformerFactory()
Get the SAXTransformerFactory so we can get a serializer without being tied to one vendor.

Returns:
a SAXTransformerFactory value

serialize

public void serialize(ContentHandler handler,
                      Configuration source)
               throws SAXException,
                      ConfigurationException
Serialize the configuration to a ContentHandler

Parameters:
handler - a ContentHandler to serialize to
source - a Configuration value
Throws:
SAXException - if an error occurs
ConfigurationException - if an error occurs

serializeElement

protected void serializeElement(ContentHandler handler,
                                NamespaceSupport namespaceSupport,
                                Configuration element)
                         throws SAXException,
                                ConfigurationException
Serialize each Configuration element. This method is called recursively.

Parameters:
handler - a ContentHandler to use
namespaceSupport - a NamespaceSupport to use
element - a Configuration value
Throws:
SAXException - if an error occurs
ConfigurationException - if an error occurs

serializeToFile

public void serializeToFile(String filename,
                            Configuration source)
                     throws SAXException,
                            IOException,
                            ConfigurationException
Serialize the configuration object to a file using a filename.

Parameters:
filename - a String value
source - a Configuration value
Throws:
SAXException - if an error occurs
IOException - if an error occurs
ConfigurationException - if an error occurs

serializeToFile

public void serializeToFile(File file,
                            Configuration source)
                     throws SAXException,
                            IOException,
                            ConfigurationException
Serialize the configuration object to a file using a File object.

Parameters:
file - a File value
source - a Configuration value
Throws:
SAXException - if an error occurs
IOException - if an error occurs
ConfigurationException - if an error occurs

serialize

public void serialize(OutputStream outputStream,
                      Configuration source)
               throws SAXException,
                      IOException,
                      ConfigurationException
Serialize the configuration object to an output stream.

Parameters:
outputStream - an OutputStream value
source - a Configuration value
Throws:
SAXException - if an error occurs
IOException - if an error occurs
ConfigurationException - if an error occurs

serialize

public void serialize(String uri,
                      Configuration source)
               throws SAXException,
                      IOException,
                      ConfigurationException
Serialize the configuration object to an output stream derived from an URI. The URI must be resolveable by the java.net.URL object.

Parameters:
uri - a String value
source - a Configuration value
Throws:
SAXException - if an error occurs
IOException - if an error occurs
ConfigurationException - if an error occurs

serialize

public String serialize(Configuration source)
                 throws SAXException,
                        ConfigurationException
Serialize the configuration object to a string

Parameters:
source - a Configuration value
Returns:
configuration serialized as a string.
Throws:
SAXException - if an error occurs
ConfigurationException - if an error occurs


Copyright © 2001 Apache Jakarta Project. All Rights Reserved.