Package adams.flow.transformer

Class GZIP

java.lang.Object

adams.core.logging.LoggingObject

adams.core.logging.CustomLoggingLevelObject

adams.core.option.AbstractOptionHandler

adams.flow.core.AbstractActor

adams.flow.transformer.AbstractTransformer

adams.flow.transformer.AbstractSingleCompress

adams.flow.transformer.GZIP

All Implemented Interfaces:

AdditionalInformationHandler, CleanUpHandler, Destroyable, GlobalInfoSupporter, LoggingLevelHandler, LoggingSupporter, OptionHandler, QuickInfoSupporter, ShallowCopySupporter<Actor>, SizeOfHandler, Stoppable, StoppableWithFeedback, VariablesInspectionHandler, VariableChangeListener, Actor, ErrorHandler, InputConsumer, OutputProducer, Serializable, Comparable

public class GZIP
extends AbstractSingleCompress

Creates a GZIP archive from a single file. Outputs the filename of the GZIP file generated. Optionally, the original input file can be deleted.

Input/output:
- accepts:
java.lang.String
java.io.File
- generates:
java.lang.String


Valid options are:

-D (property: debug)
    If set to true, scheme may output additional info to the console.
 

-name <java.lang.String> (property: name)
    The name of the actor.
    default: GZIP
 

-annotation <adams.core.base.BaseText> (property: annotations)
    The annotations to attach to this actor.
    default:
 

-skip (property: skip)
    If set to true, transformation is skipped and the input token is just forwarded
    as it is.
 

-remove (property: removeInputFile)
    If set to true, then the original input file will be deleted after a successful
    compression.
 

-output <adams.core.io.PlaceholderFile> (property: output)
    The GZIP file to create; if pointing to a directory, then the output filename
    is based on the file that is being compressed and the 'gz' extension added.
    default: .
 

-buffer <int> (property: bufferSize)
    The size of the buffer in bytes for the data stream.
    default: 1024
 

Author:

fracpete (fracpete at waikato dot ac dot nz)

See Also:

Serialized Form

Field Summary

Fields inherited from class adams.flow.transformer.AbstractSingleCompress

m_BufferSize, m_Output, m_RemoveInputFile

Fields inherited from class adams.flow.transformer.AbstractTransformer

BACKUP_INPUT, BACKUP_OUTPUT, m_InputToken, m_OutputToken

Fields inherited from class adams.flow.core.AbstractActor

m_Annotations, m_BackupState, m_DetectedObjectVariables, m_DetectedVariables, m_ErrorHandler, m_Executed, m_Executing, m_ExecutionListeningSupporter, m_FullName, m_LoggingPrefix, m_Name, m_Parent, m_ScopeHandler, m_Self, m_Silent, m_Skip, m_StopFlowOnError, m_StopMessage, m_Stopped, m_StorageHandler, m_VariablesUpdated

Fields inherited from class adams.core.option.AbstractOptionHandler

m_OptionManager

Fields inherited from class adams.core.logging.LoggingObject

m_Logger, m_LoggingIsEnabled, m_LoggingLevel

Fields inherited from interface adams.flow.core.Actor

FILE_EXTENSION, FILE_EXTENSION_GZ

Constructor Summary

Constructors

Constructor	Description
GZIP()

Method Summary

Modifier and Type	Method	Description
protected String	compress(byte[] inBytes, gnu.trove.list.TByteList outBytes)	Compresses the bytes.
protected String	compress(File inFile, File outFile)	Compresses the file.
protected String	getDefaultExtension()	Returns the default extension that the compressed archive has, e.g., ".gz" for gzipped files.
String	globalInfo()	Returns a string describing the object.
String	outputTipText()	Returns the tip text for this property.

Methods inherited from class adams.flow.transformer.AbstractSingleCompress

accepts, bufferSizeTipText, defineOptions, doExecute, generates, getBufferSize, getOutput, getQuickInfo, getRemoveInputFile, removeInputFileTipText, setBufferSize, setOutput, setRemoveInputFile

Methods inherited from class adams.flow.transformer.AbstractTransformer

backupState, currentInput, execute, hasInput, hasPendingOutput, input, output, postExecute, restoreState, wrapUp

Methods inherited from class adams.flow.core.AbstractActor

