Package jmri.jmrix.dcc4pc

Class Dcc4PcProgrammerManager

java.lang.Object

jmri.beans.PropertyChangeSupport

jmri.managers.DefaultProgrammerManager

jmri.jmrix.dcc4pc.Dcc4PcProgrammerManager

All Implemented Interfaces:

AddressedProgrammerManager, PropertyChangeFirer, PropertyChangeProvider, GlobalProgrammerManager

public class Dcc4PcProgrammerManager
extends DefaultProgrammerManager

DCC4PC Programmer acts as a proxy for ops mode programming. Extend DefaultProgrammerManager to provide ops mode programmers on XpressNet

See Also:

• DefaultProgrammerManager

Field Summary

Fields inherited from class jmri.beans.PropertyChangeSupport

propertyChangeSupport

Constructor Summary

Constructors

Constructor	Description
Dcc4PcProgrammerManager(T manager)

Method Summary

Modifier and Type	Method	Description
protected AddressedProgrammer	getConcreteAddressedProgrammer(boolean pLongAddress, int pAddress)	Gain access to a Addressed Mode Programmer without reservation.
protected Programmer	getConcreteGlobalProgrammer()	Gain access to the Global Mode Programmer without reservation.
String	getUserName()	Provides the human-readable representation for including ProgrammerManagers directly in user interface components, so it should return a user-provided name for this particular one.
boolean	isAddressedModePossible()	XpressNet command station does provide Ops Mode We should make this return false based on what command station we're using but for now, we'll return true
boolean	isGlobalProgrammerAvailable()	Convenience method to check whether you'll be able to get a Global Mode programmer.
void	releaseAddressedProgrammer(AddressedProgrammer p)	Return access to an Addressed Mode Programmer, so that it can be used elsewhere.
void	releaseGlobalProgrammer(Programmer p)	Return access to the Global Mode Programmer, so that it can be used elsewhere.
protected AddressedProgrammer	reserveConcreteAddressedProgrammer(boolean pLongAddress, int pAddress)	Gain access to a (the) Addressed Mode Programmer, in the process reserving it for yourself.
protected Programmer	reserveConcreteGlobalProgrammer()	Gain access to the Global Mode Programmer, in the process reserving it for yourself.

Methods inherited from class jmri.managers.DefaultProgrammerManager

dispose, getAddressedProgrammer, getDefaultModes, getGlobalProgrammer, isAddressedModePossible, reserveAddressedProgrammer, reserveGlobalProgrammer, toString

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, wait, wait, wait

Methods inherited from interface jmri.AddressedProgrammerManager

getAddressedProgrammer, reserveAddressedProgrammer

Methods inherited from interface jmri.beans.PropertyChangeProvider

addPropertyChangeListener, addPropertyChangeListener, getPropertyChangeListeners, getPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener

Constructor Details

Dcc4PcProgrammerManager

public Dcc4PcProgrammerManager(@Nonnull
 T manager)

Method Details

getConcreteGlobalProgrammer

protected Programmer getConcreteGlobalProgrammer()

Description copied from class: DefaultProgrammerManager

Gain access to the Global Mode Programmer without reservation.

Overrides:

getConcreteGlobalProgrammer in class DefaultProgrammerManager

Returns:

null only if there isn't a Global Mode Programmer available via this Manager.

getUserName

public String getUserName()

Description copied from class: DefaultProgrammerManager

Provides the human-readable representation for including ProgrammerManagers directly in user interface components, so it should return a user-provided name for this particular one.

Specified by:

getUserName in interface AddressedProgrammerManager

Specified by:

getUserName in interface GlobalProgrammerManager

Overrides:

getUserName in class DefaultProgrammerManager

Returns:

the name for the programmer

isAddressedModePossible

public boolean isAddressedModePossible()

XpressNet command station does provide Ops Mode We should make this return false based on what command station we're using but for now, we'll return true

Specified by:

isAddressedModePossible in interface AddressedProgrammerManager

Overrides:

isAddressedModePossible in class DefaultProgrammerManager

Returns:

always false in this implementation

isGlobalProgrammerAvailable

public boolean isGlobalProgrammerAvailable()

Description copied from class: DefaultProgrammerManager

Convenience method to check whether you'll be able to get a Global Mode programmer.

Specified by:

isGlobalProgrammerAvailable in interface GlobalProgrammerManager

Overrides:

isGlobalProgrammerAvailable in class DefaultProgrammerManager

Returns:

always false in this implementation

getConcreteAddressedProgrammer

protected AddressedProgrammer getConcreteAddressedProgrammer(boolean pLongAddress,
 int pAddress)

Description copied from class: DefaultProgrammerManager

Gain access to a Addressed Mode Programmer without reservation.

Overrides:

getConcreteAddressedProgrammer in class DefaultProgrammerManager

Parameters:

pLongAddress - true if this is a long (14 bit) address, else false

pAddress - specific decoder address to use

Returns:

null only if there isn't an Ops Mode Programmer in the system

reserveConcreteAddressedProgrammer

protected AddressedProgrammer reserveConcreteAddressedProgrammer(boolean pLongAddress,
 int pAddress)

Description copied from class: DefaultProgrammerManager

Gain access to a (the) Addressed Mode Programmer, in the process reserving it for yourself.

Overrides:

reserveConcreteAddressedProgrammer in class DefaultProgrammerManager

Parameters:

pLongAddress - true if this is a long (14 bit) address, else false

pAddress - Specific decoder address to use

Returns:

null if the address is in use by a reserved programmer

releaseAddressedProgrammer

public void releaseAddressedProgrammer(AddressedProgrammer p)

Description copied from interface: AddressedProgrammerManager

Return access to an Addressed Mode Programmer, so that it can be used elsewhere.

Specified by:

releaseAddressedProgrammer in interface AddressedProgrammerManager

Overrides:

releaseAddressedProgrammer in class DefaultProgrammerManager

Parameters:

p - the programmer to release

reserveConcreteGlobalProgrammer

protected Programmer reserveConcreteGlobalProgrammer()

Description copied from class: DefaultProgrammerManager

Gain access to the Global Mode Programmer, in the process reserving it for yourself.

Overrides:

reserveConcreteGlobalProgrammer in class DefaultProgrammerManager

Returns:

null if the existing Global Mode programmer is in use

releaseGlobalProgrammer

public void releaseGlobalProgrammer(Programmer p)

Description copied from interface: GlobalProgrammerManager

Return access to the Global Mode Programmer, so that it can be used elsewhere.

Specified by:

releaseGlobalProgrammer in interface GlobalProgrammerManager

Overrides:

releaseGlobalProgrammer in class DefaultProgrammerManager

Parameters:

p - the Programmer to release