xal.service.tripmonitor

Class ChannelMonitor

java.lang.Object

xal.service.tripmonitor.ChannelMonitor

public class ChannelMonitor
extends java.lang.Object

monitor a single channel

Field Summary

Fields

Modifier and Type	Field and Description
protected ConnectionListener	_connectionListener connection listener
protected ChannelTimeRecord	_lastRecord last record captured
protected Monitor	_monitor event monitor
protected Channel	CHANNEL PV channel
protected java.lang.Object	EVENT_LOCK synchronization lock
protected ChannelEventListener	EVENT_PROXY proxy for posting channel events
protected MessageCenter	MESSAGE_CENTER event message center
protected TripFilter	TRIP_FILTER trip filter

Constructor Summary

Constructors

Constructor and Description
ChannelMonitor(java.lang.String pv, TripFilter tripFilter) constructor

Method Summary

Modifier and Type	Method and Description
void	addChannelEventListener(ChannelEventListener listener) Register the listener as a receiver of channel events from the wrapped channel
protected void	clearTrips() clear the trip count
void	dispose() Dispose of the channel wrapper resources by clearing the monitor (if any) and disposing of the messaging resources.
Channel	getChannel() Get the wrapped channel.
ChannelTimeRecord	getLatestRecord() Get the latest record
java.lang.String	getPV() Get the PV for the channel being wrapped.
boolean	isConnected() Determine if the channel is connected.
protected void	makeMonitor() Create a monitor to listen for new channel records.
protected void	processMonitorEvent(ChannelTimeRecord oldRecord, ChannelTimeRecord record) Process the new monitor event
void	removeChannelEventListener(ChannelEventListener listener) Unregister the listener as a receiver of channel events from the wrapped channel
void	requestConnection() Request that the channel be connected.
java.lang.String	toString() get a description of this channel monitor

Methods inherited from class java.lang.Object

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

Field Detail

EVENT_LOCK

protected final java.lang.Object EVENT_LOCK

synchronization lock

MESSAGE_CENTER

protected final MessageCenter MESSAGE_CENTER

event message center

EVENT_PROXY

protected final ChannelEventListener EVENT_PROXY

proxy for posting channel events

CHANNEL

protected final Channel CHANNEL

PV channel

TRIP_FILTER

protected final TripFilter TRIP_FILTER

trip filter

_monitor

protected Monitor _monitor

event monitor

_lastRecord

protected ChannelTimeRecord _lastRecord

last record captured

_connectionListener

protected ConnectionListener _connectionListener

connection listener

Constructor Detail

ChannelMonitor

public ChannelMonitor(java.lang.String pv,
                      TripFilter tripFilter)

constructor

Method Detail

addChannelEventListener

public void addChannelEventListener(ChannelEventListener listener)

Register the listener as a receiver of channel events from the wrapped channel

Parameters:

listener - The listener to receive channel events

removeChannelEventListener

public void removeChannelEventListener(ChannelEventListener listener)

Unregister the listener as a receiver of channel events from the wrapped channel

Parameters:

listener - The listener to unregister from receiving channel events

getPV

public java.lang.String getPV()

Get the PV for the channel being wrapped.

Returns:

the PV

getChannel

public Channel getChannel()

Get the wrapped channel.

Returns:

the wrapped channel

toString

public java.lang.String toString()

get a description of this channel monitor

Overrides:

toString in class java.lang.Object

isConnected

public boolean isConnected()

Determine if the channel is connected.

Returns:

true if the channel is connected and false if not.

getLatestRecord

public ChannelTimeRecord getLatestRecord()

Get the latest record

Returns:

the latest record

processMonitorEvent

protected void processMonitorEvent(ChannelTimeRecord oldRecord,
                                   ChannelTimeRecord record)

Process the new monitor event

Parameters:

record - the new record from which to get the latest value to test for a trip

oldRecord - the old record which preceeds the new record

clearTrips

protected void clearTrips()

clear the trip count

requestConnection

public void requestConnection()

Request that the channel be connected. When the channel connection occurs, create a monitor.

makeMonitor

protected void makeMonitor()

Create a monitor to listen for new channel records. An instance of an internal anonymous class is the listener of the monitor events and caches the latest channel record.

dispose

public void dispose()

Dispose of the channel wrapper resources by clearing the monitor (if any) and disposing of the messaging resources.