com.nt.udc.ndk.node

Class OIFtpNode

java.lang.Object

com.nt.udc.ndk.node.DCNode

com.nt.udc.ndk.node.OINode

com.nt.udc.ndk.node.OIFtpNode

All Implemented Interfaces:

AdminIfc, ConfigIfc, LoggerIfc, NodeHealthIfc, NodeStateManagementIfc, PropertyIfc, StateManagementIfc, sun.misc.SignalHandler

Direct Known Subclasses:

NAROINode, NARXMLOINode, XMLOIFileNode

public abstract class OIFtpNode
extends OINode
implements sun.misc.SignalHandler

This is the base-class for FTP file-based OI Nodes.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.ArrayList<OIFileFormatter>	fileFormatter
protected boolean	fileLevelTransaction
protected java.util.ArrayList<OIFileWriter>	fileWriter
protected OIFileFormatter	m_formatter This data-member represents the data-formatter.
protected OIFtpPusher	m_pusher
protected java.lang.Class	m_recordClass This data-member represents the NAR class passed in to the NPL field processor.
protected boolean	mtChecked
protected java.util.ArrayList<NPLFieldProcessor>	nplFldProc
protected int	numThreads
protected boolean	orderChecked

Fields inherited from class com.nt.udc.ndk.node.OINode

fpThread, processor, transport, transThread

Fields inherited from class com.nt.udc.ndk.node.DCNode

backupDir, config, configClass, configDir, configFile, configGUIClass, dcHandls, DEFAULT_PROCESSING_INTERVAL, fileMngr, generalMonitoringTimer, inputMonitoringAlarmRaised, inputMonitoringEnabled, inputMonitoringNARFileMgr, inputMonitoringPollingInterval, inputMonitoringPreviousCount, inputMonitoringSilenceCounter, inputMonitoringSilenceInterval, inputMonitoringSilenceIntervalText, logDir, logger, majorType, minorType, node_pm, nodeid, NODEINIT, NODERECONFIG, nodeStartTime, nodeStateFileName, processingInterval, reconfiguring, savingStateOn, scratchDir, shutdown, stateManager, suspenseDir, TRANSACTION_NAR_ID, udcHome

Fields inherited from interface sun.misc.SignalHandler

SIG_DFL, SIG_IGN

Fields inherited from interface com.nt.udc.ndk.node.LoggerIfc

