org.openstreetmap.josm.gui.widgets

Class AbstractTextComponentValidator

java.lang.Object

org.openstreetmap.josm.gui.widgets.AbstractTextComponentValidator

All Implemented Interfaces:

ActionListener, FocusListener, PropertyChangeListener, EventListener, DocumentListener

Direct Known Subclasses:

AdvancedChangesetQueryPanel.DateValidator, AdvancedChangesetQueryPanel.TimeValidator, AdvancedChangesetQueryPanel.UidInputFieldValidator, AdvancedChangesetQueryPanel.UserNameInputValidator, BoundingBoxSelectionPanel.LatitudeValidator, BoundingBoxSelectionPanel.LongitudeValidator, ChangesetIdTextField.ChangesetIdValidator, FullyAutomaticAuthorizationUI.PasswordValidator, FullyAutomaticAuthorizationUI.UserNameValidator, FullyAutomaticPropertiesPanel.UserNameValidator, ManualAuthorizationUI.AccessTokenKeyValidator, ManualAuthorizationUI.AccessTokenSecretValidator, OsmApiUrlInputPanel.ApiUrlValidator, OsmIdTextField.OsmIdValidator, TileSelectionBBoxChooser.TileAddressValidator, TileSelectionBBoxChooser.TileCoordinateValidator, UserNameValidator

public abstract class AbstractTextComponentValidator
extends Object
implements ActionListener, FocusListener, DocumentListener, PropertyChangeListener

This is an abstract class for a validator on a text component. Subclasses implement validate(). validate() is invoked whenever

• the content of the text component changes (the validator is a DocumentListener)
• the text component loses focus (the validator is a FocusListener)
• the text component is a JosmTextField and an ActionEvent is detected

Field Summary

Fields

Modifier and Type	Field and Description
private static Color	ERROR_BACKGROUND
private static Border	ERROR_BORDER
private String	msg
private JTextComponent	tc
private Boolean	valid remembers whether the content of the text component is currently valid or not; null means, we don't know yet

Constructor Summary

Constructors

Constructor and Description
AbstractTextComponentValidator(JTextComponent tc) Creates the validator and weires it to the text component tc.
AbstractTextComponentValidator(JTextComponent tc, boolean addActionListener) Alternative constructor that allows to turn off the actionListener.
AbstractTextComponentValidator(JTextComponent tc, boolean addFocusListener, boolean addDocumentListener, boolean addActionListener)

Method Summary

Modifier and Type	Method and Description
void	actionPerformed(ActionEvent arg0)
void	changedUpdate(DocumentEvent arg0)
protected void	feedbackDisabled()
protected void	feedbackInvalid(String msg)
protected void	feedbackValid(String msg)
void	focusGained(FocusEvent arg0)
void	focusLost(FocusEvent arg0)
JTextComponent	getComponent() Replies the decorated text component
void	insertUpdate(DocumentEvent arg0)
abstract boolean	isValid() Replies true if the current content of the decorated text component is valid; false otherwise
void	propertyChange(PropertyChangeEvent evt)
void	removeUpdate(DocumentEvent arg0)
abstract void	validate() Implement in subclasses to validate the content of the text component.

Methods inherited from class java.lang.Object

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

Field Detail

ERROR_BORDER

private static final Border ERROR_BORDER

ERROR_BACKGROUND

private static final Color ERROR_BACKGROUND

tc

private JTextComponent tc

valid

private Boolean valid

remembers whether the content of the text component is currently valid or not; null means, we don't know yet

msg

private String msg

Constructor Detail

AbstractTextComponentValidator

public AbstractTextComponentValidator(JTextComponent tc)
                               throws IllegalArgumentException

Creates the validator and weires it to the text component tc.

Parameters:

tc - the text component. Must not be null.

Throws:

IllegalArgumentException - thrown if tc is null

AbstractTextComponentValidator

public AbstractTextComponentValidator(JTextComponent tc,
                                      boolean addActionListener)
                               throws IllegalArgumentException

Alternative constructor that allows to turn off the actionListener. This can be useful if the enter key stroke needs to be forwarded to the default button in a dialog.

Throws:

IllegalArgumentException

AbstractTextComponentValidator

public AbstractTextComponentValidator(JTextComponent tc,
                                      boolean addFocusListener,
                                      boolean addDocumentListener,
                                      boolean addActionListener)
                               throws IllegalArgumentException

Throws:

IllegalArgumentException

Method Detail

feedbackInvalid

protected void feedbackInvalid(String msg)

feedbackDisabled

protected void feedbackDisabled()

feedbackValid

protected void feedbackValid(String msg)

getComponent

public JTextComponent getComponent()

Replies the decorated text component

Returns:

the decorated text component

validate

public abstract void validate()

Implement in subclasses to validate the content of the text component.

isValid

public abstract boolean isValid()

Replies true if the current content of the decorated text component is valid; false otherwise

Returns:

true if the current content of the decorated text component is valid

focusGained

public void focusGained(FocusEvent arg0)

Specified by:

focusGained in interface FocusListener

focusLost

public void focusLost(FocusEvent arg0)

Specified by:

focusLost in interface FocusListener

actionPerformed

public void actionPerformed(ActionEvent arg0)

Specified by:

actionPerformed in interface ActionListener

changedUpdate

public void changedUpdate(DocumentEvent arg0)

Specified by:

changedUpdate in interface DocumentListener

insertUpdate

public void insertUpdate(DocumentEvent arg0)

Specified by:

insertUpdate in interface DocumentListener

removeUpdate

public void removeUpdate(DocumentEvent arg0)

Specified by:

removeUpdate in interface DocumentListener

propertyChange

public void propertyChange(PropertyChangeEvent evt)

Specified by:

propertyChange in interface PropertyChangeListener