Package adams.data.io.output

Class AbstractObjectWriter

java.lang.Object

adams.core.logging.LoggingObject

adams.core.logging.CustomLoggingLevelObject

adams.core.option.AbstractOptionHandler

adams.data.io.output.AbstractObjectWriter

All Implemented Interfaces:

Destroyable, GlobalInfoSupporter, FileFormatHandler, LoggingLevelHandler, LoggingSupporter, OptionHandler, SizeOfHandler, Serializable

Direct Known Subclasses:

CommandlineWriter, JavaInstantiationWriter, NestedCommandlineWriter, SerializableObjectWriter, SerializedObjectWriter, SimpleJavaInstantiationWriter, XStreamWriter

public abstract class AbstractObjectWriter
extends AbstractOptionHandler
implements FileFormatHandler

Ancestor for object writers.

Version:

$Revision$

Author:

fracpete (fracpete at waikato dot ac dot nz)

See Also:

Serialized Form

Field Summary

Fields inherited from class adams.core.option.AbstractOptionHandler

m_OptionManager

Fields inherited from class adams.core.logging.LoggingObject

m_Logger, m_LoggingIsEnabled, m_LoggingLevel

Constructor Summary

Constructors

Constructor	Description
AbstractObjectWriter()

Method Summary

Modifier and Type	Method	Description
protected void	check(Object obj)	Performs checks.
protected abstract String	doWrite(PlaceholderFile file, Object obj)	Performs the actual writing of the object file.
abstract AbstractObjectReader	getCorrespondingReader()	Returns, if available, the corresponding reader.
String	getDefaultFormatExtension()	Returns the default extension of the format.
abstract String	getFormatDescription()	Returns a string describing the format (used in the file chooser).
abstract String[]	getFormatExtensions()	Returns the extension(s) of the format.
static String[]	getWriters()	Returns a list with classnames of writers.
boolean	isAvailable()	Returns whether the writer is actually available.
String	write(PlaceholderFile file, Object obj)	Writes the object file.

Methods inherited from class adams.core.option.AbstractOptionHandler

cleanUpOptions, defineOptions, destroy, finishInit, getDefaultLoggingLevel, getOptionManager, globalInfo, initialize, loggingLevelTipText, newOptionManager, reset, setLoggingLevel, toCommandLine, toString

Methods inherited from class adams.core.logging.LoggingObject

configureLogger, getLogger, getLoggingLevel, initializeLogging, isLoggingEnabled, sizeOf

Methods inherited from class java.lang.Object

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

Methods inherited from interface adams.core.logging.LoggingLevelHandler

getLoggingLevel

Constructor Detail

AbstractObjectWriter

public AbstractObjectWriter()

Method Detail

getFormatDescription

public abstract String getFormatDescription()

Returns a string describing the format (used in the file chooser).

Specified by:

getFormatDescription in interface FileFormatHandler

Returns:

a description suitable for displaying in the file chooser

getFormatExtensions

public abstract String[] getFormatExtensions()

Returns the extension(s) of the format.

Specified by:

getFormatExtensions in interface FileFormatHandler

Returns:

the extension (without the dot!)

getDefaultFormatExtension

public String getDefaultFormatExtension()

Returns the default extension of the format.

Specified by:

getDefaultFormatExtension in interface FileFormatHandler

Returns:

the default extension (without the dot!)

getCorrespondingReader

public abstract AbstractObjectReader getCorrespondingReader()

Returns, if available, the corresponding reader.

Returns:

the reader, null if none available

isAvailable

public boolean isAvailable()

Returns whether the writer is actually available.

Returns:

true if available and ready to use

check

protected void check(Object obj)

Performs checks.

Parameters:

obj - the object to check

doWrite

protected abstract String doWrite(PlaceholderFile file,
                                  Object obj)

Performs the actual writing of the object file.

Parameters:

file - the file to write to

obj - the object to write

Returns:

null if successfully written, otherwise error message

write

public String write(PlaceholderFile file,
                    Object obj)

Writes the object file.

Parameters:

file - the file to write to

obj - the object to write

Returns:

null if successfully written, otherwise error message

getWriters

public static String[] getWriters()

Returns a list with classnames of writers.

Returns:

the writer classnames