Package jmri.jmrix.openlcb

Class OlcbSensorManager

java.lang.Object

jmri.beans.PropertyChangeSupport

jmri.beans.VetoableChangeSupport

jmri.managers.AbstractManager<Sensor>

jmri.managers.AbstractSensorManager

jmri.jmrix.openlcb.OlcbSensorManager

All Implemented Interfaces:

PropertyChangeListener, VetoableChangeListener, EventListener, PropertyChangeFirer, PropertyChangeProvider, SilenceablePropertyChangeProvider, VetoableChangeFirer, VetoableChangeProvider, AbstractMRListener, CanListener, Manager<Sensor>, NameIncrementingManager, ProvidingManager<Sensor>, SensorManager

public class OlcbSensorManager
extends AbstractSensorManager
implements CanListener

Manage the OpenLCB-specific Sensor implementation. System names are "MSnnn", where M is the user configurable system prefix, nnn is the sensor number without padding.

Nested Class Summary

Nested classes/interfaces inherited from interface jmri.Manager

Manager.ManagerDataEvent<E extends NamedBean>, Manager.ManagerDataListener<E extends NamedBean>, Manager.NameValidity

Field Summary

Fields inherited from class jmri.managers.AbstractSensorManager

sensorDebounceGoingActive, sensorDebounceGoingInActive

Fields inherited from class jmri.managers.AbstractManager

_beans, _tsys, _tuser, memo, silenceableProperties, silencedProperties

Fields inherited from class jmri.beans.VetoableChangeSupport

vetoableChangeSupport

Fields inherited from class jmri.beans.PropertyChangeSupport

propertyChangeSupport

Fields inherited from interface jmri.Manager

ANALOGIOS, AUDIO, BLOCKBOSS, BLOCKS, CONDITIONALS, CTCDATA, ENTRYEXIT, IDTAGS, LAYOUTBLOCKS, LIGHTS, LOGIXNG_ANALOG_ACTIONS, LOGIXNG_ANALOG_EXPRESSIONS, LOGIXNG_CONDITIONALNGS, LOGIXNG_DIGITAL_ACTIONS, LOGIXNG_DIGITAL_BOOLEAN_ACTIONS, LOGIXNG_DIGITAL_EXPRESSIONS, LOGIXNG_GLOBAL_VARIABLES, LOGIXNG_MODULES, LOGIXNG_STRING_ACTIONS, LOGIXNG_STRING_EXPRESSIONS, LOGIXNG_TABLES, LOGIXNGS, LOGIXS, MEMORIES, METERFRAMES, METERS, OBLOCKS, PANELFILES, PROPERTY_BEANS, PROPERTY_CAN_DELETE, PROPERTY_DISPLAY_LIST_NAME, PROPERTY_DO_DELETE, PROPERTY_DO_NOT_DELETE, PROPERTY_LENGTH, REPORTERS, ROUTES, SECTIONS, SENSORGROUPS, SENSORS, SIGNALGROUPS, SIGNALHEADS, SIGNALMASTLOGICS, SIGNALMASTS, STRINGIOS, TIMEBASE, TRANSITS, TURNOUTS, WARRANTS

Constructor Summary

Constructors

Constructor	Description
OlcbSensorManager(CanSystemConnectionMemo memo)

Method Summary

Modifier and Type	Method	Description
boolean	allowMultipleAdditions(String systemName)	Determines if it is possible to add a range of NamedBeans in numerical order for a particular system implementation.
protected Sensor	createNewSensor(String systemName, String userName)	Internal method to invoke the factory and create a new Sensor.
String	createSystemName(String curAddress, String prefix)	Default Sensor ensures a numeric only system name.
void	dispose()	Free resources when no longer used.
void	finishLoad()	This function is invoked after the XML load is complete and all Sensors are instantiated and their feedback type is read in.
String	getEntryToolTip()	Provide a manager-specific tooltip for the Add new item beantable pane.
List<NamedBeanPropertyDescriptor<?>>	getKnownBeanProperties()	By default there are no custom properties.
CanSystemConnectionMemo	getMemo()	Get the system connection for this manager.
String	getNextValidSystemName(NamedBean currentBean)	Get the next valid NamedBean system name.
void	message(CanMessage l)	Called when an outgoing message is sent to the CAN Network.
void	reply(CanReply l)	Called when an incoming CanFrame is received from the CAN Network.
void	startLoad()	This function is invoked before an XML load is started.
String	validateSystemNameFormat(String name, Locale locale)	Validates to OpenLCB format.

Methods inherited from class jmri.managers.AbstractSensorManager

