com.sap.cloud.sdk.s4hana.connectivity.rfc

Interface Transaction<RequestT extends AbstractRemoteFunctionRequest<RequestT,RequestResultT>,RequestResultT extends AbstractRemoteFunctionRequestResult<RequestT,RequestResultT>>

Type Parameters:

RequestT - The type of the request to execute.

RequestResultT - The type of the result to return.

All Known Implementing Classes:

JCoTransaction, SoapTransaction

public interface Transaction<RequestT extends AbstractRemoteFunctionRequest<RequestT,RequestResultT>,RequestResultT extends AbstractRemoteFunctionRequestResult<RequestT,RequestResultT>>

The logic to be executed transactional-like by a RemoteFunctionRequestExecutor.

Method Summary

Modifier and Type	Method and Description
void	after() This method gets called *in any case* after the transactional calls are done.
void	before(Destination destination, RequestT request) This method gets called before anything else gets called in the RemoteFunctionRequestExecutor.
void	commit(Destination destination, RequestT request) If execute(Destination, AbstractRemoteFunctionRequest) succeeded, this method is called to actually commit the changes.
RequestResultT	execute(Destination destination, RequestT request) The actual logic to be executed.
void	rollback(Destination destination, RequestT request) If there was a problem with execute(Destination, AbstractRemoteFunctionRequest) or commit(Destination, AbstractRemoteFunctionRequest) this method will get called to rollback any unwanted changes.

Method Detail

before

void before(@Nonnull
            Destination destination,
            @Nonnull
            RequestT request)

This method gets called before anything else gets called in the RemoteFunctionRequestExecutor.

Parameters:

destination - The Destination of this call.

request - The AbstractRemoteFunctionRequest going to be executed.

execute

@Nonnull
RequestResultT execute(@Nonnull
                                Destination destination,
                                @Nonnull
                                RequestT request)
                         throws RequestExecutionException

The actual logic to be executed.

Parameters:

destination - The Destination of this call.

request - The AbstractRemoteFunctionRequest going to execute.

Returns:

The AbstractRemoteFunctionRequestResult created by the request.

Throws:

RequestExecutionException - if an exception occurred during the execute implementation.

commit

void commit(@Nonnull
            Destination destination,
            @Nonnull
            RequestT request)
     throws RequestExecutionException

If execute(Destination, AbstractRemoteFunctionRequest) succeeded, this method is called to actually commit the changes.

Parameters:

destination - The Destination of this call.

request - The AbstractRemoteFunctionRequest that was executed.

Throws:

RequestExecutionException - If an exception occurred during the commit implementation.

rollback

void rollback(@Nonnull
              Destination destination,
              @Nonnull
              RequestT request)
       throws RequestExecutionException

If there was a problem with execute(Destination, AbstractRemoteFunctionRequest) or commit(Destination, AbstractRemoteFunctionRequest) this method will get called to rollback any unwanted changes.

Parameters:

destination - The Destination of this call.

request - The AbstractRemoteFunctionRequest that was executed.

Throws:

RequestExecutionException - If an exception occurred during the rollback implementation.

after

void after()
    throws RemoteFunctionException

This method gets called *in any case* after the transactional calls are done.

Throws:

RemoteFunctionException - If an exception occurred during the after implementation.