Package jmri.jmrix.configurexml

Class AbstractConnectionConfigXml

java.lang.Object

jmri.configurexml.AbstractXmlAdapter

jmri.jmrix.configurexml.AbstractConnectionConfigXml

All Implemented Interfaces:

XmlAdapter

Direct Known Subclasses:

AbstractNetworkConnectionConfigXml, AbstractSerialConnectionConfigXml, AbstractStreamConnectionConfigXml, AbstractUsbConnectionConfigXml, ConnectionConfigXml, ConnectionConfigXml, ConnectionConfigXml, IpocsConnectionConfigXml, RaspberryPiConnectionConfigXml

public abstract class AbstractConnectionConfigXml
extends AbstractXmlAdapter

Abstract base (and partial implementation) for classes persisting the status of connections.

Nested Class Summary

Nested classes/interfaces inherited from class jmri.configurexml.AbstractXmlAdapter

AbstractXmlAdapter.EnumIO<T extends Enum<T>>, AbstractXmlAdapter.EnumIoMapped<T extends Enum<T>>, AbstractXmlAdapter.EnumIoNames<T extends Enum<T>>, AbstractXmlAdapter.EnumIoNamesNumbers<T extends Enum<T>>, AbstractXmlAdapter.EnumIoOrdinals<T extends Enum<T>>

Constructor Summary

Constructors

Constructor	Description
AbstractConnectionConfigXml()

Method Summary

Modifier and Type	Method	Description
protected void	checkAndWarnPrefix(String prefix)	Deprecated. 4.15.3 part of #4670 migration to parsable prefixes
protected void	extendElement(Element e)	Customizable method if you need to add anything more
protected String	findParmValue(Element e, String name)	Service routine to look through "parameter" child elements to find a particular parameter value
protected abstract void	getInstance()
protected void	loadCommon(Element shared, Element perNode, PortAdapter adapter)	load common attributes and elements
protected void	loadOptions(Element shared, Element perNode, PortAdapter adapter)	load options
protected abstract void	register()
protected void	register(ConnectionConfig c)
protected void	saveOptions(Element e, PortAdapter adapter)	save options
protected void	setOutputInterval(PortAdapter adapter, Element e)	Store the outputInterval in a connection element for persistence.
Element	store(Object o, boolean shared)	Store the object in XML
protected void	storeCommon(Element e, PortAdapter adapter)
protected void	unpackElement(Element shared, Element perNode)	Method to unpack additional XML structures after connection creation, but before connection is usable.

Methods inherited from class jmri.configurexml.AbstractXmlAdapter

getAttributeBooleanValue, getAttributeDoubleValue, getAttributeFloatValue, getAttributeIntegerValue, getExceptionHandler, handleException, load, load, load, load, loadDeferred, loadOrder, setExceptionHandler

Methods inherited from class java.lang.Object

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

Methods inherited from interface jmri.configurexml.XmlAdapter

store

Constructor Details

AbstractConnectionConfigXml

public AbstractConnectionConfigXml()

Method Details

getInstance

protected abstract void getInstance()

register

protected abstract void register()

register

protected void register(ConnectionConfig c)

store

public Element store(Object o, boolean shared)

Description copied from class: AbstractXmlAdapter

Store the object in XML

Specified by:

store in interface XmlAdapter

Overrides:

store in class AbstractXmlAdapter

Parameters:

o - The object to be recorded. Specific XmlAdapter implementations will require this to be of a specific type; that binding is done in ConfigXmlManager.

shared - true if the returned element should be the common XML and false if the returned element should be per-node.

Returns:

The XML representation Element

storeCommon

protected void storeCommon(Element e, PortAdapter adapter)

extendElement

protected void extendElement(Element e)

Customizable method if you need to add anything more

Parameters:

e - Element being created, update as needed

loadCommon

protected void loadCommon(Element shared, Element perNode, PortAdapter adapter)

load common attributes and elements

Parameters:

shared - the shared element

perNode - the per node element

adapter - the port adapter

checkAndWarnPrefix

@Deprecated protected void checkAndWarnPrefix(String prefix)

Deprecated.

4.15.3 part of #4670 migration to parsable prefixes

Check for a deprecated system prefix and warn if found

Parameters:

prefix - The alphanumeric prefix to test for

saveOptions

protected void saveOptions(Element e, PortAdapter adapter)

save options

Parameters:

e - the element

adapter - the port adapter

loadOptions

protected void loadOptions(Element shared, Element perNode, PortAdapter adapter)

load options

Parameters:

shared - the shared element

perNode - the per node element

adapter - the port adapter

unpackElement

protected void unpackElement(Element shared, Element perNode)

Method to unpack additional XML structures after connection creation, but before connection is usable.

Parameters:

shared - connection information common to all nodes

perNode - connection information unique to this node

findParmValue

protected String findParmValue(Element e, String name)

Service routine to look through "parameter" child elements to find a particular parameter value

Parameters:

e - Element containing parameters

name - name of desired parameter

Returns:

String value

setOutputInterval

protected void setOutputInterval(PortAdapter adapter, Element e)

Store the outputInterval in a connection element for persistence.

Parameters:

adapter - the adapter for which properties are stored

e - the "connection" element being filled