jmri
Class DefaultConditionalManager

java.lang.Object
  jmri.AbstractManager
      jmri.DefaultConditionalManager

All Implemented Interfaces:

PropertyChangeListener, EventListener, ConditionalManager, Manager

public class DefaultConditionalManager
extends AbstractManager
implements ConditionalManager, PropertyChangeListener

Basic Implementation of a ConditionalManager.

Note that Conditionals always have an associated parent Logix.

Logix system names must begin with IX, and be followed by a string, usually, but not always, a number. The system names of Conditionals always begin with the parent Logix's system name, then there is a capital C and a number.

Conditional system names are set automatically when the Conditional is created. All alphabetic characters in a Conditional system name must be upper case. This is enforced when a new Conditional is created via LogixTableAction.java.

Author:

Dave Duchamp Copyright (C) 2007

Field Summary

Fields inherited from class jmri.AbstractManager

_tsys, _tuser

Constructor Summary

DefaultConditionalManager()

Method Summary

Conditional	createNewConditional(String systemName, String userName) Method to create a new Conditional if the Conditional does not exist Returns null if a Conditional with the same systemName or userName already exists, or if there is trouble creating a new Conditional If the parent Logix cannot be found, the userName cannot be checked, but the Conditional is still created.
void	deleteConditional(Conditional c) Remove an existing Conditional.
Conditional	getBySystemName(String name)
Conditional	getByUserName(Logix x, String key)
Conditional	getConditional(Logix x, String name) Method to get an existing Conditional.
Logix	getParentLogix(String name) Parses the Conditional system name to get the parent Logix system name, then gets the parent Logix, and returns it.
List	getSystemNameListForLogix(Logix x) Get a list of all Conditional system names with the specified Logix parent
static DefaultConditionalManager	instance()
char	systemLetter()
char	typeLetter()

Methods inherited from class jmri.AbstractManager

addPropertyChangeListener, deregister, dispose, firePropertyChange, getInstanceBySystemName, getInstanceByUserName, getSystemNameList, makeSystemName, propertyChange, register, removePropertyChangeListener

Methods inherited from class java.lang.Object

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

Methods inherited from interface jmri.ConditionalManager

dispose

Methods inherited from interface jmri.Manager

addPropertyChangeListener, deregister, getSystemNameList, makeSystemName, register, removePropertyChangeListener

Methods inherited from interface java.beans.PropertyChangeListener

propertyChange

Constructor Detail

DefaultConditionalManager

public DefaultConditionalManager()

Method Detail

systemLetter

public char systemLetter()

Specified by:

systemLetter in interface Manager

Returns:

The system-specific prefix letter for a specific implementation

typeLetter

public char typeLetter()

Specified by:

typeLetter in interface Manager

Returns:

The type letter for a specific implementation

createNewConditional

public Conditional createNewConditional(String systemName,
                                        String userName)

Method to create a new Conditional if the Conditional does not exist Returns null if a Conditional with the same systemName or userName already exists, or if there is trouble creating a new Conditional If the parent Logix cannot be found, the userName cannot be checked, but the Conditional is still created. The scenario can happen when a Logix is loaded from a file after its Conditionals.

Specified by:

createNewConditional in interface ConditionalManager

getParentLogix

public Logix getParentLogix(String name)

Parses the Conditional system name to get the parent Logix system name, then gets the parent Logix, and returns it.

Specified by:

getParentLogix in interface ConditionalManager

Parameters:

name - - system name of Conditional (must be trimmed and upper case)

deleteConditional

public void deleteConditional(Conditional c)

Remove an existing Conditional. Parent Logix must have been deactivated before invoking this.

Specified by:

deleteConditional in interface ConditionalManager

getConditional

public Conditional getConditional(Logix x,
                                  String name)

Method to get an existing Conditional. First looks up assuming that name is a User Name. Note: the parent Logix must be passed in x for user name lookup. If this fails, or if x == null, looks up assuming that name is a System Name. If both fail, returns null.

Specified by:

getConditional in interface ConditionalManager

Parameters:

x - - parent Logix (may be null)

name - - name to look up

Returns:

null if no match found

getByUserName

public Conditional getByUserName(Logix x,
                                 String key)

Specified by:

getByUserName in interface ConditionalManager

getBySystemName

public Conditional getBySystemName(String name)

Specified by:

getBySystemName in interface ConditionalManager

getSystemNameListForLogix

public List getSystemNameListForLogix(Logix x)

Get a list of all Conditional system names with the specified Logix parent

Specified by:

getSystemNameListForLogix in interface ConditionalManager

instance

public static DefaultConditionalManager instance()