Package adams.flow.source
Class NewSpreadSheet
-
- All Implemented Interfaces:
AdditionalInformationHandler
,CleanUpHandler
,Destroyable
,GlobalInfoSupporter
,LoggingLevelHandler
,LoggingSupporter
,OptionHandler
,QuickInfoSupporter
,ShallowCopySupporter<Actor>
,SizeOfHandler
,Stoppable
,StoppableWithFeedback
,VariablesInspectionHandler
,DataRowTypeHandler
,SpreadSheetTypeHandler
,VariableChangeListener
,Actor
,ErrorHandler
,OutputProducer
,Serializable
,Comparable
public class NewSpreadSheet extends AbstractSimpleSource implements SpreadSheetTypeHandler
Generates an empty spreadsheet.
Input/output:
- generates:
adams.data.spreadsheet.SpreadSheet
-logging-level <OFF|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST> (property: loggingLevel) The logging level for outputting errors and debugging output. default: WARNING
-name <java.lang.String> (property: name) The name of the actor. default: NewSpreadSheet
-annotation <adams.core.base.BaseAnnotation> (property: annotations) The annotations to attach to this actor. default:
-skip <boolean> (property: skip) If set to true, transformation is skipped and the input token is just forwarded as it is. default: false
-stop-flow-on-error <boolean> (property: stopFlowOnError) If set to true, the flow execution at this level gets stopped in case this actor encounters an error; the error gets propagated; useful for critical actors. default: false
-silent <boolean> (property: silent) If enabled, then no errors are output in the console; Note: the enclosing actor handler must have this enabled as well. default: false
-spreadsheet-name <java.lang.String> (property: sheetName) The name for the spreadsheet. default:
-columns <adams.core.base.BaseText> (property: columns) The comma-separated list of column names. default: A,B,C
-columns-array <adams.core.base.BaseString> [-columns-array ...] (property: columnsArray) The array of column names to use (takes precedence over comma-separated list). default:
-data-row-type <adams.data.spreadsheet.DataRow> (property: dataRowType) The type of row to use for the data. default: adams.data.spreadsheet.DenseDataRow
-spreadsheet-type <adams.data.spreadsheet.SpreadSheet> (property: spreadSheetType) The type of spreadsheet to use for the data. default: adams.data.spreadsheet.DefaultSpreadSheet
-comments <adams.core.base.BaseText> (property: comments) The comments to use. default:
- Author:
- fracpete (fracpete at waikato dot ac dot nz)
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description protected BaseText
m_Columns
the comma-separated list of column headers.protected BaseString[]
m_ColumnsArray
the array of column headers to use.protected BaseText
m_Comments
the initial comments to use.protected DataRow
m_DataRowType
the data row type to use.protected String
m_SheetName
the spreadsheet name.protected SpreadSheet
m_SpreadSheetType
the type of spreadsheet to use.-
Fields inherited from class adams.flow.source.AbstractSimpleSource
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 NewSpreadSheet()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description String
columnsArrayTipText()
Returns the tip text for this property.String
columnsTipText()
Returns the tip text for this property.String
commentsTipText()
Returns the tip text for this property.String
dataRowTypeTipText()
Returns the tip text for this property.void
defineOptions()
Adds options to the internal list of options.protected String
doExecute()
Executes the flow item.Class[]
generates()
Returns the class of objects that it generates.BaseText
getColumns()
Returns the comma-separated list of column names.BaseString[]
getColumnsArray()
Returns the array of column names (takes precedence over comma-separated list).BaseText
getComments()
Returns the comments to use.DataRow
getDataRowType()
Returns the type of data row to use.String
getQuickInfo()
Returns a quick info about the actor, which will be displayed in the GUI.String
getSheetName()
Returns the name for the spreadsheetSpreadSheet
getSpreadSheetType()
Returns the type of spreadsheet to use.String
globalInfo()
Returns a string describing the object.void
setColumns(BaseText value)
Sets the comma-separated list of column names.void
setColumnsArray(BaseString[] value)
Sets the array of column names (takes precedence over comma-separated list).void
setComments(BaseText value)
Sets the comments to use.void
setDataRowType(DataRow value)
Sets the type of data row to use.void
setSheetName(String value)
Sets the name for the spreadsheet.void
setSpreadSheetType(SpreadSheet value)
Sets the type of spreadsheet to use.String
sheetNameTipText()
Returns the tip text for this property.String
spreadSheetTypeTipText()
Returns the tip text for this property.-
Methods inherited from class adams.flow.source.AbstractSimpleSource
hasPendingOutput, initialize, output, reset
-
Methods inherited from class adams.flow.core.AbstractActor
annotationsTipText, backupState, canInspectOptions, canPerformSetUpCheck, cleanUp, compareTo, configureLogger, destroy, equals, execute, 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, isBackedUp, isExecuted, isExecuting, isFinished, isHeadless, isStopped, nameTipText, performSetUpChecks, performVariableChecks, postExecute, preExecute, pruneBackup, pruneBackup, restoreState, setAnnotations, setErrorHandler, setName, setParent, setSilent, setSkip, setStopFlowOnError, setUp, setVariables, shallowCopy, shallowCopy, silentTipText, sizeOf, skipTipText, stopExecution, stopExecution, stopFlowOnErrorTipText, updateDetectedVariables, updatePrefix, updateVariables, variableChanged, wrapUp
-
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, execute, 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, wrapUp
-
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
-
-
-
-
Field Detail
-
m_SheetName
protected String m_SheetName
the spreadsheet name.
-
m_Columns
protected BaseText m_Columns
the comma-separated list of column headers.
-
m_ColumnsArray
protected BaseString[] m_ColumnsArray
the array of column headers to use.
-
m_DataRowType
protected DataRow m_DataRowType
the data row type to use.
-
m_SpreadSheetType
protected SpreadSheet m_SpreadSheetType
the type of spreadsheet to use.
-
m_Comments
protected BaseText m_Comments
the initial comments to use.
-
-
Method Detail
-
globalInfo
public String globalInfo()
Returns a string describing the object.- Specified by:
globalInfo
in interfaceGlobalInfoSupporter
- Specified by:
globalInfo
in classAbstractOptionHandler
- Returns:
- a description suitable for displaying in the gui
-
defineOptions
public void defineOptions()
Adds options to the internal list of options.- Specified by:
defineOptions
in interfaceOptionHandler
- Overrides:
defineOptions
in classAbstractActor
-
getQuickInfo
public String getQuickInfo()
Returns a quick info about the actor, which will be displayed in the GUI.- Specified by:
getQuickInfo
in interfaceActor
- Specified by:
getQuickInfo
in interfaceQuickInfoSupporter
- Overrides:
getQuickInfo
in classAbstractActor
- Returns:
- null if no info available, otherwise short string
-
setSheetName
public void setSheetName(String value)
Sets the name for the spreadsheet.- Parameters:
value
- the name
-
getSheetName
public String getSheetName()
Returns the name for the spreadsheet- Returns:
- the name
-
sheetNameTipText
public String sheetNameTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setColumns
public void setColumns(BaseText value)
Sets the comma-separated list of column names.- Parameters:
value
- the list
-
getColumns
public BaseText getColumns()
Returns the comma-separated list of column names.- Returns:
- the list
-
columnsTipText
public String columnsTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setColumnsArray
public void setColumnsArray(BaseString[] value)
Sets the array of column names (takes precedence over comma-separated list).- Parameters:
value
- the array
-
getColumnsArray
public BaseString[] getColumnsArray()
Returns the array of column names (takes precedence over comma-separated list).- Returns:
- the array
-
columnsArrayTipText
public String columnsArrayTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setDataRowType
public void setDataRowType(DataRow value)
Sets the type of data row to use.- Specified by:
setDataRowType
in interfaceDataRowTypeHandler
- Parameters:
value
- the type
-
getDataRowType
public DataRow getDataRowType()
Returns the type of data row to use.- Specified by:
getDataRowType
in interfaceDataRowTypeHandler
- Returns:
- the type
-
dataRowTypeTipText
public String dataRowTypeTipText()
Returns the tip text for this property.- Specified by:
dataRowTypeTipText
in interfaceDataRowTypeHandler
- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setSpreadSheetType
public void setSpreadSheetType(SpreadSheet value)
Sets the type of spreadsheet to use.- Specified by:
setSpreadSheetType
in interfaceSpreadSheetTypeHandler
- Parameters:
value
- the type
-
getSpreadSheetType
public SpreadSheet getSpreadSheetType()
Returns the type of spreadsheet to use.- Specified by:
getSpreadSheetType
in interfaceSpreadSheetTypeHandler
- Returns:
- the type
-
spreadSheetTypeTipText
public String spreadSheetTypeTipText()
Returns the tip text for this property.- Specified by:
spreadSheetTypeTipText
in interfaceSpreadSheetTypeHandler
- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setComments
public void setComments(BaseText value)
Sets the comments to use.- Parameters:
value
- the comments
-
getComments
public BaseText getComments()
Returns the comments to use.- Returns:
- the comments
-
commentsTipText
public String commentsTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
generates
public Class[] generates()
Returns the class of objects that it generates.- Specified by:
generates
in interfaceOutputProducer
- Returns:
- the Class of the generated tokens
-
doExecute
protected String doExecute()
Executes the flow item.- Specified by:
doExecute
in classAbstractActor
- Returns:
- null if everything is fine, otherwise error message
-
-