chemaxon.marvin.services

Class ServiceHandler<DT extends chemaxon.marvin.services.ServiceDescriptor>

java.lang.Object

chemaxon.marvin.services.ServiceHandler<DT>

Type Parameters:

DT - the descriptor type

@PublicAPI
public abstract class ServiceHandler<DT extends chemaxon.marvin.services.ServiceDescriptor>
extends java.lang.Object

Manages service calls.
ServiceHandler keeps track of the previous call and if it is not yet finished cancels it. This ensures that fast consecutive editing in automatic update mode even in the face of slow service calls gets its result timely updated. This works when a ServiceHandler instance is assigned to a single service instance (as defined by a service descriptor).

Since:

5.6

Constructor Summary

Constructors

Constructor and Description
ServiceHandler()

Method Summary

Modifier and Type	Method and Description
<T> void	callService(DT descriptor, AsyncCallback<T> handler, java.lang.Object... arguments) Performs thread-safe asynchronous service call.
abstract <T> T	callService(DT descriptor, java.lang.Object... arguments) Performs a service call.

Methods inherited from class java.lang.Object

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

Constructor Detail

ServiceHandler

public ServiceHandler()

Method Detail

callService

public <T> void callService(DT descriptor,
                            AsyncCallback<T> handler,
                            java.lang.Object... arguments)

Performs thread-safe asynchronous service call.

Type Parameters:

T - the return type

Parameters:

descriptor - the service descriptor

handler - the response handler

arguments - the service call arguments

callService

public abstract <T> T callService(DT descriptor,
                                  java.lang.Object... arguments)
                           throws ServiceException

Performs a service call.

Parameters:

descriptor - the service descriptor

arguments - the service call arguments

Returns:

result of service call

Throws:

ServiceException - on failure