com.ergotech.secs

Class NetLogger

java.lang.Object

com.ergotech.secs.NetLogger

All Implemented Interfaces:

LoggerInterface, SecsEventListener, java.lang.Runnable, java.util.EventListener

public class NetLogger
extends java.lang.Object
implements LoggerInterface, SecsEventListener, java.lang.Runnable

A logger object that logs to the syslog.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	cvsRev

Constructor Summary

Constructors

Constructor and Description
NetLogger(java.lang.String receiveString, java.lang.String sendString, int port)

Method Summary

Modifier and Type	Method and Description
java.lang.String	displayBytes(byte[] data)
boolean	getDisplayBytes()
boolean	getDisplayMessages()
void	log(java.lang.String msg) Send the given string to the listening ports.
static void	main(java.lang.String[] args) Used for debugging only.
void	received(byte[] data) This will be called wheneever raw bytes of data are read from the port.
void	received(SecsMsg msg) Called whenever a message is received.
void	register()
void	register(SecsEventHandler theHandler)
void	registerForId(int id)
void	registerForId(SecsEventHandler theHandler, int id)
void	run() runs the server and waits for input on the selected port.
void	secsEvent(SecsEvent theEvent) This method will be called when a SecsEvent accurs.
void	sent(byte[] data) Called whenever data is sent through the port.
void	sent(SecsMsg msg) Called whenever a message is sent.
void	setDisplayBytes(boolean newValue) This allows the logger to control the display of byte data.
void	setDisplayEvents(boolean newValue) This method will turn on the display of all events.
void	setDisplayMessages(boolean newValue) This allows the logger to control the display of message data.

Methods inherited from class java.lang.Object

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

Field Detail

cvsRev

public static final java.lang.String cvsRev

See Also:

Constant Field Values

Constructor Detail

NetLogger

public NetLogger(java.lang.String receiveString,
                 java.lang.String sendString,
                 int port)

Method Detail

displayBytes

public java.lang.String displayBytes(byte[] data)

getDisplayBytes

public boolean getDisplayBytes()

getDisplayMessages

public boolean getDisplayMessages()

log

public void log(java.lang.String msg)

Send the given string to the listening ports.

main

public static void main(java.lang.String[] args)

Used for debugging only.

received

public void received(byte[] data)

Description copied from interface: LoggerInterface

This will be called wheneever raw bytes of data are read from the port. There is no guarentee the the array will contain a complete message.

Specified by:

received in interface LoggerInterface

received

public void received(SecsMsg msg)

Description copied from interface: LoggerInterface

Called whenever a message is received. This will be called whenever a message is received after the raw byte stream has been converted to a message.

Specified by:

received in interface LoggerInterface

register

public void register()

register

public void register(SecsEventHandler theHandler)

registerForId

public void registerForId(int id)

registerForId

public void registerForId(SecsEventHandler theHandler,
                          int id)

run

public void run()

runs the server and waits for input on the selected port. When a connection is accepted it will start processing on that connection. In general it will create a new instance of this object to do that. For the first connection it simply configures this object and registers it.

Specified by:

run in interface java.lang.Runnable

secsEvent

public void secsEvent(SecsEvent theEvent)

Description copied from interface: SecsEventListener

This method will be called when a SecsEvent accurs.

Specified by:

secsEvent in interface SecsEventListener

sent

public void sent(byte[] data)

Description copied from interface: LoggerInterface

Called whenever data is sent through the port. There is no guarentee that the array will contain a complete message, or even a complete block.

Specified by:

sent in interface LoggerInterface

sent

public void sent(SecsMsg msg)

Description copied from interface: LoggerInterface

Called whenever a message is sent.

Specified by:

sent in interface LoggerInterface

setDisplayBytes

public void setDisplayBytes(boolean newValue)

Description copied from interface: LoggerInterface

This allows the logger to control the display of byte data. This will be called whenever the user wishes to enable or disable the display of byte data. Note that this has no impact on whether the methods are called. The SECS system will always call the logger methods, it is the task of the logger to decide what to do with the information, this method is here just to help with that task.

Specified by:

setDisplayBytes in interface LoggerInterface

setDisplayEvents

public void setDisplayEvents(boolean newValue)

This method will turn on the display of all events. It will do this regardless of the value of the boolean.

Specified by:

setDisplayEvents in interface LoggerInterface

setDisplayMessages

public void setDisplayMessages(boolean newValue)

Description copied from interface: LoggerInterface

This allows the logger to control the display of message data. This will be called whenever the user wishes to enable or disable the display of message data. Note that this has no impact on whether the methods are called. The SECS system will always call the logger methods, it is the task of the logger to decide what to do with the information, this method is here just to help with that task.

Specified by:

setDisplayMessages in interface LoggerInterface