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

Class JCoTransaction<RequestT extends AbstractRemoteFunctionRequest<RequestT,RequestResultT>,RequestResultT extends AbstractRemoteFunctionRequestResult<RequestT,RequestResultT>>

java.lang.Object

com.sap.cloud.sdk.s4hana.connectivity.rfc.JCoTransaction<RequestT,RequestResultT>

Type Parameters:

RequestT - The type of the request to execute.

RequestResultT - The type of the result to return.

All Implemented Interfaces:

Transaction<RequestT,RequestResultT>

public class JCoTransaction<RequestT extends AbstractRemoteFunctionRequest<RequestT,RequestResultT>,RequestResultT extends AbstractRemoteFunctionRequestResult<RequestT,RequestResultT>>
extends Object
implements Transaction<RequestT,RequestResultT>

Implementation of the Transaction interface to be used for JCo queries.

Constructor Summary

Constructors

Constructor and Description
JCoTransaction(String destinationName, Supplier<RequestResultT> requestResultFactory) Constructs a JCoTransaction for the given destinationName and requestResultFactory.

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 Transaction.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.
protected List<com.sap.cloud.sdk.s4hana.connectivity.rfc.AbstractRemoteFunctionRequestResult.Result>	getReturnParameterResults(RequestResultT result)
void	rollback(Destination destination, RequestT request) If there was a problem with Transaction.execute(Destination, AbstractRemoteFunctionRequest) or Transaction.commit(Destination, AbstractRemoteFunctionRequest) this method will get called to rollback any unwanted changes.

Methods inherited from class java.lang.Object

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

Constructor Detail

JCoTransaction

public JCoTransaction(@Nonnull
                      String destinationName,
                      @Nonnull
                      Supplier<RequestResultT> requestResultFactory)
               throws RemoteFunctionException

Constructs a JCoTransaction for the given destinationName and requestResultFactory.

Parameters:

destinationName - Name of the destination to be used.

requestResultFactory - Provider to be used to create a RequestResultT object.

Throws:

RemoteFunctionException - If there was an error while getting the actual destionation for the given destinationName.

Method Detail

before

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

Description copied from interface: Transaction

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

Specified by:

before in interface Transaction<RequestT extends AbstractRemoteFunctionRequest<RequestT,RequestResultT>,RequestResultT extends AbstractRemoteFunctionRequestResult<RequestT,RequestResultT>>

Parameters:

destination - The Destination of this call.

request - The AbstractRemoteFunctionRequest going to be executed.

execute

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

Description copied from interface: Transaction

The actual logic to be executed.

Specified by:

execute in interface Transaction<RequestT extends AbstractRemoteFunctionRequest<RequestT,RequestResultT>,RequestResultT extends AbstractRemoteFunctionRequestResult<RequestT,RequestResultT>>

Parameters:

destination - The Destination of this call.

request - The AbstractRemoteFunctionRequest going to execute.

Returns:

The AbstractRemoteFunctionRequestResult created by the request.

Throws:

RemoteFunctionException

getReturnParameterResults

protected List<com.sap.cloud.sdk.s4hana.connectivity.rfc.AbstractRemoteFunctionRequestResult.Result> getReturnParameterResults(RequestResultT result)

commit

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

Description copied from interface: Transaction

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

Specified by:

commit in interface Transaction<RequestT extends AbstractRemoteFunctionRequest<RequestT,RequestResultT>,RequestResultT extends AbstractRemoteFunctionRequestResult<RequestT,RequestResultT>>

Parameters:

destination - The Destination of this call.

request - The AbstractRemoteFunctionRequest that was executed.

Throws:

RequestExecutionException - If an exception occurred during the commit implementation.

rollback

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

Description copied from interface: Transaction

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

Specified by:

rollback in interface Transaction<RequestT extends AbstractRemoteFunctionRequest<RequestT,RequestResultT>,RequestResultT extends AbstractRemoteFunctionRequestResult<RequestT,RequestResultT>>

Parameters:

destination - The Destination of this call.

request - The AbstractRemoteFunctionRequest that was executed.

Throws:

RequestExecutionException - If an exception occurred during the rollback implementation.

RequestSerializationException

after

public void after()
           throws RemoteFunctionException

Description copied from interface: Transaction

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

Specified by:

after in interface Transaction<RequestT extends AbstractRemoteFunctionRequest<RequestT,RequestResultT>,RequestResultT extends AbstractRemoteFunctionRequestResult<RequestT,RequestResultT>>

Throws:

RemoteFunctionException - If an exception occurred during the after implementation.