com.sap.cloud.sdk.s4hana.connectivity

Class ErpHttpRequestExecutor<RequestT extends Request<RequestT,RequestResultT>,RequestResultT extends RequestResult<RequestT,RequestResultT>>

java.lang.Object

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

Type Parameters:

RequestT - The type of the request to execute.

RequestResultT - The type of the result to return.

public class ErpHttpRequestExecutor<RequestT extends Request<RequestT,RequestResultT>,RequestResultT extends RequestResult<RequestT,RequestResultT>>
extends Object

A collection of methods which are commonly called during executions of a request against an ERP system.

Constructor Summary

Constructors

Constructor and Description
ErpHttpRequestExecutor()

Method Summary

Modifier and Type	Method and Description
RequestResultT	execute(HttpDestination destination, RequestT request, RequestSerializer<RequestT,RequestResultT> requestSerializer) Serializes the given request, executes it, and the deserializes the response.
String	execute(HttpDestination destination, SerializedRequest<RequestT> serializedRequest) Executes the given serializedRequest as a HttpUriRequest, returning the body of the HttpResponse received.
RequestExecutionMeasurements	getMeasurements()
protected com.sap.cloud.sdk.s4hana.connectivity.ErpHttpRequestExecutor.RequestBodyWithHeader	getRequestBodyWithHeader(HttpDestination destination, SerializedRequest<RequestT> request) Returns a wrapper object which encapsulates the HTTP request body and headers.
protected URI	getRequestUri(HttpDestination destination, SerializedRequest<RequestT> serializedRequest) Get the request URI.

Methods inherited from class java.lang.Object

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

Constructor Detail

ErpHttpRequestExecutor

public ErpHttpRequestExecutor()

Method Detail

execute

@Nonnull
public RequestResultT execute(@Nonnull
                                       HttpDestination destination,
                                       @Nonnull
                                       RequestT request,
                                       @Nonnull
                                       RequestSerializer<RequestT,RequestResultT> requestSerializer)
                                throws RequestSerializationException,
                                       RequestExecutionException,
                                       DestinationNotFoundException,
                                       DestinationAccessException

Serializes the given request, executes it, and the deserializes the response.

Parameters:

destination - The HttpDestination of this call.

request - The Request to be executed.

requestSerializer - The RequestSerializer to be used to write the request and read the response.

Returns:

The body of the response received by the given request.

Throws:

RequestSerializationException - If the request could not be serialized

RequestExecutionException - If any Exception occured during execution of the request.

DestinationNotFoundException - If the Destination cannot be found.

DestinationAccessException - If the destination is not of type DestinationType.HTTP or there is an issue while accessing destination information.

getRequestUri

@Nonnull
protected URI getRequestUri(@Nonnull
                                     HttpDestination destination,
                                     @Nonnull
                                     SerializedRequest<RequestT> serializedRequest)

Get the request URI.

Parameters:

destination - The destination which is used for the HTTP request.

serializedRequest - The serialized request payload.

Returns:

The target request URI.

execute

@Nonnull
public String execute(@Nonnull
                               HttpDestination destination,
                               @Nonnull
                               SerializedRequest<RequestT> serializedRequest)
                        throws RequestSerializationException,
                               RequestExecutionException,
                               DestinationNotFoundException,
                               DestinationAccessException

Executes the given serializedRequest as a HttpUriRequest, returning the body of the HttpResponse received.

Parameters:

destination - The HttpDestination of this call.

serializedRequest - The SerializedRequest to execute.

Returns:

The body of the response received by the given request.

Throws:

RequestSerializationException - If the request could not be serialized.

RequestExecutionException - If any Exception occured during execution of the request.

DestinationNotFoundException - If the Destination cannot be found.

DestinationAccessException - If the destination is not of type DestinationType.HTTP or there is an issue while accessing destination information.

getRequestBodyWithHeader

@Nonnull
protected com.sap.cloud.sdk.s4hana.connectivity.ErpHttpRequestExecutor.RequestBodyWithHeader getRequestBodyWithHeader(HttpDestination destination,
                                                                                                                               @Nonnull
                                                                                                                               SerializedRequest<RequestT> request)

Returns a wrapper object which encapsulates the HTTP request body and headers. This method can be overridden to manipulate the request before submitting, e.g. signing queries, adding timestamps.

Parameters:

destination - The HttpDestination of this call.

request - The Request to be executed.

Returns:

The request body with header.

getMeasurements

public RequestExecutionMeasurements getMeasurements()