Package jmri.jmrit.logixng.implementation

Class DefaultMaleDigitalExpressionSocket

java.lang.Object

jmri.jmrit.logixng.implementation.AbstractMaleSocket

jmri.jmrit.logixng.implementation.DefaultMaleDigitalExpressionSocket

All Implemented Interfaces:

java.lang.Comparable<NamedBean>, PropertyChangeProvider, Base, Debugable, DigitalExpression, DigitalExpressionBean, MaleDigitalExpressionSocket, MaleSocket, NamedBean

public class DefaultMaleDigitalExpressionSocket
extends AbstractMaleSocket
implements MaleDigitalExpressionSocket

Every DigitalExpressionBean has an DefaultMaleDigitalExpressionSocket as its parent.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DefaultMaleDigitalExpressionSocket.DigitalExpressionDebugConfig

Nested classes/interfaces inherited from interface jmri.jmrit.logixng.Base

Base.PrintTreeSettings, Base.RunnableWithBase, Base.RunnableWithBaseThrowException

Nested classes/interfaces inherited from interface jmri.jmrit.logixng.Debugable

Debugable.DebugConfig

Nested classes/interfaces inherited from interface jmri.jmrit.logixng.MaleSocket

MaleSocket.ErrorHandlingType

Nested classes/interfaces inherited from interface jmri.NamedBean

NamedBean.BadNameException, NamedBean.BadSystemNameException, NamedBean.BadUserNameException, NamedBean.DisplayOptions, NamedBean.DuplicateSystemNameException

Field Summary

Fields inherited from class jmri.jmrit.logixng.implementation.AbstractMaleSocket

_localVariables

Fields inherited from interface jmri.jmrit.logixng.Base

PRINT_LINE_NUMBERS_FORMAT, PROPERTY_CHILD_COUNT, PROPERTY_CHILD_REORDER, PROPERTY_LAST_RESULT_CHANGED, PROPERTY_SOCKET_CONNECTED, PROPERTY_SOCKET_DISCONNECTED, SEPARATOR, SOCKET_CONNECTED, SOCKET_DISCONNECTED

Fields inherited from interface jmri.jmrit.logixng.DigitalExpressionBean

FALSE, TRUE

Fields inherited from interface jmri.NamedBean

DISPLAY_NAME_FORMAT, INCONSISTENT, PROPERTY_COMMENT, PROPERTY_ENABLED, PROPERTY_KNOWN_STATE, PROPERTY_STATE, PROPERTY_USERNAME, QUOTED_NAME_FORMAT, UNKNOWN

Constructor Summary

Constructors

Constructor	Description
DefaultMaleDigitalExpressionSocket(BaseManager<? extends NamedBean> manager, DigitalExpressionBean expression)

Method Summary

Modifier and Type	Method	Description
int	compareSystemNameSuffix(java.lang.String suffix1, java.lang.String suffix2, NamedBean n2)	Compare the suffix of this NamedBean's name with the suffix of the argument NamedBean's name for the NamedBean.compareTo(jmri.NamedBean) operation.
Debugable.DebugConfig	createDebugConfig()	Create a debug configuration for this male socket.
java.lang.String	describeState(int state)	Provide human-readable, localized version of state value.
void	disposeMe()	Disposes this object.
boolean	evaluate()	Evaluate this expression.
java.lang.String	getBeanType()	For instances in the code where we are dealing with just a bean and a message needs to be passed to the user or in a log.
Debugable.DebugConfig	getDebugConfig()	Get the debug configuration for this male socket.
java.lang.String	getDisplayName()	Get user name if it exists, otherwise return System name.
boolean	getLastResult()	Get the last result of the evaluation.
java.lang.Object	getProperty(java.lang.String key)	Retrieve the value associated with a key.
java.util.Set<java.lang.String>	getPropertyKeys()	Retrieve the complete current set of keys.
int	getState()	Provide generic access to internal state.
boolean	isEnabled()	Determines whether this male socket is enabled.
void	notifyChangedResult(boolean oldResult, boolean newResult)	Notify property change listeners that the result of the expression has changed.
void	registerListenersForThisClass()	Register listeners if this object needs that.
void	removeProperty(java.lang.String key)	Remove the key/value pair against the NamedBean.
void	setDebugConfig(Debugable.DebugConfig config)	Set the debug configuration for this male socket.
void	setEnabled(boolean enable)	Set whenether this male socket is enabled or disabled.
void	setEnabledFlag(boolean enable)	Set whenether this male socket is enabled or disabled, without activating the male socket.
void	setProperty(java.lang.String key, java.lang.Object value)	Attach a key/value pair to the NamedBean, which can be retrieved later.
void	setState(int s)	Provide generic access to internal state.
void	unregisterListenersForThisClass()	Register listeners if this object needs that.

Methods inherited from class jmri.jmrit.logixng.implementation.AbstractMaleSocket