FC_CONFIGURATION, FC_CONNECTIVITY, FC_INITIALIZATION, FC_INTERNALERROR, FC_INVALIDDATA, FC_NODE_CONTROL, FC_RESOURCES, FC_SECURITY, FC_SERVER_CONTROL, FC_UNDEFINED, SF_CONF_CHANGE_ERROR, SF_CONF_CONFIG_FAIL, SF_CONF_ERR_NODE_CONF, SF_CONF_INV_FTP_CONF, SF_CONF_INV_NODE_CONF, SF_CONF_INV_PARAM, SF_CONF_INV_PARAM_VAL, SF_CONF_INV_REM_DIR, SF_CONF_MISSING_PARM, SF_CONF_MISSING_PARM2, SF_CONF_NM_CONF_ERROR, SF_CONF_NO_CONFIG, SF_CONF_NO_FTP_INT, SF_CONF_NODE_CREATION, SF_CONF_NODE_START, SF_CONF_NPL_CRITICAL, SF_CONF_NPL_ERROR, SF_CONF_READ_ERROR, SF_CONF_READ_PROPS, SF_CONF_SAVE_ERROR, SF_CONF_SOCKET_INIT, SF_CONF_VER_VALIDATION, SF_CONN_DB_CON_ERR, SF_CONN_DB_CON_LOST, SF_CONN_DEGRADED_ERR, SF_CONN_ECE_CON_ERR, SF_CONN_ERR_NODEINFO, SF_CONN_ERR_RCV_DATA, SF_CONN_ERR_SEND_ACK, SF_CONN_ERROR_TACHYON_USAGE, SF_CONN_FAILED_TO_RECEIVE_RESPONSE, SF_CONN_FILE_READ_ERR, SF_CONN_FTP_ERROR, SF_CONN_FTP_ERROR2, SF_CONN_FTP_LOGIN, SF_CONN_INTERFACING_CON_ERR, SF_CONN_INVALID_TACHYON_RECORD, SF_CONN_LDAP_CONNECT, SF_CONN_LOST_NM, SF_CONN_NM_API_ERR, SF_CONN_PDU_NULL, SF_CONN_POLL_ERR, SF_CONN_SNMP_SESS_OPEN_FAIL, SF_DATA_AGGR_ERROR, SF_DATA_ATTR_CREATE, SF_DATA_ATTR_PARSE, SF_DATA_ATTR_SHIFT, SF_DATA_CANNOT_ENCODE, SF_DATA_CANT_ACK, SF_DATA_CANT_ENCODE, SF_DATA_CONV_STR_TO_N, SF_DATA_CONV_TO_STR, SF_DATA_CONVERT_ATTR, SF_DATA_DATA_EXPIRED, SF_DATA_DATA_MISSING, SF_DATA_DATA_PROC_ERR, SF_DATA_ENCODE_ERR, SF_DATA_ERR_CREATE, SF_DATA_ERR_SEND_ACK, SF_DATA_ERROR_IN_NPL, SF_DATA_ERROR_ON_ACK, SF_DATA_FILE_DATA, SF_DATA_FILE_PROC_ERR, SF_DATA_FORMAT_ERROR, SF_DATA_IE_INVALID, SF_DATA_IE_MISSING, SF_DATA_INPUT_INVALID, SF_DATA_INV_ATT_TYPE, SF_DATA_INV_ATTR_NPL, SF_DATA_INV_RECORD, SF_DATA_INV_TRAF_VOL, SF_DATA_JDBC_DRIVER_ERR, SF_DATA_KEY_CREATE, SF_DATA_MISSING_ATTRS, SF_DATA_MSG_TOO_SMALL, SF_DATA_MSG_TYPE, SF_DATA_NAR_IS_NULL, SF_DATA_NO_DATA_FILE, SF_DATA_NO_OPT_IE, SF_DATA_REC_INCOMP, SF_DATA_RECORD_PROC, SF_DATA_RECORD_SAVE, SF_DATA_SRC_READ_ERR, SF_DATA_UNABLE_COMPLETE, SF_DATA_UNEXP_NAR, SF_DATA_UNEXPECTED, SF_DATA_VAL_NOT_FOUND, SF_DATA_WRONG_DECODER, SF_INIT_DB_CON_ERR, SF_INIT_DIR_CON_ERR, SF_INIT_IO_ERR, SF_INIT_LDM, SF_INIT_LDM_RUN, SF_INIT_NODE_CONFIG, SF_INIT_NODE_CREATION, SF_INIT_NODE_INIT, SF_INIT_NODE_START, SF_INIT_RDM, SF_INIT_RDM_RUN, SF_INIT_REG_ERROR, SF_INIT_RULE_LOAD_ERR, SF_INIT_SOCKET_CREATE, SF_INIT_SOCKET_INIT, SF_INT_ERR_ETRACE, SF_INT_ERR_EXCEPTION, SF_INT_ERR_EXPIRE_ERR, SF_INT_ERR_FIELD_NULL, SF_INT_ERR_PROC_ERR, SF_INT_ERR_SHUTDOWN, SF_NC_ERR_IN_NODE, SF_NC_ERR_MNG_SERVER, SF_NC_ERR_NODE_STATE, SF_NC_ERR_PROC_DATA, SF_NC_ERR_RESTARTING, SF_NC_ERR_STARTING, SF_NC_ERR_STOPPING, SF_NC_ERR_UNHEALTHY, SF_NC_NODE_CONF_ERROR, SF_NC_NODE_SHUTDOWN, SF_RES_CPU_MAJOR, SF_RES_CPU_MINOR, SF_RES_CPU_USAGE_ERR, SF_RES_DISK_CRITICAL, SF_RES_DISK_MINOR, SF_RES_DISK_STATUS, SF_RES_DISK_USAGE, SF_RES_ERR_DATA_READ, SF_RES_ERR_DATA_REM, SF_RES_ERR_DB_CLOSE, SF_RES_ERR_DB_OP, SF_RES_ERR_DEL_ENTRY, SF_RES_ERR_DIR_CLOSE, SF_RES_ERR_DIR_CREATE, SF_RES_ERR_DIR_DELETE, SF_RES_ERR_DIR_OPEN, SF_RES_ERR_DIR_PROC, SF_RES_ERR_DIR_READ, SF_RES_ERR_DIR_WRITE, SF_RES_ERR_ENT_CREATE, SF_RES_ERR_FILE_CLOSE, SF_RES_ERR_FILE_CREAT, SF_RES_ERR_FILE_DEL, SF_RES_ERR_FILE_MOVE, SF_RES_ERR_FILE_NAME, SF_RES_ERR_FILE_OPEN, SF_RES_ERR_FILE_PROC, SF_RES_ERR_FILE_READ, SF_RES_ERR_FILE_REN, SF_RES_ERR_FILE_WRITE, SF_RES_ERR_IN_TRANS, SF_RES_ERR_INST_CLASS, SF_RES_ERR_INST_REC, SF_RES_ERR_IO_ERR, SF_RES_ERR_OPEN_TRANS, SF_RES_ERR_READ_DU, SF_RES_ERR_SOCK_CLOSE, SF_RES_ERR_SOCK_CREAT, SF_RES_ERR_SOCK_OPEN, SF_RES_ERR_SOCK_WRITE, SF_RES_ERR_TABLE_ACC, SF_RES_ERR_TABLE_CLOS, SF_RES_ERR_TABLE_OPEN, SF_RES_ERR_TIMER_SCHED, SF_RES_ERR_USING_Q, SF_RES_IS_NULL, SF_RES_MEM_MAJOR, SF_RES_MEM_WARNING, SF_RES_NO_LICENSE, SF_RES_NODE_STATE_R, SF_RES_NODE_STATE_W, SF_SEC_NO_USER_AUTH, SF_SEC_USER_AUTH_FAIL, SF_SEC_USER_CFG_FAIL, SF_SRV_CNTRL, SF_UND_INTERRUPTED, SF_UND_SHUTDOWN_ERR

