Package jmri.jmrit.logixng.actions
Class Sequence
- java.lang.Object
-
- jmri.implementation.AbstractNamedBean
-
- jmri.jmrit.logixng.implementation.AbstractBase
-
- jmri.jmrit.logixng.actions.AbstractDigitalAction
-
- jmri.jmrit.logixng.actions.Sequence
-
- All Implemented Interfaces:
java.lang.Comparable<NamedBean>
,PropertyChangeProvider
,Base
,DigitalAction
,DigitalActionBean
,FemaleSocketListener
,NamedBean
public class Sequence extends AbstractDigitalAction implements FemaleSocketListener
Executes actions in a sequence.
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface jmri.jmrit.logixng.Base
Base.PrintTreeSettings, Base.RunnableWithBase, Base.RunnableWithBaseThrowException
-
Nested classes/interfaces inherited from interface jmri.NamedBean
NamedBean.BadNameException, NamedBean.BadSystemNameException, NamedBean.BadUserNameException, NamedBean.DisplayOptions, NamedBean.DuplicateSystemNameException
-
-
Field Summary
Fields Modifier and Type Field Description static int
EXPRESSION_RESET
static int
EXPRESSION_START
static int
EXPRESSION_STOP
static int
NUM_STATIC_EXPRESSIONS
-
Fields inherited from class jmri.jmrit.logixng.implementation.AbstractBase
_listenersAreRegistered
-
Fields inherited from class jmri.implementation.AbstractNamedBean
listenerRefs, mSystemName, register
-
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.NamedBean
DISPLAY_NAME_FORMAT, INCONSISTENT, PROPERTY_STATE, QUOTED_NAME_FORMAT, UNKNOWN
-
-
Constructor Summary
Constructors Constructor Description Sequence(java.lang.String sys, java.lang.String user)
Sequence(java.lang.String sys, java.lang.String user, java.util.List<java.util.Map.Entry<java.lang.String,java.lang.String>> expressionSystemNames, java.util.List<java.util.Map.Entry<java.lang.String,java.lang.String>> actionSystemNames)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
connected(FemaleSocket socket)
The socket is connected.void
disconnected(FemaleSocket socket)
The socket is disconnected.void
disposeMe()
Dispose this class.void
doSocketOperation(int index, FemaleSocketOperation oper)
Do an operation on a childvoid
execute()
Execute this DigitalActionBean.FemaleDigitalActionSocket
getActionSocket(int socket)
java.lang.String
getActionSocketSystemName(int socket)
Category
getCategory()
Get the category.FemaleSocket
getChild(int index)
Get a child of this itemint
getChildCount()
Get the number of children.Base
getDeepCopy(java.util.Map<java.lang.String,java.lang.String> systemNames, java.util.Map<java.lang.String,java.lang.String> userNames)
Create a deep copy of myself and my children The item needs to try to lookup itself in both systemNames and userNames to see if the user has given a new system name and/or a new user name.If no new system name is given, an auto system name is used.FemaleDigitalExpressionSocket
getExpressionSocket(int socket)
java.lang.String
getExpressionSocketSystemName(int socket)
java.lang.String
getLongDescription(java.util.Locale locale)
Get a long description of this item.java.lang.String
getNewActionSocketName()
java.lang.String
getNewExpressionSocketName()
int
getNumActions()
int
getNumExpressions()
FemaleDigitalExpressionSocket
getResetExpressionSocket()
java.lang.String
getResetExpressionSocketSystemName()
boolean
getRunContinuously()
Get if run continuouslyjava.lang.String
getShortDescription(java.util.Locale locale)
Get a short description of this item.FemaleDigitalExpressionSocket
getStartExpressionSocket()
java.lang.String
getStartExpressionSocketSystemName()
boolean
getStartImmediately()
Get if to start immediatelyFemaleDigitalExpressionSocket
getStopExpressionSocket()
java.lang.String
getStopExpressionSocketSystemName()
boolean
isSocketOperationAllowed(int index, FemaleSocketOperation oper)
Is the operation allowed on this child?void
registerListenersForThisClass()
Register listeners if this object needs that.void
setActionSocketSystemName(int socket, java.lang.String systemName)
void
setExpressionSocketSystemName(int socket, java.lang.String systemName)
void
setResetExpressionSocketSystemName(java.lang.String systemName)
void
setRunContinuously(boolean runContinuously)
Set if run continuouslyvoid
setStartExpressionSocketSystemName(java.lang.String systemName)
void
setStartImmediately(boolean startImmediately)
Set if to start immediatelyvoid
setStopExpressionSocketSystemName(java.lang.String systemName)
void
setup()
Setup this object and its children.void
unregisterListenersForThisClass()
Unregister listeners if this object needs that.-
Methods inherited from class jmri.jmrit.logixng.actions.AbstractDigitalAction
getBeanType, getNewSocketName, getNewSocketName, getParent, getPreferredSocketPrefix, getState, setParent, setState
-
Methods inherited from class jmri.jmrit.logixng.implementation.AbstractBase
assertListenersAreNotRegistered, compareSystemNameSuffix, deepCopyChildren, dispose, getConditionalNG, getListenerRefsIncludingChildren, getLogixNG, getRoot, getUsageDetail, getUsageTree, isActive, printTree, printTree, printTree, printTreeRow, registerListeners, setParentForAllChildren, unregisterListeners
-
Methods inherited from class jmri.implementation.AbstractNamedBean
addPropertyChangeListener, addPropertyChangeListener, addPropertyChangeListener, addPropertyChangeListener, describeState, equals, firePropertyChange, getComment, getDisplayName, getDisplayName, getListenerRef, getListenerRefs, getNumPropertyChangeListeners, getProperty, getPropertyChangeListeners, getPropertyChangeListeners, getPropertyChangeListenersByReference, getPropertyKeys, getSystemName, getUserName, hashCode, removeProperty, removePropertyChangeListener, removePropertyChangeListener, setComment, setProperty, setUserName, toString, toStringSuffix, updateListenerRef, vetoableChange
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface jmri.jmrit.logixng.Base
addPropertyChangeListener, addPropertyChangeListener, deepCopyChildren, dispose, existsInTree, forEntireTree, forEntireTreeWithException, getComment, getConditionalNG, getListenerRef, getListenerRefs, getListenerRefsIncludingChildren, getLogixNG, getLongDescription, getModule, getNumPropertyChangeListeners, getPropertyChangeListenersByReference, getRoot, getShortDescription, getSystemName, getUsageDetail, getUsageTree, getUserName, hasChild, isActive, isEnabled, printTree, printTree, printTree, printTree, printTree, registerListeners, setComment, setParentForAllChildren, setUserName, unregisterListeners, updateListenerRef, vetoableChange
-
Methods inherited from interface jmri.jmrit.logixng.FemaleSocketListener
socketNameChanged
-
Methods inherited from interface jmri.NamedBean
addPropertyChangeListener, addPropertyChangeListener, compareSystemNameSuffix, compareTo, describeState, dispose, getComment, getDisplayName, getDisplayName, getListenerRef, getListenerRefs, getNumPropertyChangeListeners, getProperty, getPropertyChangeListenersByReference, getPropertyKeys, getSystemName, getUsageReport, getUserName, removeProperty, setComment, setProperty, setUserName, toString, updateListenerRef, vetoableChange
-
Methods inherited from interface jmri.beans.PropertyChangeProvider
addPropertyChangeListener, addPropertyChangeListener, getPropertyChangeListeners, getPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener
-
-
-
-
Field Detail
-
EXPRESSION_START
public static final int EXPRESSION_START
- See Also:
- Constant Field Values
-
EXPRESSION_STOP
public static final int EXPRESSION_STOP
- See Also:
- Constant Field Values
-
EXPRESSION_RESET
public static final int EXPRESSION_RESET
- See Also:
- Constant Field Values
-
NUM_STATIC_EXPRESSIONS
public static final int NUM_STATIC_EXPRESSIONS
- See Also:
- Constant Field Values
-
-
Constructor Detail
-
Sequence
public Sequence(java.lang.String sys, java.lang.String user)
-
Sequence
public Sequence(java.lang.String sys, java.lang.String user, java.util.List<java.util.Map.Entry<java.lang.String,java.lang.String>> expressionSystemNames, java.util.List<java.util.Map.Entry<java.lang.String,java.lang.String>> actionSystemNames) throws NamedBean.BadUserNameException, NamedBean.BadSystemNameException
-
-
Method Detail
-
getNewActionSocketName
public java.lang.String getNewActionSocketName()
-
getNewExpressionSocketName
public java.lang.String getNewExpressionSocketName()
-
getDeepCopy
public Base getDeepCopy(java.util.Map<java.lang.String,java.lang.String> systemNames, java.util.Map<java.lang.String,java.lang.String> userNames) throws JmriException
Description copied from interface:Base
Create a deep copy of myself and my children The item needs to try to lookup itself in both systemNames and userNames to see if the user has given a new system name and/or a new user name.If no new system name is given, an auto system name is used. If no user name is given, a null user name is used.- Specified by:
getDeepCopy
in interfaceBase
- Parameters:
systemNames
- a map of old and new system nameuserNames
- a map of old system name and new user name- Returns:
- a deep copy
- Throws:
JmriException
- in case of an error
-
getCategory
public Category getCategory()
Get the category.- Specified by:
getCategory
in interfaceBase
- Overrides:
getCategory
in classAbstractBase
- Returns:
- the category
-
execute
public void execute() throws JmriException
Execute this DigitalActionBean.- Specified by:
execute
in interfaceDigitalAction
- Throws:
JmriException
- when an exception occurs
-
getStartImmediately
public boolean getStartImmediately()
Get if to start immediately- Returns:
- true if to start immediately
-
setStartImmediately
public void setStartImmediately(boolean startImmediately)
Set if to start immediately- Parameters:
startImmediately
- true if to start immediately
-
getRunContinuously
public boolean getRunContinuously()
Get if run continuously- Returns:
- true if run continuously
-
setRunContinuously
public void setRunContinuously(boolean runContinuously)
Set if run continuously- Parameters:
runContinuously
- true if run continuously
-
getChild
public FemaleSocket getChild(int index) throws java.lang.IllegalArgumentException, java.lang.UnsupportedOperationException
Description copied from class:AbstractBase
Get a child of this item- Specified by:
getChild
in interfaceBase
- Overrides:
getChild
in classAbstractBase
- Parameters:
index
- the index of the child to get- Returns:
- the child
- Throws:
java.lang.IllegalArgumentException
- if the index is less than 0 or greater or equal with the value returned by getChildCount()java.lang.UnsupportedOperationException
-
getChildCount
public int getChildCount()
Description copied from class:AbstractBase
Get the number of children.- Specified by:
getChildCount
in interfaceBase
- Overrides:
getChildCount
in classAbstractBase
- Returns:
- the number of children
-
isSocketOperationAllowed
public boolean isSocketOperationAllowed(int index, FemaleSocketOperation oper)
Is the operation allowed on this child?- Specified by:
isSocketOperationAllowed
in interfaceBase
- Parameters:
index
- the index of the child to do the operation onoper
- the operation to do- Returns:
- true if operation is allowed, false otherwise
-
doSocketOperation
public void doSocketOperation(int index, FemaleSocketOperation oper)
Do an operation on a child- Specified by:
doSocketOperation
in interfaceBase
- Parameters:
index
- the index of the child to do the operation onoper
- the operation to do
-
connected
public void connected(FemaleSocket socket)
Description copied from interface:FemaleSocketListener
The socket is connected.- Specified by:
connected
in interfaceFemaleSocketListener
- Parameters:
socket
- the socket
-
disconnected
public void disconnected(FemaleSocket socket)
Description copied from interface:FemaleSocketListener
The socket is disconnected.- Specified by:
disconnected
in interfaceFemaleSocketListener
- Parameters:
socket
- the socket
-
getShortDescription
public java.lang.String getShortDescription(java.util.Locale locale)
Description copied from interface:Base
Get a short description of this item.- Specified by:
getShortDescription
in interfaceBase
- Parameters:
locale
- The locale to be used- Returns:
- a short description
-
getLongDescription
public java.lang.String getLongDescription(java.util.Locale locale)
Description copied from interface:Base
Get a long description of this item.- Specified by:
getLongDescription
in interfaceBase
- Parameters:
locale
- The locale to be used- Returns:
- a long description
-
getStartExpressionSocket
public FemaleDigitalExpressionSocket getStartExpressionSocket()
-
getStartExpressionSocketSystemName
public java.lang.String getStartExpressionSocketSystemName()
-
setStartExpressionSocketSystemName
public void setStartExpressionSocketSystemName(java.lang.String systemName)
-
getStopExpressionSocket
public FemaleDigitalExpressionSocket getStopExpressionSocket()
-
getStopExpressionSocketSystemName
public java.lang.String getStopExpressionSocketSystemName()
-
setStopExpressionSocketSystemName
public void setStopExpressionSocketSystemName(java.lang.String systemName)
-
getResetExpressionSocket
public FemaleDigitalExpressionSocket getResetExpressionSocket()
-
getResetExpressionSocketSystemName
public java.lang.String getResetExpressionSocketSystemName()
-
setResetExpressionSocketSystemName
public void setResetExpressionSocketSystemName(java.lang.String systemName)
-
getNumExpressions
public int getNumExpressions()
-
getExpressionSocket
public FemaleDigitalExpressionSocket getExpressionSocket(int socket)
-
getExpressionSocketSystemName
public java.lang.String getExpressionSocketSystemName(int socket)
-
setExpressionSocketSystemName
public void setExpressionSocketSystemName(int socket, java.lang.String systemName)
-
getNumActions
public int getNumActions()
-
getActionSocket
public FemaleDigitalActionSocket getActionSocket(int socket)
-
getActionSocketSystemName
public java.lang.String getActionSocketSystemName(int socket)
-
setActionSocketSystemName
public void setActionSocketSystemName(int socket, java.lang.String systemName)
-
setup
public void setup()
Setup this object and its children. This method is used to lookup system names for child sockets, turnouts, sensors, and so on.
-
registerListenersForThisClass
public void registerListenersForThisClass()
Register listeners if this object needs that.Important: This method may be called more than once. Methods overriding this method must ensure that listeners are not registered more than once.
- Overrides:
registerListenersForThisClass
in classAbstractBase
-
unregisterListenersForThisClass
public void unregisterListenersForThisClass()
Unregister listeners if this object needs that.Important: This method may be called more than once. Methods overriding this method must ensure that listeners are not unregistered more than once.
- Overrides:
unregisterListenersForThisClass
in classAbstractBase
-
disposeMe
public void disposeMe()
Dispose this class. Listeners do not need to be unregistered by this method since they are unregistered by dispose().- Overrides:
disposeMe
in classAbstractBase
-
-