addLocalVariable, addLocalVariable, addPropertyChangeListener, addPropertyChangeListener, addPropertyChangeListener, addPropertyChangeListener, clearLocalVariables, deepCopyChildren, dispose, executeErrorHandlingModule, getCatchAbortExecution, getCategory, getChild, getChildCount, getComment, getConditionalNG, getDeepCopy, getErrorHandlingModuleSocket, getErrorHandlingType, getListen, getListenerRef, getListenerRefs, getListenerRefsIncludingChildren, getLocalVariables, getLogixNG, getLongDescription, getManager, getNumPropertyChangeListeners, getObject, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getPropertyChangeListenersByReference, getRoot, getShortDescription, getSystemName, getUsageDetail, getUsageTree, getUserName, handleError, handleError, handleError, hasChild, isActive, isErrorHandlingModuleEnabled, isLocked, isSystem, printLocalVariable, printTree, printTree, printTree, printTreeRow, registerListeners, removePropertyChangeListener, removePropertyChangeListener, setCatchAbortExecution, setComment, setErrorHandlingType, setListen, setLocked, setParent, setParentForAllChildren, setSystem, setUserName, toString, unregisterListeners, updateListenerRef, vetoableChange

Methods inherited from class java.lang.Object

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

Methods inherited from interface jmri.jmrit.logixng.Base

addPropertyChangeListener, addPropertyChangeListener, deepCopyChildren, dispose, doSocketOperation, existsInTree, forEntireTree, forEntireTreeWithException, getCategory, getChild, getChildCount, getComment, getConditionalNG, getDeepCopy, getListenerRef, getListenerRefs, getListenerRefsIncludingChildren, getLogixNG, getLongDescription, getLongDescription, getModule, getNumPropertyChangeListeners, getParent, getPropertyChangeListenersByReference, getRoot, getShortDescription, getShortDescription, getSystemName, getUsageDetail, getUsageTree, getUserName, hasChild, isActive, isSocketOperationAllowed, printTree, printTree, printTree, printTree, printTree, registerListeners, setComment, setParent, setParentForAllChildren, setUserName, unregisterListeners, updateListenerRef, vetoableChange

Methods inherited from interface jmri.jmrit.logixng.MaleSocket

addLocalVariable, addLocalVariable, clearLocalVariables, find, getCatchAbortExecution, getErrorHandlingType, getListen, getLocalVariables, getManager, getObject, handleError, handleError, handleError, isLocked, isSupportingLocalVariables, isSystem, setCatchAbortExecution, setErrorHandlingType, setListen, setLocked, setSystem, setup

Methods inherited from interface jmri.NamedBean

addPropertyChangeListener, addPropertyChangeListener, compareTo, dispose, getComment, getDisplayName, getListenerRef, getListenerRefs, getNumPropertyChangeListeners, getPropertyChangeListenersByReference, getRecommendedToolTip, getSystemName, getUsageReport, getUserName, setComment, setUserName, toString, updateListenerRef, vetoableChange

Methods inherited from interface jmri.beans.PropertyChangeProvider

addPropertyChangeListener, addPropertyChangeListener, getPropertyChangeListeners, getPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener

Constructor Detail

DefaultMaleDigitalExpressionSocket

public DefaultMaleDigitalExpressionSocket(@Nonnull
                                          BaseManager<? extends NamedBean> manager,
                                          @Nonnull
                                          DigitalExpressionBean expression)

Method Detail

notifyChangedResult

public void notifyChangedResult(boolean oldResult,
                                boolean newResult)

Notify property change listeners that the result of the expression has changed.

Specified by:

notifyChangedResult in interface DigitalExpressionBean

Parameters:

oldResult - the old last result

newResult - the new last result

evaluate

public boolean evaluate()
                 throws JmriException

Evaluate this expression.

This method must ensure that the value is not a Double.NaN, negative infinity or positive infinity. If that is the case, it must throw an IllegalArgumentException before checking if an error has occured.

Specified by:

evaluate in interface DigitalExpression

Specified by:

evaluate in interface MaleDigitalExpressionSocket

Returns:

the result of the evaluation

Throws:

JmriException - when an exception occurs

getLastResult

public boolean getLastResult()

Description copied from interface: MaleDigitalExpressionSocket

Get the last result of the evaluation.

Specified by:

getLastResult in interface MaleDigitalExpressionSocket

Returns:

the last result

getState

public int getState()

Description copied from interface: NamedBean

Provide generic access to internal state.

This generally shouldn't be used by Java code; use the class-specific form instead (e.g. getCommandedState in Turnout). This is provided to make scripts easier to read.

Specified by:

getState in interface NamedBean

Returns:

the state

setState

public void setState(int s)
              throws JmriException

Description copied from interface: NamedBean

Provide generic access to internal state.

This generally shouldn't be used by Java code; use the class-specific form instead (e.g. setCommandedState in Turnout). This is provided to make scripts access easier to read.

Specified by:

setState in interface NamedBean

Parameters:

s - the state

Throws:

JmriException - general error when setting the state fails

describeState