Fields inherited from interface com.nt.udc.ndk.node.PropertyIfc

ENVIRONMENT, RUNTIME

Constructor Summary

Constructors

Constructor and Description
OIFtpNode() Default Constructor; instantiates objects necessary to define the DCNodeTypeIfc methods.
OIFtpNode(java.lang.String[] args) Constructor for the class.
OIFtpNode(java.lang.String[] args, boolean isMultiThreaded)

Method Summary

Modifier and Type	Method and Description
void	backup() Performs the necessary tasks to create a backup of the incoming or outgoing data.
DCNodePerformanceIfc	getPerformanceMetrics() Returns the stream handler's node performance object
void	handle(sun.misc.Signal sig)
protected void	initFormatterAndRecord()
protected void	initFormatterAndRecord(int currentThread)
protected OIFtpPusher	initPusher()
protected OIFtpPusher	initPusher(int currentThread)
protected OIFileWriter	initWriter(boolean bStringWriter) This function is used to initialize the writer.
protected OIFileWriter	initWriter(boolean bStringWriter, int currentThread)
boolean	isNodeStateImplemented() This method returns true in order to prevent restoreState from being called in the DCNode constructor, before the node is ready.
void	reconfigure() Performs the necessary tasks to reconfigure the node while it is running.
void	setFldProcessorsAndTransports(java.lang.String tName)
void	setMultiFldProcessorsAndTransports(java.lang.String tName)
protected OIFileWriter	setupWriter(java.lang.String fileDir, java.lang.String fileName, java.lang.String crtExt, java.lang.String doneExt, java.lang.String timePeriod, boolean bStringWriter, int maxRecsPerFile)
protected OIFileWriter	setupWriter(java.lang.String fileDir, java.lang.String fileName, java.lang.String crtExt, java.lang.String doneExt, java.lang.String timePeriod, boolean bStringWriter, int maxRecsPerFile, int currentThread)
void	shutdown() Performs the necessary tasks to properly shutdown the node.
protected void	startNode() This method is to be called when the node is started.