getBeanTypeHandled, getBySystemName, getDefaultSensorDebounceGoingActive, getDefaultSensorDebounceGoingInActive, getNamedBeanClass, getSensor, getXMLOrder, isPullResistanceConfigurable, newSensor, provideSensor, setDefaultSensorDebounceGoingActive, setDefaultSensorDebounceGoingInActive, typeLetter, updateAll

Methods inherited from class jmri.managers.AbstractManager

addDataListener, checkNumeric, deleteBean, deregister, fireDataListenersAdded, fireDataListenersRemoved, fireVetoableChange, getAutoSystemName, getBySystemName, getByUserName, getNamedBean, getNamedBeanSet, getObjectCount, getOuterBean, getSystemPrefix, handleUserNameUniqueness, makeSystemName, propertyChange, register, registerSelf, registerUserName, removeDataListener, setDataListenerMute, setPropertyChangesSilenced, updateAutoNumber, validSystemNameFormat, vetoableChange

Methods inherited from class jmri.beans.VetoableChangeSupport

addVetoableChangeListener, addVetoableChangeListener, fireVetoableChange, fireVetoableChange, fireVetoableChange, getVetoableChangeListeners, getVetoableChangeListeners, removeVetoableChangeListener, removeVetoableChangeListener

Methods inherited from class jmri.beans.PropertyChangeSupport

addPropertyChangeListener, addPropertyChangeListener, fireIndexedPropertyChange, fireIndexedPropertyChange, fireIndexedPropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getPropertyChangeListeners, getPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener

Methods inherited from class java.lang.Object

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

Methods inherited from interface jmri.jmrix.can.CanListener

addTc, addTc, removeTc, removeTc

Methods inherited from interface jmri.Manager

addDataListener, deleteBean, deregister, getBeanTypeHandled, getNamedBean, getNamedBeanSet, getObjectCount, getSubSystemNamePrefix, getSystemNamePrefix, getSystemPrefix, isValidSystemNameFormat, makeSystemName, makeSystemName, makeSystemName, register, removeDataListener, setDataListenerMute, validateBadCharsInSystemNameFormat, validateIntegerSystemNameFormat, validateNmraAccessorySystemNameFormat, validateSystemNameFormat, validateSystemNameFormatOnlyNumeric, validateSystemNamePrefix, validateTrimmedMin1NumberSystemNameFormat, validateTrimmedSystemNameFormat, validateUppercaseTrimmedSystemNameFormat, validSystemNameFormat

Methods inherited from interface jmri.beans.PropertyChangeProvider

addPropertyChangeListener, addPropertyChangeListener, getPropertyChangeListeners, getPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener

Methods inherited from interface jmri.SensorManager

getByUserName, provide

Methods inherited from interface jmri.beans.SilenceablePropertyChangeProvider

setPropertyChangesSilenced

Methods inherited from interface jmri.beans.VetoableChangeProvider

addVetoableChangeListener, addVetoableChangeListener, getVetoableChangeListeners, getVetoableChangeListeners, removeVetoableChangeListener, removeVetoableChangeListener

Constructor Details

OlcbSensorManager

public OlcbSensorManager(CanSystemConnectionMemo memo)

Method Details

getMemo

@Nonnull
public CanSystemConnectionMemo getMemo()

Get the system connection for this manager.

Specified by:

getMemo in interface Manager<Sensor>

Overrides:

getMemo in class AbstractManager<Sensor>

Returns:

the system connection for this manager

getKnownBeanProperties

@Nonnull
public List<NamedBeanPropertyDescriptor<?>> getKnownBeanProperties()

Description copied from class: AbstractManager

By default there are no custom properties.

Specified by:

getKnownBeanProperties in interface Manager<Sensor>

Overrides:

getKnownBeanProperties in class AbstractManager<Sensor>

Returns:

empty list

dispose

public void dispose()

Description copied from class: AbstractManager

Free resources when no longer used. Specifically, remove all references to and from this object, so it can be garbage-collected.

Specified by:

dispose in interface Manager<Sensor>

Specified by:

dispose in interface SensorManager

Overrides:

dispose in class AbstractManager<Sensor>

createNewSensor

@Nonnull
protected Sensor createNewSensor(@Nonnull
 String systemName,
 String userName)
                          throws IllegalArgumentException

Internal method to invoke the factory and create a new Sensor. Called after all the logic for returning an existing Sensor has been invoked. An existing SystemName is not found, existing UserName not found. Implementing classes should base Sensor on the system name, then add user name.

Specified by:

createNewSensor in class AbstractSensorManager

Parameters:

systemName - the system name to use for the new Sensor

userName - the optional user name to use for the new Sensor

Returns:

the new Sensor

