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.lib.spi;

import java.util.List;

import org.gvsig.fmap.dal.feature.EditableFeature;

import org.gvsig.fmap.dal.feature.FeatureStore;

import org.gvsig.fmap.geom.Geometry;

import org.gvsig.fmap.geom.primitive.Point;

import org.gvsig.tools.service.spi.Provider;

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

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

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

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

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

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

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

/**

 * EditingProvider provides functionalities to services.

 * 

 * @author gvSIG team.

 * @version $Id$

 */

public interface EditingProvider extends Provider {

    /**

     * Gets next parameter needed by provider. The parameter has information

     * about its name, description and types. Returns <code>null</code> if all

     * parameters have values.

     *

     * @return An {@link EditingServiceParameter} object that represents the

     *         next parameter.

     */

    public EditingServiceParameter next();

    /**

     * Gets state of drawing. If this provider has sufficient values with mouse

     * position to create geometries returns a {@link DrawingStatus}. List of

     * geometries of drawing status object can be different from final

     * geometries. Use this method to get a draft status information while user

     * is drawing.

     *

     * @param mousePosition

     *            Mouse position to draw geometries.

     * @return A {@link DrawingStatus} object with a list of geometries and

     *         information.

     * @throws DrawServiceException

     *             if there are some error creating geometries.

     */

    public DrawingStatus getDrawingStatus(Point mousePosition)

        throws DrawServiceException;

    /**

     * Stops provider. Use this method to stop and clean values of provider.

     *

     * @throws StopServiceException

     *             Stops provider initializing necessary parameters of provider.

     *             This method is called when user cancels provider.

     */

    public void stop() throws StopServiceException;

    /**

     * Gets a <code>List</code> with all parameters of provider. Each parameter

     * has name, description and types. See {@link EditingServiceParameter}.

     *

     * @return A list of {@link EditingServiceParameter} objects.

     */

    public List<EditingServiceParameter> getParameters();

    /**

     * Sets value to provider. The value will be put in the next parameter need

     * by this provider.

     *

     * @param value

     *            Object to be set to next {@link EditingServiceParameter}

     * @throws InvalidEntryException

     *             If the next parameter needed does not accept this value.

     */

    public void setValue(Object value) throws InvalidEntryException;

    /**

     * Sets value into a paremeter of the provider.The value will be put in the parameter of this provider.

     *

     * @param parameter {@link EditingServiceParameter}

     * @param value

     *            Object to be set to {@link EditingServiceParameter}

     * @throws InvalidEntryException

     *             If the next parameter needed does not accept this value.

     */

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

    /**

     * Return true if the parameter is enabled

     * 

     * @param parameter

     * @return

     */

    public boolean isEnabled(EditingServiceParameter parameter);

    /**

     * Finalizes provider. Use this method to get the result of provider without

     * store it to {@link FeatureStore}. Make sure that provider has all required

     * values.

     *

     * @return Geometry created or modified from added values.

     * @throws FinishServiceException

     *             if there are some error getting values,

     *             creating geometries.

     */

    public Geometry finish() throws FinishServiceException;

    /**

     * Finalizes provider and stores the result to {@link FeatureStore} of this

     * provider. Use this method to store the result of this service. Make sure

     * that service has all required values.

     *

     * @throws FinishServiceException

     *             if there are some error getting values,

     *             creating geometries or inserting/updating/removing geometries

     *             from feature store.

     */

    public void finishAndStore() throws FinishServiceException;

    /**

     * Starts provider. Use this method before add values.

     *

     * @throws StartServiceException

     *             if there are some error starting service.

     * @throws InvalidEntryException

     *             if the entry of provider is not valid 

     */

    public void start() throws StartServiceException, InvalidEntryException;

    /**

     * Gets provider name. 

     *

     * @return Name of provider.

     */

    public String getName();

    /**

     * Activete the provider

     */

    public void activate();

    /**

     * Return parameter's value

     * 

     * @param parameter

     * @return

     */

    public Object getValue(EditingServiceParameter parameter);

    /**

     * Return parameter's value of type

     * 

     * @param parameter

     * @param type

     * @return

     */

    public Object getValue(EditingServiceParameter parameter, EditingServiceParameter.TYPE type);

    public void setDefaultFeatureValues(EditableFeature feature);

    public EditableFeature getDefaultFeatureValues();

    public void setShowPreviewSymbol(boolean showPreviewSymbol);

    public boolean isShowPreviewSymbol();

    /**

     * Restarts provider.

     *

     * @throws StartServiceException

     *             if there are some error starting service.

     * @throws InvalidEntryException

     *             if the entry of provider is not valid 

     */

    public void restart() throws StartServiceException, InvalidEntryException, StopServiceException;

    public void initDefaultValues();

}