com.sap.cloud.sdk.s4hana.datamodel.odata.helper

Class FluentHelperBasic<FluentHelperT,EntityT,ResultT>

java.lang.Object

com.sap.cloud.sdk.s4hana.datamodel.odata.helper.FluentHelperBasic<FluentHelperT,EntityT,ResultT>

Type Parameters:

FluentHelperT - The fluent helper type.

EntityT - The type of the entity this OData request operates on, if any.

ResultT - The type of the result entity, if any.

Direct Known Subclasses:

FluentHelperByKey, FluentHelperCreate, FluentHelperDelete, FluentHelperFunction, FluentHelperRead, FluentHelperUpdate

public abstract class FluentHelperBasic<FluentHelperT,EntityT,ResultT>
extends Object

Representation of any OData request as a fluent interface for further configuring the request and executing it.

Constructor Summary

Constructors

Constructor and Description
FluentHelperBasic(String servicePath) Instantiates this fluent helper using the given service path to send the requests.

Method Summary

Modifier and Type	Method and Description
ODataRequestCommand<ResultT>	asResilientCommand() This method will take the OData requests on which it is called and return an ODataRequestCommand that wraps the request.
ODataRequestCommand<ResultT>	asResilientCommand(ErpConfigContext configContext) This method will take the OData requests on which it is called and return an ODataRequestCommand that wraps the request and will use the given ERP configuration context for executing the request.
ResultT	execute() Executes the underlying query using the stored values, plus any query modifiers that were previously called.
abstract ResultT	execute(ErpConfigContext configContext) Executes the underlying query using the stored values, plus any query modifiers that were previously called.
protected abstract Class<? extends EntityT>	getEntityClass() Returns a class object of the type this fluent helper works with.
protected Map<String,String>	getHeadersForRequestAndImplicitRequests() A map containing the header to be used for all implicit requests that are part of this FluentHelper implementation (metadata, csrf, ...).
protected Map<String,String>	getHeadersForRequestOnly() A map containing the header to be used only for the actual request of this FluentHelper implementation.
protected String	getServicePath()
protected FluentHelperT	getThis()
protected String	getVersionIdentifier(com.sap.cloud.sdk.odatav2.connectivity.internal.ODataHttpResponseWrapper response)
FluentHelperCustomHttpHeader<FluentHelperT>	withCustomHttpHeader(String key, String value) Gives the option to specify custom HTTP headers.
FluentHelperCustomHttpHeader<FluentHelperT>	withCustomHttpHeaders(Map<String,String> map) Gives the option to specify a map of custom HTTP headers.

Methods inherited from class java.lang.Object

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

Constructor Detail

FluentHelperBasic

public FluentHelperBasic(@Nonnull
                         String servicePath)

Instantiates this fluent helper using the given service path to send the requests.

Parameters:

servicePath - The service path to direct the requests to.

Method Detail

getEntityClass

@Nonnull
protected abstract Class<? extends EntityT> getEntityClass()

Returns a class object of the type this fluent helper works with.

Returns:

A class object of the handled type.

getThis

@Nonnull
protected FluentHelperT getThis()

execute

public abstract ResultT execute(@Nonnull
                                ErpConfigContext configContext)
                         throws com.sap.cloud.sdk.odatav2.connectivity.ODataException

Executes the underlying query using the stored values, plus any query modifiers that were previously called.

Parameters:

configContext - Supply the ERP system context for executing the underlying OData query.

Returns:

A single entity if the query execution is successful. If the underlying OData request fails, then an ODataException is thrown, and the error handler class attached to this fluent helper will be called.

Throws:

com.sap.cloud.sdk.odatav2.connectivity.ODataException

See Also:

ErpConfigContext.ErpConfigContext()

execute

public ResultT execute()
                throws com.sap.cloud.sdk.odatav2.connectivity.ODataException

Executes the underlying query using the stored values, plus any query modifiers that were previously called.

The default ERP configuration context will be used.

Returns:

A single result element if the query execution is successful. If the underlying OData request fails, then an ODataException is thrown, and the error handler class attached to this fluent helper will be called.

Throws:

com.sap.cloud.sdk.odatav2.connectivity.ODataException

See Also:

ErpConfigContext.ErpConfigContext()

withCustomHttpHeader

@Nonnull
public FluentHelperCustomHttpHeader<FluentHelperT> withCustomHttpHeader(@Nonnull
                                                                                 String key,
                                                                                 @Nullable
                                                                                 String value)

Gives the option to specify custom HTTP headers. The returned object allows to specify the requests the headers should be used in.

Parameters:

key - Name of the (first) desired HTTP header parameter.

value - Value of the (first) desired HTTP header parameter.

Returns:

A fluent helper to specify further headers and their intended usage.

withCustomHttpHeaders

@Nonnull
public FluentHelperCustomHttpHeader<FluentHelperT> withCustomHttpHeaders(@Nonnull
                                                                                  Map<String,String> map)

Gives the option to specify a map of custom HTTP headers. The returned object allows to specify the requests the headers should be used in.

Parameters:

map - A map of HTTP header key/value pairs.

Returns:

A fluent helper to specify further headers and their intended usage.

getVersionIdentifier

@Nullable
protected String getVersionIdentifier(@Nonnull
                                                com.sap.cloud.sdk.odatav2.connectivity.internal.ODataHttpResponseWrapper response)

asResilientCommand

@Nonnull
public ODataRequestCommand<ResultT> asResilientCommand(@Nonnull
                                                                ErpConfigContext configContext)

This method will take the OData requests on which it is called and return an ODataRequestCommand that wraps the request and will use the given ERP configuration context for executing the request. Note, that the command returned by this method has no fallback configured. You can do so by using the method ODataRequestCommand.withFallback(Function).

Parameters:

configContext - Supply the ERP system context for executing the underlying OData query.

Returns:

An ODataRequestCommand wrapping the OData request.

asResilientCommand

@Nonnull
public ODataRequestCommand<ResultT> asResilientCommand()

This method will take the OData requests on which it is called and return an ODataRequestCommand that wraps the request. The command will use the default ERP configuration context. Note, that the command returned by this method has no fallback configured. You can do so by using the function ODataRequestCommand.withFallback(Function).

Returns:

An ODataRequestCommand wrapping the OData request.

getServicePath

@Nonnull
protected String getServicePath()

getHeadersForRequestAndImplicitRequests

protected Map<String,String> getHeadersForRequestAndImplicitRequests()

A map containing the header to be used for all implicit requests that are part of this FluentHelper implementation (metadata, csrf, ...).

getHeadersForRequestOnly

protected Map<String,String> getHeadersForRequestOnly()

A map containing the header to be used only for the actual request of this FluentHelper implementation.