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

Interface Transaction<QueryT extends AbstractRemoteFunctionQuery<QueryT,QueryResultT>,QueryResultT extends AbstractRemoteFunctionQueryResult<QueryT,QueryResultT>>

Type Parameters:

QueryT - The type of the query to execute.

QueryResultT - The type of the result to return.

All Known Implementing Classes:

JCoTransaction, SoapTransaction

public interface Transaction<QueryT extends AbstractRemoteFunctionQuery<QueryT,QueryResultT>,QueryResultT extends AbstractRemoteFunctionQueryResult<QueryT,QueryResultT>>

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

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(ErpConfigContext configContext, QueryT query) This method gets called before anything else gets called in the RemoteFunctionQueryExecutor.
void	commit(ErpConfigContext configContext, QueryT query) If execute(ErpConfigContext, AbstractRemoteFunctionQuery) succeeded, this method is called to actually commit the changes.
QueryResultT	execute(ErpConfigContext configContext, QueryT query) The actual logic to be executed.
void	rollback(ErpConfigContext configContext, QueryT query) If there was a problem with execute(ErpConfigContext, AbstractRemoteFunctionQuery) or commit(ErpConfigContext, AbstractRemoteFunctionQuery) this method will get called to rollback any unwanted changes.

Method Detail

before

void before(@Nonnull
            ErpConfigContext configContext,
            @Nonnull
            QueryT query)

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

Parameters:

configContext - The ErpConfigContext of this call.

query - The AbstractRemoteFunctionQuery going to be executed.

execute

@Nonnull
QueryResultT execute(@Nonnull
                              ErpConfigContext configContext,
                              @Nonnull
                              QueryT query)
                       throws QueryExecutionException

The actual logic to be executed.

Parameters:

configContext - The ErpConfigContext of this call.

query - The AbstractRemoteFunctionQuery going to execute.

Returns:

The AbstractRemoteFunctionQueryResult created by the query.

Throws:

QueryExecutionException - if an exception occurred during the execute implementation.

commit

void commit(@Nonnull
            ErpConfigContext configContext,
            @Nonnull
            QueryT query)
     throws QueryExecutionException

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

Parameters:

configContext - The ErpConfigContext of this call.

query - The AbstractRemoteFunctionQuery that was executed.

Throws:

QueryExecutionException - If an exception occurred during the commit implementation.

rollback

void rollback(@Nonnull
              ErpConfigContext configContext,
              @Nonnull
              QueryT query)
       throws QueryExecutionException

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

Parameters:

configContext - The ErpConfigContext of this call.

query - The AbstractRemoteFunctionQuery that was executed.

Throws:

QueryExecutionException - 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.