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 BaseTextm_Columnsthe comma-separated list of column headers.protected BaseString[]m_ColumnsArraythe array of column headers to use.protected BaseTextm_Commentsthe initial comments to use.protected DataRowm_DataRowTypethe data row type to use.protected Stringm_SheetNamethe spreadsheet name.protected SpreadSheetm_SpreadSheetTypethe 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 StringcolumnsArrayTipText()Returns the tip text for this property.StringcolumnsTipText()Returns the tip text for this property.StringcommentsTipText()Returns the tip text for this property.StringdataRowTypeTipText()Returns the tip text for this property.voiddefineOptions()Adds options to the internal list of options.protected StringdoExecute()Executes the flow item.Class[]generates()Returns the class of objects that it generates.BaseTextgetColumns()Returns the comma-separated list of column names.BaseString[]getColumnsArray()Returns the array of column names (takes precedence over comma-separated list).BaseTextgetComments()Returns the comments to use.DataRowgetDataRowType()Returns the type of data row to use.StringgetQuickInfo()Returns a quick info about the actor, which will be displayed in the GUI.StringgetSheetName()Returns the name for the spreadsheetSpreadSheetgetSpreadSheetType()Returns the type of spreadsheet to use.StringglobalInfo()Returns a string describing the object.voidsetColumns(BaseText value)Sets the comma-separated list of column names.voidsetColumnsArray(BaseString[] value)Sets the array of column names (takes precedence over comma-separated list).voidsetComments(BaseText value)Sets the comments to use.voidsetDataRowType(DataRow value)Sets the type of data row to use.voidsetSheetName(String value)Sets the name for the spreadsheet.voidsetSpreadSheetType(SpreadSheet value)Sets the type of spreadsheet to use.StringsheetNameTipText()Returns the tip text for this property.StringspreadSheetTypeTipText()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:
globalInfoin interfaceGlobalInfoSupporter- Specified by:
globalInfoin classAbstractOptionHandler- Returns:
- a description suitable for displaying in the gui
-
defineOptions
public void defineOptions()
Adds options to the internal list of options.- Specified by:
defineOptionsin interfaceOptionHandler- Overrides:
defineOptionsin classAbstractActor
-
getQuickInfo
public String getQuickInfo()
Returns a quick info about the actor, which will be displayed in the GUI.- Specified by:
getQuickInfoin interfaceActor- Specified by:
getQuickInfoin interfaceQuickInfoSupporter- Overrides:
getQuickInfoin 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:
setDataRowTypein interfaceDataRowTypeHandler- Parameters:
value- the type
-
getDataRowType
public DataRow getDataRowType()
Returns the type of data row to use.- Specified by:
getDataRowTypein interfaceDataRowTypeHandler- Returns:
- the type
-
dataRowTypeTipText
public String dataRowTypeTipText()
Returns the tip text for this property.- Specified by:
dataRowTypeTipTextin 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:
setSpreadSheetTypein interfaceSpreadSheetTypeHandler- Parameters:
value- the type
-
getSpreadSheetType
public SpreadSheet getSpreadSheetType()
Returns the type of spreadsheet to use.- Specified by:
getSpreadSheetTypein interfaceSpreadSheetTypeHandler- Returns:
- the type
-
spreadSheetTypeTipText
public String spreadSheetTypeTipText()
Returns the tip text for this property.- Specified by:
spreadSheetTypeTipTextin 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:
generatesin interfaceOutputProducer- Returns:
- the Class of the generated tokens
-
doExecute
protected String doExecute()
Executes the flow item.- Specified by:
doExecutein classAbstractActor- Returns:
- null if everything is fine, otherwise error message
-
-