Module com.esri.arcgisruntime

Package com.esri.arcgisruntime.localserver

Class LocalService

java.lang.Object

com.esri.arcgisruntime.localserver.LocalService

Direct Known Subclasses:

LocalGeoprocessingService, LocalMapService

public abstract class LocalService
extends Object

Class representing a service on a local server.

Since:

100.0.0

See Also:

• LocalServer

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	LocalService.StatusChangedEvent	An event which indicates that the status of a LocalService changed.
static interface	LocalService.StatusChangedListener	The listener interface for receiving LocalService.StatusChangedEvent changed events from LocalService resources.

Field Summary

Fields

Modifier and Type	Field	Description
protected final Map<String,String>	mEndpoints

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	LocalService(String packagePath)	Creates a local service from a package.

Method Summary

Modifier and Type	Method	Description
void	addStatusChangedListener(LocalService.StatusChangedListener listener)	Adds a listener that will be fired when the Local Service status changes.
ArcGISRuntimeException	getError()	Returns any error if the service's status is FAILED.
String	getName()	Returns the name of this service on the server.
String	getPackagePath()	Returns the path to the package used to create this service.
protected Map<String,String>	getParameters()	Gets the parameters needed to start the local service.
LocalServerStatus	getStatus()	Returns the service's status.
abstract String	getUrl()	Returns the URL for this service.
boolean	removeStatusChangedListener(LocalService.StatusChangedListener listener)	Removes a status change listener.
ListenableFuture<Void>	startAsync()	Asynchronously starts the service.
ListenableFuture<Void>	stopAsync()	Asynchronously stops the service.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

mEndpoints

protected final Map<String,String> mEndpoints

Constructor Details

LocalService

protected LocalService(String packagePath)

Creates a local service from a package.

Parameters:

packagePath - the path to the package

Throws:

IllegalArgumentException - if the path is null or empty

Since:

100.0.0

Method Details

getParameters

protected Map<String,String> getParameters()
                                    throws UnsupportedEncodingException

Gets the parameters needed to start the local service.

Returns:

returns a map containing the parameters

Throws:

UnsupportedEncodingException

Since:

100.0.0

getUrl

public abstract String getUrl()

Returns the URL for this service.

Returns:

the URL

Since:

100.0.0

getPackagePath

public String getPackagePath()

Returns the path to the package used to create this service.

Returns:

the path to the package

Since:

100.0.0

getName

public String getName()

Returns the name of this service on the server. If the name is null or empty a name will be automatically generated. Note that if this method is called on a service that is not running the name maybe changed when the service starts since each service running on a server requires a unique name.

Returns:

the name

Since:

100.0.0

getError

public ArcGISRuntimeException getError()

Returns any error if the service's status is FAILED.

Returns:

the current error, null if there is no error

Since:

100.0.0

getStatus

public LocalServerStatus getStatus()

Returns the service's status.

Returns:

the service's status

Since:

100.0.0

startAsync

public ListenableFuture<Void> startAsync()

Asynchronously starts the service. Add a listener to the returned future to know when the service has completed starting. If the service is already starting or started this call will have no effect and the ListenableFuture returned will correspond to the previous startAsync that is starting or started the service. The previous ListenableFuture will become unavailable if the service moves from STARTED into the STOPPING state. The service can only be started from the STOPPED state - calling startAsync from other states will cause an exception.

Returns:

A listenable future that will be complete when the service has started

Throws:

IllegalStateException - if the service is not in the STOPPED state and there is no previous future available to return

Since:

100.0.0

stopAsync

public ListenableFuture<Void> stopAsync()

Asynchronously stops the service. Add a listener to the returned future to know when the service has completed stopping. If the service is already stopping or stopped this call will have no effect and the ListenableFuture returned will correspond to the previous stopAsync that is stopping or stopped the service. The previous ListenableFuture will become unavailable if the service moves from STOPPED into the STARTING state. The service can only be stopped from the STARTED state - calling stopAsync from other states will cause an exception.

Returns:

A listenable future that will be complete when the server has stopped

Throws:

IllegalStateException - if the service is not in the STARTED state and there is no previous future available to return

Since:

100.0.0

addStatusChangedListener

public void addStatusChangedListener(LocalService.StatusChangedListener listener)

Adds a listener that will be fired when the Local Service status changes. The listener will be run on the UI thread if the listener is added from the UI thread, otherwise it will be invoked on the current thread.

Parameters:

listener - the listener

Throws:

IllegalArgumentException - if listener is null

Since:

100.0.0

removeStatusChangedListener

public boolean removeStatusChangedListener(LocalService.StatusChangedListener listener)

Removes a status change listener.

Parameters:

listener - the listener to remove

Returns:

true, if successful

Throws:

IllegalArgumentException - if listener is null

Since:

100.0.0