Application: gvSIG desktop » gvSIG tools: Vector editing

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright ? 2007-2014 gvSIG Association

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.vectorediting.swing.api;

import java.lang.ref.WeakReference;

import org.gvsig.fmap.mapcontext.layers.vectorial.FLyrVect;

import org.gvsig.fmap.mapcontrol.MapControl;

import org.gvsig.fmap.mapcontrol.tools.Behavior.Behavior;

import org.gvsig.tools.observer.Observable;

import org.gvsig.vectorediting.lib.api.EditingService;

import org.gvsig.vectorediting.lib.api.EditingServiceParameter;

import org.gvsig.vectorediting.lib.api.exceptions.InvalidEntryException;

public interface EditingContext extends Observable {

    static final int CANCEL = 0;

    static final int DISCARD_CHANGES = 1;

    static final int EXPORT_LAYER = 2;

    static final int SAVE_CHANGES = 3;

    static final String DEFAULT_TOOL = "default_tool";

    static final String CHANGE_SELECTED_TOOL_NOTIFICATION = "EditingContext.changeSelectedTool";

    static final String REFRESH_TOOLS_NOTIFICATION = "EditingContext.refreshTools";

    static final String EXPORT_LAYER_NOTIFICATION = "EditingContext.exportLayer";

    /**

     * Activates service as of name and {@link MapControl}

     *

     * @param name

     *            of service

     * @param mapControl

     *            of

     */

    public void activateService(String name);

    /**

      * @deprecated Use {@link EditingContext#beginEdition(FLyrVect)}

     */

    public void beginEdition(FLyrVect layer, Behavior[] additionalBehaviors);

    /**

     * Begins edition of a layer

     *

     * @param layer

     *            to begin edition

     */

    public void beginEdition(FLyrVect layer);

    /**

     * Ends edition of a layer 

     *

     * @param layer

     *            to end edition

     */

    public void endEdition(FLyrVect layer);

    /**

     * Gets mapControl object. It is referenced by {@link WeakReference}.

     *

     * @return

     */

    public MapControl getMapControl();

    /**

     *

     * @param name

     * @return

     */

    public boolean isServiceCompatible(String name);

    /**

     * Updates the weak reference at editing context.

     *

     * @param mapControl

     */

    public void setMapControl(MapControl mapControl);

    public Behavior[] getDefaultBehaviors();

    public void setDefaultBehaviors(Behavior[] defaultBehaviors);

    /**

     *

     * @param parameter

     * @param value

     * @throws InvalidEntryException

     */

    public void setValue(EditingServiceParameter parameter, String value) throws InvalidEntryException;

    public EditingService getActiveService();

}