Throws:

IllegalArgumentException - when SystemName can't be converted

startLoad

public void startLoad()

This function is invoked before an XML load is started. We defer initialization of the newly created Sensors until finishLoad because the feedback type might be changing as we are parsing the XML.

finishLoad

public void finishLoad()

This function is invoked after the XML load is complete and all Sensors are instantiated and their feedback type is read in. We use this hook to finalize the construction of the OpenLCB objects whose instantiation was deferred until the feedback type was known.

allowMultipleAdditions

public boolean allowMultipleAdditions(@Nonnull
 String systemName)

Description copied from interface: NameIncrementingManager

Determines if it is possible to add a range of NamedBeans in numerical order for a particular system implementation.

Default is not providing this service. Systems should override this method if they do provide the service.

Specified by:

allowMultipleAdditions in interface NameIncrementingManager

Parameters:

systemName - the system name to check against; appears to be ignored in all implementations

Returns:

true if possible; false otherwise

createSystemName

@Nonnull
public String createSystemName(@Nonnull
 String curAddress,
 @Nonnull
 String prefix)
                        throws JmriException

Description copied from class: AbstractSensorManager

Default Sensor ensures a numeric only system name. Create a System Name from hardware address and system letter prefix. AbstractManager performs no validation.

Specified by:

createSystemName in interface SensorManager

Overrides:

createSystemName in class AbstractSensorManager

Parameters:

curAddress - hardware address, no system prefix or type letter.

prefix - - just system prefix, not including Type Letter.

Returns:

full system name with system prefix, type letter and hardware address.

Throws:

JmriException - if unable to create a system name.

getNextValidSystemName

@Nonnull
@CheckReturnValue
public String getNextValidSystemName(@Nonnull
 NamedBean currentBean)
                              throws JmriException

Description copied from interface: NameIncrementingManager

Get the next valid NamedBean system name.

For example, if the system name of the provided NamedBean is IS10, the next valid name is IS11.

This should not be called if NameIncrementingManager.allowMultipleAdditions(java.lang.String) returns false.

Pays no attention to whether the next NamedBean already exists or not, just works out the name. Nor is there any guarantee that the return value can actually be created: a provide() call on the return value can still perhaps fail in some circumstances.

In some cases, there is no clear next address. In that case, a JmriException is thrown. For example, some systems have no concept of a "next" address; Internal sensors don't necessarily have numeric suffixes; etc.

Default implementation works for names of the form (prefix)(type letter)(numeric string) by incrementing the numeric string as needed.

Specified by:

getNextValidSystemName in interface NameIncrementingManager

Parameters:

currentBean - The NamedBean who's system name that provides the base for "next"

Returns:

The next valid system name

Throws:

JmriException - If unable to create a valid next address

getEntryToolTip

public String getEntryToolTip()

Provide a manager-specific tooltip for the Add new item beantable pane.

Specified by:

getEntryToolTip in interface Manager<Sensor>

Specified by:

getEntryToolTip in interface SensorManager

Overrides:

getEntryToolTip in class AbstractSensorManager

Returns:

the tool tip or null to disable the tool tip

reply

public void reply(CanReply l)

Description copied from interface: CanListener

Called when an incoming CanFrame is received from the CAN Network.

Specified by:

reply in interface CanListener

Parameters:

l - the CanReply being received.

message

public void message(CanMessage l)

Description copied from interface: CanListener

Called when an outgoing message is sent to the CAN Network.

Specified by:

message in interface CanListener

Parameters:

l - the CanMessage being sent.

validateSystemNameFormat

@Nonnull
public String validateSystemNameFormat(@Nonnull
 String name,
 @Nonnull
 Locale locale)
                                throws NamedBean.BadSystemNameException

Validates to OpenLCB format. Validate the format of name, returning it unchanged if valid.

Although further restrictions may be added by system-specific implementations, at a minimum, the implementation must consider a name that does not start with the System Name prefix for this manager to be invalid, and must consider a name that is the same as the System Name prefix to be invalid.

Overriding implementations may rely on Manager.validSystemNameFormat(java.lang.String), however they must provide an actionable message in the thrown exception if that method does not return Manager.NameValidity.VALID. When overriding implementations of this method rely on validSystemNameFormat(), implementations of that method must not throw an exception, log an error, or otherwise disrupt the user.

Specified by:

validateSystemNameFormat in interface Manager<Sensor>

Parameters:

name - the system name to validate

locale - the locale for a localized exception; this is needed for the JMRI web server, which supports multiple locales

Returns:

the unchanged value of the name parameter

Throws:

NamedBean.BadSystemNameException - if provided name is an invalid format