Methods inherited from class com.nt.udc.ndk.node.OINode

createDCStreamHandlers, createDCStreamHandlers, createDCStreamHandlers, getFieldProcessor, getFieldProcessor, getFieldProcessorThread, getFieldProcessorThread, getFileRetentionThread, getMajorType, getOIFileCyclerThread, getOIMTManagerThread, getTransport, getTransport, getTransportThread, isHealthy, isMonitorThreadHealthy, isNodeStateUsed, setFieldProcessor, setFieldProcessor, setFieldProcessorThread, setFieldProcessorThread, setOIFileCyclerThread, setOIMTManagerThread, setTransport, setTransport, setTransportThread

Methods inherited from class com.nt.udc.ndk.node.DCNode

addNodeEventListener, clearStatus, clearStatus, clearStatus, createCounters, getAndResetRecordStatistics, getBackupDir, getConfig, getConfigDataClass, getConfigDataGuiClass, getConfigDir, getConfigFile, getDCNodeType, getDCStreamHandler, getDCStreamHandler, getDiscardedStatsProcessor, getDisplayString, getDuplicateStatsProcessor, getHomeDir, getInputStatsProcessor, getItem, getLogDir, getLogger, getMinorType, getNodeClass, getNodeEventListeners, getNodeId, getNodeStateManager, getOutputStatsProcessor, getProperty, getPropertyKeys, getPropertyTypes, getRejectTransactionId, getScratchDir, getStateManagementType, getStateManager, getStatus, getStoredStatsProcessor, getStreamHandler, getStreamHandler, getSuspenseDir, initialize, inputMonitoringCallback, inputMonitoringPollInputCounter, isDebugEnabled, isInfoEnabled, isReconfigPending, isReconfiguring, isRejectTransaction, isShutdown, isStateUsed, logCritical, logDebug, logError, logInfo, logMajor, logMinor, logTrace, logWarning, logWarning, registerThreadForHealthMonitoring, rejectTransaction, restoreState, saveState, saveState, setConfig, setDCStreamHandler, setDCStreamHandler, setIsReconfiguringFlag, setItem, setProperty, setSNMPTrapGenerator, setStreamHandler, setStreamHandler, shutdownDCStreamHandler, shuttingDown, startup, unregisterThreadFromHealthMonitoring, warmRestartImplemented

Methods inherited from class java.lang.Object

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

Field Detail

m_formatter

protected OIFileFormatter m_formatter

This data-member represents the data-formatter.

m_pusher

protected OIFtpPusher m_pusher

m_recordClass

protected java.lang.Class m_recordClass

This data-member represents the NAR class passed in to the NPL field processor.

mtChecked

protected boolean mtChecked

numThreads

protected int numThreads

orderChecked

protected boolean orderChecked

nplFldProc

protected java.util.ArrayList<NPLFieldProcessor> nplFldProc

fileWriter

protected java.util.ArrayList<OIFileWriter> fileWriter

fileFormatter

protected java.util.ArrayList<OIFileFormatter> fileFormatter

fileLevelTransaction

protected boolean fileLevelTransaction

Constructor Detail

OIFtpNode

public OIFtpNode()

