Package jmri.implementation

Class DefaultStringIO

java.lang.Object

jmri.implementation.AbstractNamedBean

jmri.implementation.AbstractStringIO

jmri.implementation.DefaultStringIO

All Implemented Interfaces:

java.lang.Comparable<NamedBean>, PropertyChangeProvider, NamedBean, StringIO

public class DefaultStringIO
extends AbstractStringIO

Base implementation of the StringIO interface.

Nested Class Summary

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.implementation.AbstractNamedBean

listenerRefs, mSystemName, register

Fields inherited from interface jmri.NamedBean

DISPLAY_NAME_FORMAT, INCONSISTENT, PROPERTY_STATE, QUOTED_NAME_FORMAT, UNKNOWN

Constructor Summary

Constructors

Constructor	Description
DefaultStringIO(java.lang.String systemName)
DefaultStringIO(java.lang.String systemName, java.lang.String userName)

Method Summary

Modifier and Type	Method	Description
protected boolean	cutLongStrings()	Cut long strings instead of throwing an exception?
protected void	sendStringToLayout(java.lang.String value)	Sends the string to the layout.

Methods inherited from class jmri.implementation.AbstractStringIO

compareSystemNameSuffix, getBeanType, getCommandedStringValue, getKnownStringValue, getState, setCommandedStringValue, setState, setString

Methods inherited from class jmri.implementation.AbstractNamedBean

addPropertyChangeListener, addPropertyChangeListener, addPropertyChangeListener, addPropertyChangeListener, describeState, dispose, 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.NamedBean

addPropertyChangeListener, addPropertyChangeListener, compareTo, describeState, dispose, getComment, getDisplayName, getDisplayName, getListenerRef, getListenerRefs, getNumPropertyChangeListeners, getProperty, getPropertyChangeListenersByReference, getPropertyKeys, getRecommendedToolTip, getSystemName, getUsageReport, getUserName, removeProperty, setComment, setProperty, setUserName, toString, updateListenerRef, vetoableChange

Methods inherited from interface jmri.beans.PropertyChangeProvider

addPropertyChangeListener, addPropertyChangeListener, getPropertyChangeListeners, getPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener

Methods inherited from interface jmri.StringIO

getMaximumLength, requestUpdateFromLayout

Constructor Detail

DefaultStringIO

public DefaultStringIO(@Nonnull
                       java.lang.String systemName)

DefaultStringIO

public DefaultStringIO(@Nonnull
                       java.lang.String systemName,
                       java.lang.String userName)

Method Detail

sendStringToLayout

protected void sendStringToLayout(@Nonnull
                                  java.lang.String value)
                           throws JmriException

Sends the string to the layout. The string [u]must not[/u] be longer than the value of getMaximumLength() unless that value is zero. Some microcomputers have little memory and it's very important that this method is never called with too long strings.

For systems that don't provide another form of feedback, this call is responsible for setting the known state to the new commanded state, and firing all listeners.

Specified by:

sendStringToLayout in class AbstractStringIO

Parameters:

value - the desired string value

Throws:

JmriException - general error when setting the value fails

cutLongStrings

protected boolean cutLongStrings()

Cut long strings instead of throwing an exception? For example, if the StringIO is a display, it could be desired to accept too long strings. On the other hand, if the StringIO is used to send a command, a too long string is an error.

Specified by:

cutLongStrings in class AbstractStringIO

Returns:

true if long strings should be cut