com.stylusstudio.converter
Class ConverterFactory

java.lang.Object
  com.stylusstudio.converter.ConverterFactory

public class ConverterFactory

extends Object

A factory class which is used to create new Converter objects. Converter objects are used to convert files to and from XML.

Method Summary

Configuration	getConfiguration() Get the Configuration object for this ConverterFactory.
Converter	newConvertFromXML(String conversion) Create a new Converter object, using an adapter URL, to convert XML files to non-XML.
Converter	newConvertToXML(StreamSource conversion) Create a new Converter object, using a .conv file, to convert non-XML files to XML.
Converter	newConvertToXML(String conversion) Create a new Converter object, using an adapter URL, to convert non-XML files to XML.
static ConverterFactory	newInstance() Create a new instance of the ConverterFactory.

Methods inherited from class java.lang.Object

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

Method Detail

newInstance

public static ConverterFactory newInstance()

Create a new instance of the ConverterFactory.

newConvertToXML

public Converter newConvertToXML(String conversion)
                          throws ConverterException

Create a new Converter object, using an adapter URL, to convert non-XML files to XML.

Parameters:

conversion - The conversion to be performed. The conversion is supplied as a Stylus Studio adapter: URL without any ?datafile suffix.

Returns:

The Converter object.

Throws:

ConverterException

newConvertToXML

public Converter newConvertToXML(StreamSource conversion)
                          throws ConverterException

Create a new Converter object, using a .conv file, to convert non-XML files to XML.

Parameters:

conversion - The conversion which will be performed. The conversion is supplied as a StreamSource. The StreamSource must contain one or more of the following to identify the .conv file used for the conversion: SystemId, InputStream, or Reader.

Returns:

The Converter object.

Throws:

ConverterException

newConvertFromXML

public Converter newConvertFromXML(String conversion)
                            throws ConverterException

Create a new Converter object, using an adapter URL, to convert XML files to non-XML.

Parameters:

conversion - The conversion to be performed. The conversion is supplied as a Stylus Studio adapter: URL without any ?datafile suffix.

Returns:

The Converter object.

Throws:

ConverterException

getConfiguration

public Configuration getConfiguration()

Get the Configuration object for this ConverterFactory.

The Configuration object allows the application to specify options that affect the conversion.

This method returns a reference to the Configuration object, not a copy. Changes affect all Converter objects subsequently created from this ConverterFactory.

Returns:

The Configuration object.