Default Constructor; instantiates objects necessary to define the DCNodeTypeIfc methods.

OIFtpNode

public OIFtpNode(java.lang.String[] args)
          throws NodeStartException

Constructor for the class. Calls the super class OINode with the given array of arguments.

Parameters:

args - Arguments to be passed to the DCNode super class.

Throws:

NodeStartException

OIFtpNode

public OIFtpNode(java.lang.String[] args,
                 boolean isMultiThreaded)
          throws NodeStartException

Throws:

NodeStartException

Method Detail

setMultiFldProcessorsAndTransports

public void setMultiFldProcessorsAndTransports(java.lang.String tName)
                                        throws NodeStartException

Throws:

NodeStartException

setFldProcessorsAndTransports

public void setFldProcessorsAndTransports(java.lang.String tName)
                                   throws NodeStartException

Throws:

NodeStartException

backup

public void backup()

Performs the necessary tasks to create a backup of the incoming or outgoing data. This task is initiated by the node manager periodically, if the node is configured to be backed up.

Overrides:

backup in class DCNode

reconfigure

public void reconfigure()

Performs the necessary tasks to reconfigure the node while it is running. This task is initiated by the node manager.

Specified by:

reconfigure in interface AdminIfc

Overrides:

reconfigure in class DCNode

shutdown

public void shutdown()

Performs the necessary tasks to properly shutdown the node.

Specified by:

shutdown in interface AdminIfc

Overrides:

shutdown in class DCNode

getPerformanceMetrics

public DCNodePerformanceIfc getPerformanceMetrics()

Description copied from class: DCNode

Returns the stream handler's node performance object

Specified by:

getPerformanceMetrics in interface AdminIfc

Overrides:

getPerformanceMetrics in class DCNode

Returns:

DCNodePerformanceIfc object

handle

public void handle(sun.misc.Signal sig)

Specified by:

handle in interface sun.misc.SignalHandler

initWriter

protected OIFileWriter initWriter(boolean bStringWriter)
                           throws NodeStartException

This function is used to initialize the writer.

Parameters:

bStringWriter - true if the writer is used for putting out strings

Throws:

NodeStartException

initWriter

protected OIFileWriter initWriter(boolean bStringWriter,
                                  int currentThread)
                           throws NodeStartException

Throws:

NodeStartException

setupWriter

protected OIFileWriter setupWriter(java.lang.String fileDir,
                                   java.lang.String fileName,
                                   java.lang.String crtExt,
                                   java.lang.String doneExt,
                                   java.lang.String timePeriod,
                                   boolean bStringWriter,
                                   int maxRecsPerFile)
                            throws NodeStartException

Throws:

NodeStartException

setupWriter

protected OIFileWriter setupWriter(java.lang.String fileDir,
                                   java.lang.String fileName,
                                   java.lang.String crtExt,
                                   java.lang.String doneExt,
                                   java.lang.String timePeriod,
                                   boolean bStringWriter,
                                   int maxRecsPerFile,
                                   int currentThread)
                            throws NodeStartException

Throws:

NodeStartException

initPusher

protected OIFtpPusher initPusher()
                          throws NodeStartException

Throws:

NodeStartException

initPusher

protected OIFtpPusher initPusher(int currentThread)
                          throws NodeStartException

Throws:

NodeStartException

initFormatterAndRecord

protected void initFormatterAndRecord()
                               throws NodeStartException

Throws:

NodeStartException

initFormatterAndRecord

protected void initFormatterAndRecord(int currentThread)
                               throws NodeStartException

Throws:

NodeStartException

isNodeStateImplemented

public boolean isNodeStateImplemented()

This method returns true in order to prevent restoreState from being called in the DCNode constructor, before the node is ready.

Overrides:

isNodeStateImplemented in class DCNode

Returns:

true, if node implements node state save and restore

startNode

protected void startNode()
                  throws NodeStartException

This method is to be called when the node is started.

Throws:

NodeStartException