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 java.util.Map;

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

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

import org.gvsig.fmap.geom.Geometry;

import org.gvsig.fmap.mapcontext.rendering.symbols.ISymbol;

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

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

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

/**

 *

 * Manager the registration of {@link EditingProviderFactory} objects and the

 * creation of Providers. Moreover, offers service info about services and

 * utility methods.

 *

 * @author llmarques

 * @version $Id$

 */

public interface EditingProviderManager extends ProviderManager {

    /**

     * Gets read only information about a service such as if creates new

     * geometries, name, description, supported types, mouse icon, parameters

     * and

     * information about its parameters.

     *

     * @param name

     *            service name to get the service information

     * @return An <code>EditingServiceInfo</code> object that contains the

     *         information. {@link EditingServiceInfo}.

     * @throws ServiceInformationException

     *             if there is an error getting

     *             information of service.

     */

    public EditingServiceInfo getServiceInfo(String name)

        throws ServiceInformationException;

    /**

     * Utility method used by providers to register icons. Use png files.

     *

     * @param group

     *            of icon. Use vectorediting-tools.

     * @param name

     *            of icon.

     * @param loader

     *            classloader of provider.

     * @param provider

     *            of icon

     */

    public void registerIcon(String group, String name, ClassLoader loader,

        String provider);

    /**

    * Register a symbol in a symbol's map with name as key

    *

    * @param name

    * @param symbol

    */

   public void registerSymbol(String name, ISymbol symbol);

   /**

   *

   * @param name

   * @param symbol

   * @return 

   */

  public ISymbol getSymbol(String name);

  /**

  *

     * @param provider

  * @param values

  */

  public void registerDefaultValues(String provider, Map values);

  /**

  *

  * @param name

  * @param loader

  */

  public void registerDefaultValues(String name, ClassLoader loader);

  /**

  *

  * @param name

     * @return 

  */

  public Map<String, String> getDefaultValues(String name);

  public List<Geometry> getGeometriesFromClipboard();

  public List<EditableFeature> getFeaturesFromClipboard(EditingProviderServices providerServices, FeatureStore store);

}