Application: gvSIG desktop » Library: org.gvsig.tools

import org.gvsig.tools.dynobject.DynObject;

import org.gvsig.tools.swing.api.dynobject.ValueChangedListener;

import org.gvsig.tools.swing.api.dynobject.dynfield.JDynFieldComponent;

import org.gvsig.tools.swing.api.dynobject.dynfield.ValueField;

 * This interfaces provides with the logic necessary to create

 * JDynFieldComponents. First,

 * the initial values are extracted. Second, the user interface components are

 * created.

 * Third, the initial value is set to the right component, and last but not

 * least, a

 * fireEventChanged event is raised to inform all Listeners that the value has

 * changed.

 * Some additional functions related to DynField attributes are also

 * implemented.

 * 

 * @author 2010 - <a href="cordinyana@gvsig.org">C?sar Ordi?ana</a> - gvSIG Team

 * @author 2010 - <a href="mailto:reinhold@uji.es">Cristian Mart?n&nbsp;</a> -

 *         gvSIG Team

 * @version $Id$

 * 

    private ValueField parent;

    public AbstractJDynField(ValueField parent) {

        this.parent = parent;

     * Inits the JDynFieldComponent logic to create its components and check its

     * values.

     */

    protected void init() {

        this.initData();

        this.initUI();

        if (this.getDynField().isReadOnly())

            this.setReadOnly();

        this.setValue(getInitialValue());

        this.afterUI();

    }

     * JDynFieldComponents can use this function to initialize any

     * data containers before the swing components are created.

     */

    protected abstract void initData();

    /**

     * {@link JDynFieldComponent}s can use this function to initialized any

     * swing components to be used afterwards, and specify their

     * default settings.

     */

    protected abstract void initUI();

    /**

     * Checks if the {@link ValueField} has an inputed value; if not, then it

     * asks

     * for its default value.

     * @return

     *         the initial value of the {@link ValueField}. It can be

     *         <b>null</b>.

    public Object getInitialValue() {

        Object value = getFieldValue();

        if (value == null) {

            value = getDefaultFieldValue();

        }

        return value;

    /**

     * The {@link JDynFieldComponent} can implement this function to set the

     * swing

     * components that represent this {@link DynField} to readOnly mode.

     */

    protected abstract void setReadOnly();

    /**

     * Sets the value to the {@link JDynFieldComponent}. With this logic, it

     * checks first

     * if it is a null value or not. Then all {@link ValueChangedListener}s are

     * fired

     * to alert them to check if the value has changed via the {@link

     * getValue()} function.

     * 

     * @param value

     *            the value to be set into the swing component.

     */

    public void setValue(Object value) {

            setNullValue();

        else

            setNonNullValue(value);

    /**

     * The {@link JDynFieldComponent} can use this function to add any code

     * necessary

     * once all swing components have been initialized.

     */

    protected abstract void afterUI();

    /**

     * The {@link JDynFieldComponent} can use this function to set a <b>non

     * null</b> value

     * into the correspondent swing component.

     * 

     * @param value

     *            the value to be set into the swing component.

     */

    protected abstract void setNonNullValue(Object value);

     * The {@link JDynFieldComponent} can use this function to set a <b>null</b>

     * value

     * into the correspondent swing component.

     * 

     * @param value

     *            the value to be set into the swing component.

     */

    protected abstract void setNullValue();

     * Then all {@link ValueChangedListener}s are fired to alert them

     * to check if the value has changed via the {@link getValue()} function of

     * the {@link JDynFieldComponent}.

     */

    public abstract void fireValueChangedEvent();

     * Returns the {@link DynField} being rendered.

     * 

     * @return the {@link DynField}

     */

    public DynField getDynField() {

        return getValueField().getDynField();

    }

    /**

     * Gets the {@link ValueField} object.

     * 

     * @return

     *         the {@link ValueField} object.

     */

    private ValueField getValueField() {

        return this.parent;

    }

    /**

     * Gets the default value of the {@link ValueField} object.

     * 

     * @return

     *         the default value of the {@link ValueField} object.

     */

    public Object getDefaultFieldValue() {

        return this.getValueField().getDefaultFieldValue();

    }

    /**

     * Gets the current value of the {@link ValueField} object.

     * 

     * @return

     *         the current value of the {@link ValueField} object.

     */

    public Object getFieldValue() {

        return this.getValueField().getFieldValue();

    }

    /**

     * Sets the current value of the {@link JDynFieldComponent} to the

     * {@link DynObject} value via the {@link ValueField} object.

     * 

     */

    public void setFieldValue(Object value) {

        this.getValueField().setFieldValue(value);

    }