public java.lang.String describeState(int state)

Description copied from interface: NamedBean

Provide human-readable, localized version of state value.

This method is intended for use when presenting to a human operator.

Specified by:

describeState in interface NamedBean

Parameters:

state - the state to describe

Returns:

the state in localized form

setProperty

public void setProperty(java.lang.String key,
                        java.lang.Object value)

Description copied from interface: NamedBean

Attach a key/value pair to the NamedBean, which can be retrieved later. These are not bound properties as yet, and don't throw events on modification. Key must not be null.

The key is constrained to String to make these behave like normal Java Beans.

Specified by:

setProperty in interface NamedBean

Parameters:

key - the property to set

value - the value of the property

getProperty

public java.lang.Object getProperty(java.lang.String key)

Description copied from interface: NamedBean

Retrieve the value associated with a key. If no value has been set for that key, returns null.

Specified by:

getProperty in interface NamedBean

Parameters:

key - the property to get

Returns:

The value of the property or null.

removeProperty

public void removeProperty(java.lang.String key)

Description copied from interface: NamedBean

Remove the key/value pair against the NamedBean.

Specified by:

removeProperty in interface NamedBean

Parameters:

key - the property to remove

getPropertyKeys

public java.util.Set<java.lang.String> getPropertyKeys()

Description copied from interface: NamedBean

Retrieve the complete current set of keys.

Specified by:

getPropertyKeys in interface NamedBean

Returns:

empty set if none

getBeanType

public java.lang.String getBeanType()

Description copied from interface: NamedBean

For instances in the code where we are dealing with just a bean and a message needs to be passed to the user or in a log.

Specified by:

getBeanType in interface NamedBean

Returns:

a string of the bean type, eg Turnout, Sensor etc

compareSystemNameSuffix

public int compareSystemNameSuffix(java.lang.String suffix1,
                                   java.lang.String suffix2,
                                   NamedBean n2)

Description copied from interface: NamedBean

Compare the suffix of this NamedBean's name with the suffix of the argument NamedBean's name for the NamedBean.compareTo(jmri.NamedBean) operation. This is intended to be a system-specific comparison that understands the various formats, etc.

Specified by:

compareSystemNameSuffix in interface NamedBean

Parameters:

suffix1 - The suffix for the 1st bean in the comparison

suffix2 - The suffix for the 2nd bean in the comparison

n2 - The other (second) NamedBean in the comparison

Returns:

-1,0,+1 for ordering if the names are well-formed; may not provide proper ordering if the names are not well-formed.

setDebugConfig

public void setDebugConfig(Debugable.DebugConfig config)

Set the debug configuration for this male socket.

Each implementation of MaleSocket has their own implementation of DebugConfig. Use reflection to get the proper class <package-name>.debug.<ClassName>Debug that returns a JPanel that can configure debugging for this male socket.

Specified by:

setDebugConfig in interface Debugable

Parameters:

config - the new configuration or null to turn off debugging

getDebugConfig

public Debugable.DebugConfig getDebugConfig()

Get the debug configuration for this male socket.

Specified by:

getDebugConfig in interface Debugable

Returns:

the configuration or null if debugging is turned off for this male socket

createDebugConfig

public Debugable.DebugConfig createDebugConfig()

Create a debug configuration for this male socket.

Specified by:

createDebugConfig in interface Debugable

Returns:

the new configuration

setEnabled

public void setEnabled(boolean enable)

Set whenether this male socket is enabled or disabled.

This method must call registerListeners() / unregisterListeners().

Specified by:

setEnabled in interface MaleSocket

Parameters:

enable - true if this male socket should be enabled, false otherwise

setEnabledFlag

public void setEnabledFlag(boolean enable)

Set whenether this male socket is enabled or disabled, without activating the male socket. This is used when loading the xml file and when copying an item.

This method must call registerListeners() / unregisterListeners().

Specified by:

setEnabledFlag in interface MaleSocket

Parameters:

enable - true if this male socket should be enabled, false otherwise

isEnabled

public boolean isEnabled()

Determines whether this male socket is enabled.

Specified by:

isEnabled in interface Base

Specified by:

isEnabled in interface MaleSocket

Returns:

true if the male socket is enabled, false otherwise

disposeMe

public void disposeMe()

Description copied from class: AbstractMaleSocket

Disposes this object. This must remove _all_ connections!

Specified by:

disposeMe in class AbstractMaleSocket

registerListenersForThisClass

public void registerListenersForThisClass()

Register listeners if this object needs that.

Specified by:

registerListenersForThisClass in class AbstractMaleSocket

unregisterListenersForThisClass

public void unregisterListenersForThisClass()

Register listeners if this object needs that.

Specified by:

unregisterListenersForThisClass in class AbstractMaleSocket

getDisplayName

public java.lang.String getDisplayName()

Description copied from interface: NamedBean

Get user name if it exists, otherwise return System name.

Specified by:

getDisplayName in interface NamedBean

Returns:

the user name or system-specific name