public class BaseStep extends Object implements org.pentaho.di.core.variables.VariableSpace, StepInterface, org.pentaho.di.core.logging.LoggingObjectInterface, org.pentaho.di.core.ExtensionDataInterface
The implementing class can rely mostly on the base class, and has only three important methods it implements itself. The three methods implement the step lifecycle during transformation execution: initialization, row processing, and clean-up.
public boolean init(...)Every step is given the opportunity to do one-time initialization tasks like opening files or establishing database connections. For any steps derived from BaseStep it is mandatory that super.init() is called to ensure correct behavior. The method must return true in case the step initialized correctly, it must returned false if there was an initialization error. PDI will abort the execution of a transformation in case any step returns false upon initialization.
public boolean processRow(...)A typical implementation queries for incoming input rows by calling getRow(), which blocks and returns a row object or null in case there is no more input. If there was an input row, the step does the necessary row processing and calls putRow() to pass the row on to the next step. If there are no more rows, the step must call setOutputDone() and return false.
Formally the method must conform to the following rules:
public void dispose(...)Steps are required to deallocate resources allocated during init() or subsequent row processing. This typically means to clear all fields of the StepDataInterface object, and to ensure that all open files or connections are properly closed. For any steps derived from BaseStep it is mandatory that super.dispose() is called to ensure correct deallocation.
Modifier and Type | Field and Description |
---|---|
boolean |
first
if true then the row being processed is the first row
|
long |
linesInput
Deprecated.
please use the supplied getters, setters and increment/decrement methods
|
long |
linesOutput
Deprecated.
please use the supplied getters, setters and increment/decrement methods
|
long |
linesRead
Deprecated.
please use the supplied getters, setters and increment/decrement methods
|
long |
linesRejected
Deprecated.
please use the supplied getters, setters and increment/decrement methods
|
long |
linesSkipped
Deprecated.
please use the supplied getters, setters and increment/decrement methods
|
long |
linesUpdated
Deprecated.
please use the supplied getters, setters and increment/decrement methods
|
long |
linesWritten
Deprecated.
please use the supplied getters, setters and increment/decrement methods
|
boolean |
terminator |
List<Object[]> |
terminator_rows |
Constructor and Description |
---|
BaseStep(StepMeta stepMeta,
StepDataInterface stepDataInterface,
int copyNr,
TransMeta transMeta,
Trans trans)
This is the base step that forms that basis for all steps.
|
Modifier and Type | Method and Description |
---|---|
void |
addResultFile(org.pentaho.di.core.ResultFile resultFile)
Adds the result file.
|
void |
addRowListener(RowListener rowListener)
Add a rowlistener to the step allowing you to inspect (or manipulate, be careful) the rows coming in or exiting the step.
|
void |
addStepListener(StepListener stepListener)
Attach a step listener to be notified when a step arrives in a certain state.
|
void |
batchComplete()
Calling this method will alert the step that we finished passing a batch of records to the step.
|
org.pentaho.di.core.RowMetaAndData |
buildLog(String sname,
int copynr,
long lines_read,
long lines_written,
long lines_updated,
long lines_skipped,
long errors,
Date start_date,
Date end_date)
Builds the log.
|
boolean |
canProcessOneRow()
This method checks if the step is capable of processing at least one row.
|
void |
cleanup()
Call this method typically, after ALL the slave transformations in a clustered run have finished.
|
static void |
closeQuietly(Closeable cl)
Close quietly.
|
void |
copyVariablesFrom(org.pentaho.di.core.variables.VariableSpace space) |
long |
decrementLinesRead()
Decrements the number of lines read from previous steps by one
|
long |
decrementLinesWritten()
Decrements the number of lines written to next steps by one
|
void |
dispatch()
This method finds the surrounding steps and rowsets for this base step.
|
void |
dispose(StepMetaInterface smi,
StepDataInterface sdi)
Dispose of this step: close files, empty logs, etc.
|
String |
environmentSubstitute(String aString) |
String[] |
environmentSubstitute(String[] aString) |
String |
fieldSubstitute(String aString,
org.pentaho.di.core.row.RowMetaInterface rowMeta,
Object[] rowData) |
org.pentaho.di.core.RowSet |
findInputRowSet(String sourceStep)
Find input row set.
|
org.pentaho.di.core.RowSet |
findInputRowSet(String from,
int fromcopy,
String to,
int tocopy)
Find input row set.
|
org.pentaho.di.core.RowSet |
findOutputRowSet(String targetStep)
Find output row set.
|
org.pentaho.di.core.RowSet |
findOutputRowSet(String from,
int fromcopy,
String to,
int tocopy)
Find an output rowset in a running transformation.
|
boolean |
getBooleanValueOfVariable(String variableName,
boolean defaultValue) |
int |
getClusterSize()
Returns the cluster size.
|
String |
getContainerObjectId()
Returns the container object ID.
|
int |
getCopy() |
int |
getCurrentInputRowSetNr() |
int |
getCurrentOutputRowSetNr() |
Trans |
getDispatcher()
Gets the dispatcher.
|
org.pentaho.di.core.row.RowMetaInterface |
getErrorRowMeta() |
long |
getErrors()
Get the number of errors
|
Map<String,Object> |
getExtensionDataMap() |
String |
getFilename() |
org.pentaho.di.core.row.RowMetaInterface |
getInputRowMeta() |
List<org.pentaho.di.core.RowSet> |
getInputRowSets() |
long |
getLinesInput() |
long |
getLinesOutput() |
long |
getLinesRead() |
long |
getLinesRejected() |
long |
getLinesSkipped() |
long |
getLinesUpdated() |
long |
getLinesWritten() |
org.pentaho.di.core.logging.LogChannelInterface |
getLogChannel() |
String |
getLogChannelId() |
static org.pentaho.di.core.row.RowMetaInterface |
getLogFields(String comm)
Gets the log fields.
|
org.pentaho.di.core.logging.LogLevel |
getLogLevel() |
org.pentaho.metastore.api.IMetaStore |
getMetaStore() |
int |
getNextClassNr()
Gets the next class nr.
|
String |
getObjectCopy() |
org.pentaho.di.repository.ObjectId |
getObjectId() |
String |
getObjectName() |
org.pentaho.di.repository.ObjectRevision |
getObjectRevision() |
org.pentaho.di.core.logging.LoggingObjectType |
getObjectType() |
List<org.pentaho.di.core.RowSet> |
getOutputRowSets() |
org.pentaho.di.core.logging.LoggingObjectInterface |
getParent() |
org.pentaho.di.core.variables.VariableSpace |
getParentVariableSpace() |
String |
getPartitionID() |
Map<String,org.pentaho.di.core.BlockingRowSet> |
getPartitionTargets() |
org.pentaho.di.core.row.RowMetaInterface |
getPreviewRowMeta() |
long |
getProcessed() |
Date |
getRegistrationDate()
Returns the registration date
|
List<RemoteStep> |
getRemoteInputSteps()
Gets the remote input steps.
|
List<RemoteStep> |
getRemoteOutputSteps()
Gets the remote output steps.
|
int |
getRepartitioning() |
Repository |
getRepository() |
org.pentaho.di.repository.RepositoryDirectory |
getRepositoryDirectory() |
Map<String,org.pentaho.di.core.ResultFile> |
getResultFiles() |
Object[] |
getRow()
In case of getRow, we receive data from previous steps through the input
rowset.
|
Object[] |
getRowFrom(org.pentaho.di.core.RowSet rowSet)
Gets the row from.
|
List<RowListener> |
getRowListeners() |
long |
getRuntime() |
List<ServerSocket> |
getServerSockets()
Returns the serverSockets.
|
int |
getSlaveNr()
Returns the unique slave number in the cluster.
|
SocketRepository |
getSocketRepository()
Retutns the socket repository.
|
BaseStepData.StepExecutionStatus |
getStatus() |
String |
getStatusDescription()
Gets the status description.
|
StepDataInterface |
getStepDataInterface() |
String |
getStepID() |
List<StepListener> |
getStepListeners()
Returns the step listeners.
|
StepMeta |
getStepMeta() |
StepMetaInterface |
getStepMetaInterface() |
String |
getStepname()
Get the name of the step.
|
Trans |
getTrans() |
TransMeta |
getTransMeta() |
String |
getTypeId()
Returns the step ID via the getStepID() method call.
|
int |
getUniqueStepCountAcrossSlaves()
Returns the number of unique steps across all slave servers.
|
int |
getUniqueStepNrAcrossSlaves()
Returns a unique step number across all slave servers: slaveNr * nrCopies + copyNr.
|
String |
getVariable(String variableName) |
String |
getVariable(String variableName,
String defaultValue) |
void |
identifyErrorOutput()
To be used to flag an error output channel of a step prior to execution for performance reasons.
|
long |
incrementLinesInput()
Increments the number of lines read from an input source: database, file, socket, etc.
|
long |
incrementLinesOutput()
Increments the number of lines written to an output target: database, file, socket, etc.
|
long |
incrementLinesRead()
Increments the number of lines read from previous steps by one
|
long |
incrementLinesRejected()
Increments the number of lines rejected to an error handling step
|
long |
incrementLinesSkipped()
Increments the number of lines skipped
|
long |
incrementLinesUpdated()
Increments the number of lines updated in an output target: database, file, socket, etc.
|
long |
incrementLinesWritten()
Increments the number of lines written to next steps by one
|
boolean |
init(StepMetaInterface smi,
StepDataInterface sdi)
Initialize and do work where other steps need to wait for...
|
void |
initBeforeStart()
This method is executed by Trans right before the threads start and right after initialization.
|
void |
initializeVariablesFrom(org.pentaho.di.core.variables.VariableSpace parent) |
void |
injectVariables(Map<String,String> prop) |
boolean |
isBasic()
Checks if is basic.
|
boolean |
isDebug()
Checks if is debug.
|
boolean |
isDetailed()
Checks if is detailed.
|
boolean |
isDistributed() |
boolean |
isForcingSeparateLogging() |
boolean |
isGatheringMetrics() |
boolean |
isInitialising()
Checks if is initialising.
|
boolean |
isMapping() |
boolean |
isPartitioned() |
boolean |
isPaused() |
boolean |
isRowLevel()
Checks if is row level.
|
boolean |
isRunning() |
boolean |
isStopped() |
boolean |
isUsingThreadPriorityManagment()
Retusn true if we are actively managing priorities of step threads.
|
String[] |
listVariables() |
void |
logBasic(String message)
Log basic.
|
void |
logBasic(String message,
Object... arguments)
Log basic.
|
void |
logDebug(String message)
Log debug.
|
void |
logDebug(String message,
Object... arguments)
Log debug.
|
void |
logDetailed(String message)
Log detailed.
|
void |
logDetailed(String message,
Object... arguments)
Log detailed.
|
void |
logError(String message)
Log error.
|
void |
logError(String message,
Object... arguments)
Log error.
|
void |
logError(String message,
Throwable e)
Log error.
|
void |
logMinimal(String message)
Log minimal.
|
void |
logMinimal(String message,
Object... arguments)
Log minimal.
|
void |
logRowlevel(String message)
Log rowlevel.
|
void |
logRowlevel(String message,
Object... arguments)
Log rowlevel.
|
void |
logSummary()
Log summary.
|
void |
markStart()
Mark the start time of the step.
|
void |
markStop()
Mark the end time of the step.
|
boolean |
outputIsDone()
Output is done.
|
void |
pauseRunning()
Pause a running step
|
boolean |
processRow(StepMetaInterface smi,
StepDataInterface sdi)
Perform the equivalent of processing one row.
|
void |
putError(org.pentaho.di.core.row.RowMetaInterface rowMeta,
Object[] row,
long nrErrors,
String errorDescriptions,
String fieldNames,
String errorCodes)
Put error.
|
void |
putRow(org.pentaho.di.core.row.RowMetaInterface rowMeta,
Object[] row)
putRow is used to copy a row, to the alternate rowset(s) This should get priority over everything else!
(synchronized) If distribute is true, a row is copied only once to the output rowsets, otherwise copies are sent
to each rowset!
|
void |
putRowTo(org.pentaho.di.core.row.RowMetaInterface rowMeta,
Object[] row,
org.pentaho.di.core.RowSet rowSet)
putRowTo is used to put a row in a certain specific RowSet.
|
void |
removeRowListener(RowListener rowListener)
Remove a rowlistener from this step.
|
void |
resumeRunning()
Resume a running step
|
int |
rowsetInputSize() |
int |
rowsetOutputSize() |
static void |
safeModeChecking(org.pentaho.di.core.row.RowMetaInterface referenceRowMeta,
org.pentaho.di.core.row.RowMetaInterface rowMeta)
Safe mode checking.
|
void |
setCarteObjectId(String containerObjectId)
Sets the container object ID.
|
void |
setCopy(int cop)
Sets the copy.
|
void |
setCurrentInputRowSetNr(int index) |
void |
setCurrentOutputRowSetNr(int index) |
void |
setDistributed(boolean distributed) |
void |
setErrorRowMeta(org.pentaho.di.core.row.RowMetaInterface errorRowMeta) |
void |
setErrors(long e)
Sets the number of errors
|
void |
setForcingSeparateLogging(boolean forcingSeparateLogging) |
void |
setGatheringMetrics(boolean gatheringMetrics) |
void |
setInputRowMeta(org.pentaho.di.core.row.RowMetaInterface rowMeta) |
void |
setInputRowSets(List<org.pentaho.di.core.RowSet> inputRowSets) |
void |
setInternalVariables()
Sets the internal variables.
|
void |
setLinesInput(long newLinesInputValue) |
void |
setLinesOutput(long newLinesOutputValue) |
void |
setLinesRead(long newLinesReadValue) |
void |
setLinesRejected(long newLinesRejectedValue) |
void |
setLinesSkipped(long newLinesSkippedValue) |
void |
setLinesUpdated(long newLinesUpdatedValue) |
void |
setLinesWritten(long newLinesWrittenValue) |
void |
setLogLevel(org.pentaho.di.core.logging.LogLevel logLevel)
Sets the log level.
|
void |
setMetaStore(org.pentaho.metastore.api.IMetaStore metaStore)
Pass along the metastore to use when loading external elements at runtime.
|
void |
setOutputDone()
Signal output done to destination steps
|
void |
setOutputRowSets(List<org.pentaho.di.core.RowSet> outputRowSets) |
void |
setParentVariableSpace(org.pentaho.di.core.variables.VariableSpace parent) |
void |
setPartitioned(boolean partitioned) |
void |
setPartitionID(String partitionID) |
void |
setPartitionTargets(Map<String,org.pentaho.di.core.BlockingRowSet> partitionTargets) |
void |
setPaused(AtomicBoolean paused)
Sets the paused.
|
void |
setPaused(boolean paused)
Sets the paused.
|
void |
setPreviewRowMeta(org.pentaho.di.core.row.RowMetaInterface previewRowMeta) |
void |
setRepartitioning(int repartitioning) |
void |
setRepository(Repository repository) |
void |
setRunning(boolean running)
Flag the step as running or not
|
void |
setServerSockets(List<ServerSocket> serverSockets) |
void |
setSocketRepository(SocketRepository socketRepository)
Sets the socket repository.
|
void |
setStepDataInterface(StepDataInterface stepDataInterface) |
void |
setStepListeners(List<StepListener> stepListeners)
Sets the step listeners.
|
void |
setStepMeta(StepMeta stepMeta) |
void |
setStepMetaInterface(StepMetaInterface stepMetaInterface) |
void |
setStepname(String stepname)
Sets the stepname.
|
void |
setStopped(boolean stopped) |
void |
setTransMeta(TransMeta transMeta) |
void |
setUsingThreadPriorityManagment(boolean usingThreadPriorityManagment)
Set to true to actively manage priorities of step threads.
|
void |
setVariable(String variableName,
String variableValue) |
void |
shareVariablesWith(org.pentaho.di.core.variables.VariableSpace space) |
void |
stopAll()
Flags all rowsets as stopped/completed/finished.
|
void |
stopRunning()
Deprecated.
|
void |
stopRunning(StepMetaInterface stepMetaInterface,
StepDataInterface stepDataInterface)
Perform actions to stop a running step.
|
String |
toString() |
@Deprecated public long linesRead
@Deprecated public long linesWritten
@Deprecated public long linesInput
@Deprecated public long linesOutput
@Deprecated public long linesUpdated
@Deprecated public long linesSkipped
@Deprecated public long linesRejected
public boolean first
public boolean terminator
public BaseStep(StepMeta stepMeta, StepDataInterface stepDataInterface, int copyNr, TransMeta transMeta, Trans trans)
stepMeta
- The StepMeta object to run.stepDataInterface
- the data object to store temporary data, database connections, caches, result sets,
hashtables etc.copyNr
- The copynumber for this step.transMeta
- The TransInfo of which the step stepMeta is part of.trans
- The (running) transformation to obtain information shared among the steps.public boolean init(StepMetaInterface smi, StepDataInterface sdi)
StepInterface
init
in interface StepInterface
smi
- The metadata to work withsdi
- The data to initializepublic void dispose(StepMetaInterface smi, StepDataInterface sdi)
StepInterface
dispose
in interface StepInterface
smi
- The metadata to work withsdi
- The data to dispose ofpublic void cleanup()
StepInterface
cleanup
in interface StepInterface
public long getProcessed()
getProcessed
in interface StepInterface
public void setCopy(int cop)
cop
- the new copypublic int getCopy()
getCopy
in interface StepInterface
public long getErrors()
StepInterface
getErrors
in interface StepInterface
public void setErrors(long e)
StepInterface
setErrors
in interface StepInterface
e
- the number of errors to setpublic long getLinesRead()
getLinesRead
in interface StepInterface
public long incrementLinesRead()
public long decrementLinesRead()
public void setLinesRead(long newLinesReadValue)
newLinesReadValue
- the new number of lines read from previous stepspublic long getLinesInput()
getLinesInput
in interface StepInterface
public long incrementLinesInput()
public void setLinesInput(long newLinesInputValue)
newLinesInputValue
- the new number of lines read from an input source: database, file, socket, etc.public long getLinesOutput()
getLinesOutput
in interface StepInterface
public long incrementLinesOutput()
public void setLinesOutput(long newLinesOutputValue)
newLinesOutputValue
- the new number of lines written to an output target: database, file, socket, etc.public long getLinesWritten()
getLinesWritten
in interface StepInterface
public long incrementLinesWritten()
public long decrementLinesWritten()
public void setLinesWritten(long newLinesWrittenValue)
newLinesWrittenValue
- the new number of lines written to next stepspublic long getLinesUpdated()
getLinesUpdated
in interface StepInterface
public long incrementLinesUpdated()
public void setLinesUpdated(long newLinesUpdatedValue)
newLinesOutputValue
- the new number of lines updated in an output target: database, file, socket, etc.public long getLinesRejected()
getLinesRejected
in interface StepInterface
public long incrementLinesRejected()
public void setLinesRejected(long newLinesRejectedValue)
setLinesRejected
in interface StepInterface
newLinesRejectedValue
- lines number of lines rejected to an error handling steppublic long getLinesSkipped()
public long incrementLinesSkipped()
public void setLinesSkipped(long newLinesSkippedValue)
newLinesSkippedValue
- lines number of lines skippedpublic String getStepname()
StepInterface
getStepname
in interface StepInterface
public void setStepname(String stepname)
stepname
- the new stepnamepublic Trans getDispatcher()
public String getStatusDescription()
public StepMetaInterface getStepMetaInterface()
public void setStepMetaInterface(StepMetaInterface stepMetaInterface)
stepMetaInterface
- The stepMetaInterface to set.public StepDataInterface getStepDataInterface()
public void setStepDataInterface(StepDataInterface stepDataInterface)
stepDataInterface
- The stepDataInterface to set.public StepMeta getStepMeta()
getStepMeta
in interface StepInterface
public void setStepMeta(StepMeta stepMeta)
stepMeta
- The stepMeta to set.public TransMeta getTransMeta()
public void setTransMeta(TransMeta transMeta)
transMeta
- The transMeta to set.public Trans getTrans()
getTrans
in interface StepInterface
public void putRow(org.pentaho.di.core.row.RowMetaInterface rowMeta, Object[] row) throws org.pentaho.di.core.exception.KettleStepException
putRow
in interface StepInterface
row
- The row to put to the destination rowset(s).rowMeta
- The row to send to the destinations stepsorg.pentaho.di.core.exception.KettleStepException
public void putRowTo(org.pentaho.di.core.row.RowMetaInterface rowMeta, Object[] row, org.pentaho.di.core.RowSet rowSet) throws org.pentaho.di.core.exception.KettleStepException
rowMeta
- The row meta-data to put to the destination RowSet.row
- the data to put in the RowSetrowSet
- the RoWset to put the row into.org.pentaho.di.core.exception.KettleStepException
- In case something unexpected goes wrongpublic void putError(org.pentaho.di.core.row.RowMetaInterface rowMeta, Object[] row, long nrErrors, String errorDescriptions, String fieldNames, String errorCodes) throws org.pentaho.di.core.exception.KettleStepException
rowMeta
- the row metarow
- the rownrErrors
- the nr errorserrorDescriptions
- the error descriptionsfieldNames
- the field nameserrorCodes
- the error codesorg.pentaho.di.core.exception.KettleStepException
- the kettle step exceptionpublic Object[] getRow() throws org.pentaho.di.core.exception.KettleException
getRow
in interface StepInterface
org.pentaho.di.core.exception.KettleException
public void identifyErrorOutput()
StepInterface
identifyErrorOutput
in interface StepInterface
public static void safeModeChecking(org.pentaho.di.core.row.RowMetaInterface referenceRowMeta, org.pentaho.di.core.row.RowMetaInterface rowMeta) throws org.pentaho.di.core.exception.KettleRowException
referenceRowMeta
- the reference row metarowMeta
- the row metaorg.pentaho.di.core.exception.KettleRowException
- the kettle row exceptionpublic Object[] getRowFrom(org.pentaho.di.core.RowSet rowSet) throws org.pentaho.di.core.exception.KettleStepException
rowSet
- the row setorg.pentaho.di.core.exception.KettleStepException
- the kettle step exceptionpublic org.pentaho.di.core.RowSet findInputRowSet(String sourceStep) throws org.pentaho.di.core.exception.KettleStepException
sourceStep
- the source steporg.pentaho.di.core.exception.KettleStepException
- the kettle step exceptionpublic org.pentaho.di.core.RowSet findInputRowSet(String from, int fromcopy, String to, int tocopy)
from
- the fromfromcopy
- the fromcopyto
- the totocopy
- the tocopypublic org.pentaho.di.core.RowSet findOutputRowSet(String targetStep) throws org.pentaho.di.core.exception.KettleStepException
targetStep
- the target steporg.pentaho.di.core.exception.KettleStepException
- the kettle step exceptionpublic org.pentaho.di.core.RowSet findOutputRowSet(String from, int fromcopy, String to, int tocopy)
from
- fromcopy
- to
- tocopy
- public void setOutputDone()
StepInterface
setOutputDone
in interface StepInterface
public void dispatch()
public boolean isBasic()
public boolean isDetailed()
public boolean isDebug()
public boolean isRowLevel()
public void logMinimal(String message)
message
- the messagepublic void logMinimal(String message, Object... arguments)
message
- the messagearguments
- the argumentspublic void logBasic(String message)
message
- the messagepublic void logBasic(String message, Object... arguments)
message
- the messagearguments
- the argumentspublic void logDetailed(String message)
message
- the messagepublic void logDetailed(String message, Object... arguments)
message
- the messagearguments
- the argumentspublic void logDebug(String message)
message
- the messagepublic void logDebug(String message, Object... arguments)
message
- the messagearguments
- the argumentspublic void logRowlevel(String message)
message
- the messagepublic void logRowlevel(String message, Object... arguments)
message
- the messagearguments
- the argumentspublic void logError(String message)
message
- the messagepublic void logError(String message, Throwable e)
message
- the messagee
- the epublic void logError(String message, Object... arguments)
message
- the messagearguments
- the argumentspublic int getNextClassNr()
public boolean outputIsDone()
public void stopAll()
StepInterface
stopAll
in interface StepInterface
public boolean isStopped()
isStopped
in interface StepInterface
public boolean isRunning()
isRunning
in interface StepInterface
public boolean isPaused()
isPaused
in interface StepInterface
public void setStopped(boolean stopped)
setStopped
in interface StepInterface
stopped
- true if the step needs to be stoppedpublic void setRunning(boolean running)
StepInterface
setRunning
in interface StepInterface
running
- the running flag to setpublic void pauseRunning()
StepInterface
pauseRunning
in interface StepInterface
public void resumeRunning()
StepInterface
resumeRunning
in interface StepInterface
public void setPaused(boolean paused)
paused
- the new pausedpublic void setPaused(AtomicBoolean paused)
paused
- the new pausedpublic boolean isInitialising()
public void markStart()
StepInterface
markStart
in interface StepInterface
public void setInternalVariables()
public void markStop()
StepInterface
markStop
in interface StepInterface
public long getRuntime()
getRuntime
in interface StepInterface
public org.pentaho.di.core.RowMetaAndData buildLog(String sname, int copynr, long lines_read, long lines_written, long lines_updated, long lines_skipped, long errors, Date start_date, Date end_date)
sname
- the snamecopynr
- the copynrlines_read
- the lines_readlines_written
- the lines_writtenlines_updated
- the lines_updatedlines_skipped
- the lines_skippederrors
- the errorsstart_date
- the start_dateend_date
- the end_datepublic static final org.pentaho.di.core.row.RowMetaInterface getLogFields(String comm)
comm
- the commpublic int rowsetOutputSize()
rowsetOutputSize
in interface StepInterface
public int rowsetInputSize()
rowsetInputSize
in interface StepInterface
public void stopRunning(StepMetaInterface stepMetaInterface, StepDataInterface stepDataInterface) throws org.pentaho.di.core.exception.KettleException
stopRunning
in interface StepInterface
stepDataInterface
- The interface to the step data containing the connections, resultsets, open files, etc.stepMetaInterface
- The metadata that might be needed by the step to stop running.org.pentaho.di.core.exception.KettleException
- in case something goes wrong@Deprecated public void stopRunning()
public void logSummary()
public String getStepID()
getStepID
in interface StepInterface
public List<org.pentaho.di.core.RowSet> getInputRowSets()
getInputRowSets
in interface StepInterface
public void setInputRowSets(List<org.pentaho.di.core.RowSet> inputRowSets)
inputRowSets
- The inputRowSets to set.public List<org.pentaho.di.core.RowSet> getOutputRowSets()
getOutputRowSets
in interface StepInterface
public void setOutputRowSets(List<org.pentaho.di.core.RowSet> outputRowSets)
outputRowSets
- The outputRowSets to set.public boolean isDistributed()
public void setDistributed(boolean distributed)
distributed
- The distributed to set.public void addRowListener(RowListener rowListener)
StepInterface
addRowListener
in interface StepInterface
rowListener
- the rowlistener to addpublic void removeRowListener(RowListener rowListener)
StepInterface
removeRowListener
in interface StepInterface
rowListener
- the rowlistener to removepublic List<RowListener> getRowListeners()
getRowListeners
in interface StepInterface
public void addResultFile(org.pentaho.di.core.ResultFile resultFile)
resultFile
- the result filepublic Map<String,org.pentaho.di.core.ResultFile> getResultFiles()
getResultFiles
in interface StepInterface
public BaseStepData.StepExecutionStatus getStatus()
getStatus
in interface StepInterface
StepDataInterface
public String getPartitionID()
getPartitionID
in interface StepInterface
public void setPartitionID(String partitionID)
setPartitionID
in interface StepInterface
partitionID
- the partitionID to setpublic Map<String,org.pentaho.di.core.BlockingRowSet> getPartitionTargets()
public void setPartitionTargets(Map<String,org.pentaho.di.core.BlockingRowSet> partitionTargets)
partitionTargets
- the partitionTargets to setpublic int getRepartitioning()
public void setRepartitioning(int repartitioning)
setRepartitioning
in interface StepInterface
repartitioning
- the repartitioning type to setpublic boolean isPartitioned()
isPartitioned
in interface StepInterface
public void setPartitioned(boolean partitioned)
setPartitioned
in interface StepInterface
partitioned
- the partitioned to setpublic org.pentaho.di.core.row.RowMetaInterface getInputRowMeta()
public void setInputRowMeta(org.pentaho.di.core.row.RowMetaInterface rowMeta)
rowMeta
- the rowMeta to setpublic org.pentaho.di.core.row.RowMetaInterface getErrorRowMeta()
public void setErrorRowMeta(org.pentaho.di.core.row.RowMetaInterface errorRowMeta)
errorRowMeta
- the errorRowMeta to setpublic org.pentaho.di.core.row.RowMetaInterface getPreviewRowMeta()
public void setPreviewRowMeta(org.pentaho.di.core.row.RowMetaInterface previewRowMeta)
previewRowMeta
- the previewRowMeta to setpublic void copyVariablesFrom(org.pentaho.di.core.variables.VariableSpace space)
copyVariablesFrom
in interface org.pentaho.di.core.variables.VariableSpace
public String environmentSubstitute(String aString)
environmentSubstitute
in interface org.pentaho.di.core.variables.VariableSpace
public String[] environmentSubstitute(String[] aString)
environmentSubstitute
in interface org.pentaho.di.core.variables.VariableSpace
public String fieldSubstitute(String aString, org.pentaho.di.core.row.RowMetaInterface rowMeta, Object[] rowData) throws org.pentaho.di.core.exception.KettleValueException
fieldSubstitute
in interface org.pentaho.di.core.variables.VariableSpace
org.pentaho.di.core.exception.KettleValueException
public org.pentaho.di.core.variables.VariableSpace getParentVariableSpace()
getParentVariableSpace
in interface org.pentaho.di.core.variables.VariableSpace
public void setParentVariableSpace(org.pentaho.di.core.variables.VariableSpace parent)
setParentVariableSpace
in interface org.pentaho.di.core.variables.VariableSpace
public String getVariable(String variableName, String defaultValue)
getVariable
in interface org.pentaho.di.core.variables.VariableSpace
public String getVariable(String variableName)
getVariable
in interface org.pentaho.di.core.variables.VariableSpace
public boolean getBooleanValueOfVariable(String variableName, boolean defaultValue)
getBooleanValueOfVariable
in interface org.pentaho.di.core.variables.VariableSpace
public void initializeVariablesFrom(org.pentaho.di.core.variables.VariableSpace parent)
initializeVariablesFrom
in interface org.pentaho.di.core.variables.VariableSpace
public String[] listVariables()
listVariables
in interface org.pentaho.di.core.variables.VariableSpace
public void setVariable(String variableName, String variableValue)
setVariable
in interface org.pentaho.di.core.variables.VariableSpace
public void shareVariablesWith(org.pentaho.di.core.variables.VariableSpace space)
shareVariablesWith
in interface org.pentaho.di.core.variables.VariableSpace
public void injectVariables(Map<String,String> prop)
injectVariables
in interface org.pentaho.di.core.variables.VariableSpace
public String getTypeId()
public int getSlaveNr()
public int getClusterSize()
public int getUniqueStepNrAcrossSlaves()
public int getUniqueStepCountAcrossSlaves()
public List<ServerSocket> getServerSockets()
public void setServerSockets(List<ServerSocket> serverSockets)
serverSockets
- the serverSockets to setpublic void setUsingThreadPriorityManagment(boolean usingThreadPriorityManagment)
setUsingThreadPriorityManagment
in interface StepInterface
usingThreadPriorityManagment
- set to true to actively manage priorities of step threadspublic boolean isUsingThreadPriorityManagment()
isUsingThreadPriorityManagment
in interface StepInterface
public void initBeforeStart() throws org.pentaho.di.core.exception.KettleStepException
initBeforeStart
in interface StepInterface
org.pentaho.di.core.exception.KettleStepException
- In case there is an errorpublic List<StepListener> getStepListeners()
public void setStepListeners(List<StepListener> stepListeners)
stepListeners
- the stepListeners to setpublic boolean processRow(StepMetaInterface smi, StepDataInterface sdi) throws org.pentaho.di.core.exception.KettleException
StepInterface
processRow
in interface StepInterface
smi
- The steps metadata to work withsdi
- The steps temporary working data to work with (database connections, result sets, caches, temporary variables, etc.)org.pentaho.di.core.exception.KettleException
public boolean canProcessOneRow()
StepInterface
For example, if a step has no input records but needs at least one to function, it will return false.
canProcessOneRow
in interface StepInterface
public void addStepListener(StepListener stepListener)
StepInterface
addStepListener
in interface StepInterface
stepListener
- The listener to add to the steppublic boolean isMapping()
isMapping
in interface StepInterface
public SocketRepository getSocketRepository()
public void setSocketRepository(SocketRepository socketRepository)
socketRepository
- the socketRepository to setpublic String getObjectName()
getObjectName
in interface org.pentaho.di.core.logging.LoggingObjectInterface
public org.pentaho.di.core.logging.LogChannelInterface getLogChannel()
getLogChannel
in interface HasLogChannelInterface
getLogChannel
in interface StepInterface
public String getFilename()
getFilename
in interface org.pentaho.di.core.logging.LoggingObjectInterface
public String getLogChannelId()
getLogChannelId
in interface org.pentaho.di.core.logging.LoggingObjectInterface
public org.pentaho.di.repository.ObjectId getObjectId()
getObjectId
in interface org.pentaho.di.core.logging.LoggingObjectInterface
public org.pentaho.di.repository.ObjectRevision getObjectRevision()
getObjectRevision
in interface org.pentaho.di.core.logging.LoggingObjectInterface
public org.pentaho.di.core.logging.LoggingObjectType getObjectType()
getObjectType
in interface org.pentaho.di.core.logging.LoggingObjectInterface
public org.pentaho.di.core.logging.LoggingObjectInterface getParent()
getParent
in interface org.pentaho.di.core.logging.LoggingObjectInterface
public org.pentaho.di.repository.RepositoryDirectory getRepositoryDirectory()
getRepositoryDirectory
in interface org.pentaho.di.core.logging.LoggingObjectInterface
public String getObjectCopy()
getObjectCopy
in interface org.pentaho.di.core.logging.LoggingObjectInterface
public org.pentaho.di.core.logging.LogLevel getLogLevel()
getLogLevel
in interface org.pentaho.di.core.logging.LoggingObjectInterface
public void setLogLevel(org.pentaho.di.core.logging.LogLevel logLevel)
logLevel
- the new log levelpublic static void closeQuietly(Closeable cl)
cl
- the object that can be closed.public String getContainerObjectId()
getContainerObjectId
in interface org.pentaho.di.core.logging.LoggingObjectInterface
public void setCarteObjectId(String containerObjectId)
containerObjectId
- the containerObjectId to setpublic void batchComplete() throws org.pentaho.di.core.exception.KettleException
StepInterface
batchComplete
in interface StepInterface
org.pentaho.di.core.exception.KettleException
- In case an error occurs during the processing of the batch of rows.public List<RemoteStep> getRemoteInputSteps()
public List<RemoteStep> getRemoteOutputSteps()
public Date getRegistrationDate()
getRegistrationDate
in interface org.pentaho.di.core.logging.LoggingObjectInterface
public boolean isGatheringMetrics()
isGatheringMetrics
in interface org.pentaho.di.core.logging.LoggingObjectInterface
public void setGatheringMetrics(boolean gatheringMetrics)
setGatheringMetrics
in interface org.pentaho.di.core.logging.LoggingObjectInterface
public boolean isForcingSeparateLogging()
isForcingSeparateLogging
in interface org.pentaho.di.core.logging.LoggingObjectInterface
public void setForcingSeparateLogging(boolean forcingSeparateLogging)
setForcingSeparateLogging
in interface org.pentaho.di.core.logging.LoggingObjectInterface
public Repository getRepository()
getRepository
in interface StepInterface
public void setRepository(Repository repository)
setRepository
in interface StepInterface
repository
- The repository used by the step to load and reference Kettle objects with at runtimepublic org.pentaho.metastore.api.IMetaStore getMetaStore()
getMetaStore
in interface StepInterface
public void setMetaStore(org.pentaho.metastore.api.IMetaStore metaStore)
StepInterface
setMetaStore
in interface StepInterface
metaStore
- The metastore to usepublic int getCurrentOutputRowSetNr()
getCurrentOutputRowSetNr
in interface StepInterface
public void setCurrentOutputRowSetNr(int index)
setCurrentOutputRowSetNr
in interface StepInterface
index
- Sets the index of the active (current) output row set to use.public int getCurrentInputRowSetNr()
getCurrentInputRowSetNr
in interface StepInterface
public void setCurrentInputRowSetNr(int index)
setCurrentInputRowSetNr
in interface StepInterface
index
- Sets the index of the active (current) input row set to use.