annotationsTipText, canInspectOptions, canPerformSetUpCheck, cleanUp, compareTo, configureLogger, destroy, equals, finalUpdateVariables, findVariables, findVariables, forceVariables, forCommandLine, forName, forName, getAdditionalInformation, getAnnotations, getDefaultName, getDetectedVariables, getErrorHandler, getFlowActors, getFlowExecutionListeningSupporter, getFullName, getName, getNextSibling, getParent, getParentComponent, getPreviousSibling, getRoot, getScopeHandler, getSilent, getSkip, getStopFlowOnError, getStopMessage, getStorageHandler, getVariables, handleError, handleException, hasErrorHandler, hasStopMessage, index, initialize, isBackedUp, isExecuted, isExecuting, isFinished, isHeadless, isStopped, nameTipText, performSetUpChecks, performVariableChecks, preExecute, pruneBackup, pruneBackup, reset, setAnnotations, setErrorHandler, setName, setParent, setSilent, setSkip, setStopFlowOnError, setUp, setVariables, shallowCopy, shallowCopy, silentTipText, sizeOf, skipTipText, stopExecution, stopExecution, stopFlowOnErrorTipText, updateDetectedVariables, updatePrefix, updateVariables, variableChanged

Methods inherited from class adams.core.option.AbstractOptionHandler

cleanUpOptions, finishInit, getDefaultLoggingLevel, getOptionManager, loggingLevelTipText, newOptionManager, setLoggingLevel, toCommandLine, toString

Methods inherited from class adams.core.logging.LoggingObject

getLogger, getLoggingLevel, initializeLogging, isLoggingEnabled

Methods inherited from class java.lang.Object

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

Methods inherited from interface adams.flow.core.Actor

cleanUp, compareTo, destroy, equals, findVariables, getAnnotations, getDefaultName, getDetectedVariables, getErrorHandler, getFlowExecutionListeningSupporter, getFullName, getName, getNextSibling, getParent, getParentComponent, getPreviousSibling, getRoot, getScopeHandler, getSilent, getSkip, getStopFlowOnError, getStopMessage, getStorageHandler, getVariables, handleError, hasErrorHandler, hasStopMessage, index, isExecuted, isFinished, isHeadless, isStopped, setAnnotations, setErrorHandler, setName, setParent, setSilent, setSkip, setStopFlowOnError, setUp, setVariables, shallowCopy, shallowCopy, sizeOf, stopExecution, stopExecution, toCommandLine, variableChanged

Methods inherited from interface adams.core.AdditionalInformationHandler

getAdditionalInformation

Methods inherited from interface adams.core.logging.LoggingLevelHandler

getLoggingLevel, setLoggingLevel

Methods inherited from interface adams.core.logging.LoggingSupporter

getLogger, isLoggingEnabled

Methods inherited from interface adams.core.option.OptionHandler

cleanUpOptions, getOptionManager

Methods inherited from interface adams.core.VariablesInspectionHandler

canInspectOptions

Constructor Detail

GZIP

public GZIP()

Method Detail

globalInfo

public String globalInfo()

Returns a string describing the object.

Specified by:

globalInfo in interface GlobalInfoSupporter

Specified by:

globalInfo in class AbstractOptionHandler

Returns:

a description suitable for displaying in the gui

outputTipText

public String outputTipText()

Returns the tip text for this property.

Specified by:

outputTipText in class AbstractSingleCompress

Returns:

tip text for this property suitable for displaying in the GUI or for listing the options.

getDefaultExtension

protected String getDefaultExtension()

Returns the default extension that the compressed archive has, e.g., ".gz" for gzipped files.

Specified by:

getDefaultExtension in class AbstractSingleCompress

Returns:

the extension, including the dot

compress

protected String compress(File inFile,
                          File outFile)

Compresses the file.

Specified by:

compress in class AbstractSingleCompress

Parameters:

inFile - the uncompressed input file

outFile - the compressed output file

Returns:

null if successfully compressed, otherwise error message

compress

protected String compress(byte[] inBytes,
                          gnu.trove.list.TByteList outBytes)

Compresses the bytes.

Specified by:

compress in class AbstractSingleCompress

Parameters:

inBytes - the uncompressed bytes

outBytes - the compressed bytes

Returns:

null if successfully compressed, otherwise error message