Package org.gvsig.vectorediting.lib.spi
Interface EditingProvider
- All Superinterfaces:
org.gvsig.tools.service.spi.Provider
- All Known Implementing Classes:
AbstractEditingProvider
public interface EditingProvider
extends org.gvsig.tools.service.spi.Provider
EditingProvider provides functionalities to services.
- Version:
- $Id$
- Author:
- gvSIG team.
-
Method Summary
Modifier and TypeMethodDescriptionvoidactivate()Activete the providerorg.gvsig.fmap.geom.Geometryfinish()Finalizes provider.voidFinalizes provider and stores the result toFeatureStoreof this provider.org.gvsig.fmap.dal.feature.EditableFeaturegetDrawingStatus(org.gvsig.fmap.geom.primitive.Point mousePosition) Gets state of drawing.getName()Gets provider name.Gets aListwith all parameters of provider.getValue(EditingServiceParameter parameter) Return parameter's valuegetValue(EditingServiceParameter parameter, EditingServiceParameter.TYPE type) Return parameter's value of typevoidbooleanisEnabled(EditingServiceParameter parameter) Return true if the parameter is enabledbooleanbooleannext()Gets next parameter needed by provider.voidrestart()Restarts provider.voidsetDefaultFeatureValues(org.gvsig.fmap.dal.feature.EditableFeature feature) voidsetShowPreviewSymbol(boolean showPreviewSymbol) voidSets value to provider.voidsetValue(EditingServiceParameter parameter, Object value) Sets value into a paremeter of the provider.The value will be put in the parameter of this provider.voidstart()Starts provider.voidstop()Stops provider.Methods inherited from interface org.gvsig.tools.service.spi.Provider
setProviderServices
-
Method Details
-
next
EditingServiceParameter next()Gets next parameter needed by provider. The parameter has information about its name, description and types. Returnsnullif all parameters have values.- Returns:
- An
EditingServiceParameterobject that represents the next parameter.
-
getDrawingStatus
DrawingStatus getDrawingStatus(org.gvsig.fmap.geom.primitive.Point mousePosition) throws DrawServiceException Gets state of drawing. If this provider has sufficient values with mouse position to create geometries returns aDrawingStatus. 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.- Parameters:
mousePosition- Mouse position to draw geometries.- Returns:
- A
DrawingStatusobject with a list of geometries and information. - Throws:
DrawServiceException- if there are some error creating geometries.
-
stop
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.
-
getParameters
List<EditingServiceParameter> getParameters()Gets aListwith all parameters of provider. Each parameter has name, description and types. SeeEditingServiceParameter.- Returns:
- A list of
EditingServiceParameterobjects.
-
setValue
Sets value to provider. The value will be put in the next parameter need by this provider.- Parameters:
value- Object to be set to nextEditingServiceParameter- Throws:
InvalidEntryException- If the next parameter needed does not accept this value.
-
setValue
Sets value into a paremeter of the provider.The value will be put in the parameter of this provider.- Parameters:
parameter-EditingServiceParametervalue- Object to be set toEditingServiceParameter- Throws:
InvalidEntryException- If the next parameter needed does not accept this value.
-
isEnabled
Return true if the parameter is enabled- Parameters:
parameter-- Returns:
-
finish
Finalizes provider. Use this method to get the result of provider without store it toFeatureStore. Make sure that provider has all required values.- Returns:
- Geometry created or modified from added values.
- Throws:
FinishServiceException- if there are some error getting values, creating geometries.
-
finishAndStore
Finalizes provider and stores the result toFeatureStoreof 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.
-
start
Starts provider. Use this method before add values.- Throws:
StartServiceException- if there are some error starting service.InvalidEntryException- if the entry of provider is not valid
-
getName
String getName()Gets provider name.- Returns:
- Name of provider.
-
activate
void activate()Activete the provider -
getValue
Return parameter's value- Parameters:
parameter-- Returns:
-
getValue
Return parameter's value of type- Parameters:
parameter-type-- Returns:
-
setDefaultFeatureValues
void setDefaultFeatureValues(org.gvsig.fmap.dal.feature.EditableFeature feature) -
getDefaultFeatureValues
org.gvsig.fmap.dal.feature.EditableFeature getDefaultFeatureValues() -
setShowPreviewSymbol
void setShowPreviewSymbol(boolean showPreviewSymbol) -
isShowPreviewSymbol
boolean isShowPreviewSymbol() -
restart
Restarts provider.- Throws:
StartServiceException- if there are some error starting service.InvalidEntryException- if the entry of provider is not validStopServiceException
-
initDefaultValues
void initDefaultValues() -
mustRestartAtFinish
boolean mustRestartAtFinish()
-