/*
* @(#)DefaultFormatterFactory.java 1.8 03/12/19
*
* Copyright 2004 Sun Microsystems, Inc. All rights reserved.
* SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
*/
package javax.swing.text;
import java.io.Serializable;
import java.text.ParseException;
import javax.swing.JFormattedTextField;
/**
* An implementation of
* JFormattedTextField.AbstractFormatterFactory
.
* DefaultFormatterFactory
allows specifying a number of
* different JFormattedTextField.AbstractFormatter
s that are to
* be used.
* The most important one is the default one
* (setDefaultFormatter
). The default formatter will be used
* if a more specific formatter could not be found. The following process
* is used to determine the appropriate formatter to use.
*
JFormattedTextField
have focus? Use the edit
* formatter.
* AbstractFormatter
has not been found, use
* the default formatter.
*
* The following code shows how to configure a
* JFormattedTextField
with two
* JFormattedTextField.AbstractFormatter
s, one for display and
* one for editing.
*
* JFormattedTextField.AbstractFormatter editFormatter = ...; * JFormattedTextField.AbstractFormatter displayFormatter = ...; * DefaultFormatterFactory factory = new DefaultFormatterFactory( * displayFormatter, displayFormatter, editFormatter); * JFormattedTextField tf = new JFormattedTextField(factory); **
* Warning:
* Serialized objects of this class will not be compatible with
* future Swing releases. The current serialization support is
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeansTM
* has been added to the java.beans
package.
* Please see {@link java.beans.XMLEncoder}.
*
* @see javax.swing.JFormattedTextField
*
* @version 1.8 12/19/03
* @since 1.4
*/
public class DefaultFormatterFactory extends JFormattedTextField.AbstractFormatterFactory implements Serializable {
/**
* Default AbstractFormatter
to use if a more specific one has
* not been specified.
*/
private JFormattedTextField.AbstractFormatter defaultFormat;
/**
* JFormattedTextField.AbstractFormatter
to use for display.
*/
private JFormattedTextField.AbstractFormatter displayFormat;
/**
* JFormattedTextField.AbstractFormatter
to use for editing.
*/
private JFormattedTextField.AbstractFormatter editFormat;
/**
* JFormattedTextField.AbstractFormatter
to use if the value
* is null.
*/
private JFormattedTextField.AbstractFormatter nullFormat;
public DefaultFormatterFactory() {
}
/**
* Creates a DefaultFormatterFactory
with the specified
* JFormattedTextField.AbstractFormatter
.
*
* @param defaultFormat JFormattedTextField.AbstractFormatter to be used
* if a more specific
* JFormattedTextField.AbstractFormatter can not be
* found.
*/
public DefaultFormatterFactory(JFormattedTextField.
AbstractFormatter defaultFormat) {
this(defaultFormat, null);
}
/**
* Creates a DefaultFormatterFactory
with the specified
* JFormattedTextField.AbstractFormatter
s.
*
* @param defaultFormat JFormattedTextField.AbstractFormatter to be used
* if a more specific
* JFormattedTextField.AbstractFormatter can not be
* found.
* @param displayFormat JFormattedTextField.AbstractFormatter to be used
* when the JFormattedTextField does not have focus.
*/
public DefaultFormatterFactory(
JFormattedTextField.AbstractFormatter defaultFormat,
JFormattedTextField.AbstractFormatter displayFormat) {
this(defaultFormat, displayFormat, null);
}
/**
* Creates a DefaultFormatterFactory with the specified
* JFormattedTextField.AbstractFormatters.
*
* @param defaultFormat JFormattedTextField.AbstractFormatter to be used
* if a more specific
* JFormattedTextField.AbstractFormatter can not be
* found.
* @param displayFormat JFormattedTextField.AbstractFormatter to be used
* when the JFormattedTextField does not have focus.
* @param editFormat JFormattedTextField.AbstractFormatter to be used
* when the JFormattedTextField has focus.
*/
public DefaultFormatterFactory(
JFormattedTextField.AbstractFormatter defaultFormat,
JFormattedTextField.AbstractFormatter displayFormat,
JFormattedTextField.AbstractFormatter editFormat) {
this(defaultFormat, displayFormat, editFormat, null);
}
/**
* Creates a DefaultFormatterFactory with the specified
* JFormattedTextField.AbstractFormatters.
*
* @param defaultFormat JFormattedTextField.AbstractFormatter to be used
* if a more specific
* JFormattedTextField.AbstractFormatter can not be
* found.
* @param displayFormat JFormattedTextField.AbstractFormatter to be used
* when the JFormattedTextField does not have focus.
* @param editFormat JFormattedTextField.AbstractFormatter to be used
* when the JFormattedTextField has focus.
* @param nullFormat JFormattedTextField.AbstractFormatter to be used
* when the JFormattedTextField has a null value.
*/
public DefaultFormatterFactory(
JFormattedTextField.AbstractFormatter defaultFormat,
JFormattedTextField.AbstractFormatter displayFormat,
JFormattedTextField.AbstractFormatter editFormat,
JFormattedTextField.AbstractFormatter nullFormat) {
this.defaultFormat = defaultFormat;
this.displayFormat = displayFormat;
this.editFormat = editFormat;
this.nullFormat = nullFormat;
}
/**
* Sets the JFormattedTextField.AbstractFormatter
to use as
* a last resort, eg in case a display, edit or null
* JFormattedTextField.AbstractFormatter
has not been
* specified.
*
* @param atf JFormattedTextField.AbstractFormatter used if a more
* specific is not specified
*/
public void setDefaultFormatter(JFormattedTextField.AbstractFormatter atf){
defaultFormat = atf;
}
/**
* Returns the JFormattedTextField.AbstractFormatter
to use
* as a last resort, eg in case a display, edit or null
* JFormattedTextField.AbstractFormatter
* has not been specified.
*
* @return JFormattedTextField.AbstractFormatter used if a more specific
* one is not specified.
*/
public JFormattedTextField.AbstractFormatter getDefaultFormatter() {
return defaultFormat;
}
/**
* Sets the JFormattedTextField.AbstractFormatter
to use if
* the JFormattedTextField
is not being edited and either
* the value is not-null, or the value is null and a null formatter has
* has not been specified.
*
* @param atf JFormattedTextField.AbstractFormatter to use when the
* JFormattedTextField does not have focus
*/
public void setDisplayFormatter(JFormattedTextField.AbstractFormatter atf){
displayFormat = atf;
}
/**
* Returns the JFormattedTextField.AbstractFormatter
to use
* if the JFormattedTextField
is not being edited and either
* the value is not-null, or the value is null and a null formatter has
* has not been specified.
*
* @return JFormattedTextField.AbstractFormatter to use when the
* JFormattedTextField does not have focus
*/
public JFormattedTextField.AbstractFormatter getDisplayFormatter() {
return displayFormat;
}
/**
* Sets the JFormattedTextField.AbstractFormatter
to use if
* the code>JFormattedTextField is being edited and either
* the value is not-null, or the value is null and a null formatter has
* has not been specified.
*
* @param atf JFormattedTextField.AbstractFormatter to use when the
* component has focus
*/
public void setEditFormatter(JFormattedTextField.AbstractFormatter atf) {
editFormat = atf;
}
/**
* Returns the JFormattedTextField.AbstractFormatter
to use
* if the JFormattedTextField
is being edited and either
* the value is not-null, or the value is null and a null formatter has
* has not been specified.
*
* @return JFormattedTextField.AbstractFormatter to use when the
* component has focus
*/
public JFormattedTextField.AbstractFormatter getEditFormatter() {
return editFormat;
}
/**
* Sets the formatter to use if the value of the JFormattedTextField is
* null.
*
* @param atf JFormattedTextField.AbstractFormatter to use when
* the value of the JFormattedTextField is null.
*/
public void setNullFormatter(JFormattedTextField.AbstractFormatter atf) {
nullFormat = atf;
}
/**
* Returns the formatter to use if the value is null.
*
* @return JFormattedTextField.AbstractFormatter to use when the value is
* null
*/
public JFormattedTextField.AbstractFormatter getNullFormatter() {
return nullFormat;
}
/**
* Returns either the default formatter, display formatter, editor
* formatter or null formatter based on the state of the
* JFormattedTextField.
*
* @param source JFormattedTextField requesting
* JFormattedTextField.AbstractFormatter
* @return JFormattedTextField.AbstractFormatter to handle
* formatting duties.
*/
public JFormattedTextField.AbstractFormatter getFormatter(
JFormattedTextField source) {
JFormattedTextField.AbstractFormatter format = null;
if (source == null) {
return null;
}
Object value = source.getValue();
if (value == null) {
format = getNullFormatter();
}
if (format == null) {
if (source.hasFocus()) {
format = getEditFormatter();
}
else {
format = getDisplayFormatter();
}
if (format == null) {
format = getDefaultFormatter();
}
}
return format;
}
}