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

Interface RemoteFunctionQueryErrorHandler

public interface RemoteFunctionQueryErrorHandler

Gets invoked after the execution of an AbstractRemoteFunctionQuery and allows to inspect and react on the AbstractRemoteFunctionQueryResult.

Example:

You may implement and register your own RemoteFunctionQueryErrorHandler for the invocation of BAPIs. You want to introduce special treament for a certain error message of the invoked BAPI. In your own RemoteFunctionQueryErrorHandler you gain access to the query result and can react accordingly.

Note: The query execution logic of AbstractRemoteFunctionQuery using a CommitStrategy that includes a commit in the remote system (CommitStrategy.COMMIT_SYNC, CommitStrategy.COMMIT_ASYNC) invokes a rollback in the remote system if the used RemoteFunctionQueryErrorHandler throws a RemoteFunctionException. Otherwise, no rollback is invoked the remote system.

Method Summary

Modifier and Type	Method and Description
<QueryT extends AbstractRemoteFunctionQuery<QueryT,QueryResultT>,QueryResultT extends AbstractRemoteFunctionQueryResult<QueryT,QueryResultT>> Optional<RemoteFunctionException>	handleQueryResult(QueryResultT queryResult) Allows to inspect the query result after the query execution and react accordingly.

Method Detail

handleQueryResult

@Nonnull
<QueryT extends AbstractRemoteFunctionQuery<QueryT,QueryResultT>,QueryResultT extends AbstractRemoteFunctionQueryResult<QueryT,QueryResultT>> Optional<RemoteFunctionException> handleQueryResult(@Nonnull
                                                                                                                                                                                                           QueryResultT queryResult)

Allows to inspect the query result after the query execution and react accordingly. In order to indicate an error situation, you may return a RemoteFunctionException or one subclass encapsulated in an Optional. Otherwise, return an empty Optional. In case of an error situation, the query exceution logic triggers a rollback in the remote system if a CommitStrategy including commit behaviour is used.

Type Parameters:

QueryT - The type of the query

QueryResultT - the type of the query result

Parameters:

queryResult - The query result to inspect

Returns:

Optional containing a RemoteFunctionException or being empty.