Package org.gvsig.vectorediting.lib.api

Interface EditingService

All Superinterfaces:

org.gvsig.tools.observer.Observable, org.gvsig.tools.service.Service

public interface EditingService
extends org.gvsig.tools.service.Service, org.gvsig.tools.observer.Observable

This service is used to interact with Editing providers. Each instance of this has linked an Editing provider. At this moment services delegate all functionality to providers. To get an instance of this use

invalid reference

EditingManager#getEditingService(String, org.gvsig.fmap.dal.feature.FeatureStore)

Author:

gvSIG team.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ACTIVATE_NOTIFICATION
static final String	FINISH_AND_STORE_NOTIFICATION
static final String	FINISH_NOTIFICATION
static final String	NEXT_NOTIFICATION
static final String	PARAMETER_CHANGED1_NOTIFICATION
static final String	PARAMETER_CHANGED2_NOTIFICATION
static final String	RESTART_NOTIFICATION
static final String	START_NOTIFICATION
static final String	STOP_NOTIFICATION

Method Summary

Modifier and Type	Method	Description
void	activate()	Activate service
org.gvsig.fmap.geom.Geometry	finish()	Finalizes service.
void	finishAndStore()	Finalizes service and stores the result to FeatureStore of this service.
org.gvsig.fmap.dal.feature.EditableFeature	getDefaultFeatureValues()
String	getDescription()
DrawingStatus	getDrawingStatus(org.gvsig.fmap.geom.primitive.Point mousePosition)	Gets state of drawing.
org.gvsig.fmap.mapcontext.rendering.legend.IVectorLegend	getLegend()
String	getName()	Gets service name.
List<EditingServiceParameter>	getParameters()	Gets a List with all parameters of service.
org.gvsig.fmap.dal.feature.FeatureStore	getStore()
Object	getValue(EditingServiceParameter parameter)	Return the parameter's value
Object	getValue(EditingServiceParameter parameter, EditingServiceParameter.TYPE type)
boolean	isEnabled(EditingServiceParameter parameter)	Return true if the parameter is enabled
boolean	mustRestartAtFinish()
EditingServiceParameter	next()	Gets next parameter needed by service.
void	restart()
void	setDefaultFeatureValues(org.gvsig.fmap.dal.feature.EditableFeature feature)
void	setShowPreviewSymbol(boolean showPreviewSymbol)
void	setValue(Object value)	Sets value to service.
void	setValue(EditingServiceParameter parameter, Object value)	Sets value into a paremeter of the service.The value will be put in the parameter of this service.
void	start()	Starts service.
void	stop()	Stops service.

Methods inherited from interface org.gvsig.tools.observer.Observable

addObserver, deleteObserver, deleteObservers

Methods inherited from interface org.gvsig.tools.service.Service

getManager

Field Details

PARAMETER_CHANGED2_NOTIFICATION

static final String PARAMETER_CHANGED2_NOTIFICATION

See Also:

• Constant Field Values

ACTIVATE_NOTIFICATION

static final String ACTIVATE_NOTIFICATION

See Also:

• Constant Field Values

NEXT_NOTIFICATION

static final String NEXT_NOTIFICATION

See Also:

• Constant Field Values

PARAMETER_CHANGED1_NOTIFICATION

static final String PARAMETER_CHANGED1_NOTIFICATION

See Also:

• Constant Field Values

STOP_NOTIFICATION

static final String STOP_NOTIFICATION

See Also:

• Constant Field Values

FINISH_AND_STORE_NOTIFICATION

static final String FINISH_AND_STORE_NOTIFICATION

See Also:

• Constant Field Values

FINISH_NOTIFICATION

static final String FINISH_NOTIFICATION

See Also:

• Constant Field Values

START_NOTIFICATION

static final String START_NOTIFICATION

See Also:

• Constant Field Values

RESTART_NOTIFICATION

static final String RESTART_NOTIFICATION

See Also:

• Constant Field Values

Method Details

getDrawingStatus

DrawingStatus getDrawingStatus(org.gvsig.fmap.geom.primitive.Point mousePosition)
                        throws DrawServiceException

Gets state of drawing. If this service has sufficient values with mouse position to create geometries returns a 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.

Parameters:

mousePosition - Mouse position to draw geometries.

Returns:

A DrawingStatus object with a list of geometries and information.

Throws:

DrawServiceException - if there are some error creating geometries.

getParameters

List<EditingServiceParameter> getParameters()

Gets a List with all parameters of service. Each parameter has name, description and types. See EditingServiceParameter.

Returns:

A list of EditingServiceParameter objects.

next

EditingServiceParameter next()

Gets next parameter needed by service. The parameter has information about its name, description and types. Returns null if all parameters have values.

Returns:

An EditingServiceParameter object that represents the next parameter.

setValue

void setValue(Object value)
       throws InvalidEntryException

Sets value to service. The value will be put in the next parameter need by this service.

Parameters:

value - Object to be set to next EditingServiceParameter

Throws:

InvalidEntryException - If the next parameter needed does not accept this value.

setValue

void setValue(EditingServiceParameter parameter,
 Object value)
       throws InvalidEntryException

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

Parameters:

parameter - EditingServiceParameter

value - Object to be set to EditingServiceParameter

Throws:

InvalidEntryException - If the next parameter needed does not accept this value.

isEnabled

boolean isEnabled(EditingServiceParameter parameter)

Return true if the parameter is enabled

Parameters:

parameter -

Returns:

stop

void stop()
   throws StopServiceException

Stops service. Use this method to stop and clean values of service.

Throws:

StopServiceException - Stops service initializing necessary parameters of service. This method is called when user cancels service.

finish

org.gvsig.fmap.geom.Geometry finish()
                             throws FinishServiceException

Finalizes service. Use this method to get the result of service without store it to FeatureStore. Make sure that service has all required values.

Returns:

Geometry created or modified from added values.

Throws:

FinishServiceException - if there are some error getting values, creating geometries.

finishAndStore

void finishAndStore()
             throws FinishServiceException

Finalizes service and stores the result to FeatureStore of this service. 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

void start()
    throws StartServiceException,
InvalidEntryException

Starts service. 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 service name. The name of service is the same name of linked provider.

Returns:

Name of service.

activate

void activate()

Activate service

getValue

Object getValue(EditingServiceParameter parameter)

Return the parameter's value

Parameters:

parameter -

Returns:

getValue

Object getValue(EditingServiceParameter parameter,
 EditingServiceParameter.TYPE type)

setDefaultFeatureValues

void setDefaultFeatureValues(org.gvsig.fmap.dal.feature.EditableFeature feature)

getDefaultFeatureValues

org.gvsig.fmap.dal.feature.EditableFeature getDefaultFeatureValues()

getStore

org.gvsig.fmap.dal.feature.FeatureStore getStore()

getLegend

org.gvsig.fmap.mapcontext.rendering.legend.IVectorLegend getLegend()

getDescription

String getDescription()

setShowPreviewSymbol

void setShowPreviewSymbol(boolean showPreviewSymbol)

restart

void restart()
      throws StartServiceException,
InvalidEntryException,
StopServiceException

Throws:

StartServiceException

InvalidEntryException

StopServiceException

mustRestartAtFinish

boolean mustRestartAtFinish()