com.sap.cloud.sdk.datamodel.odatav4.core

Class SingleValueActionRequestBuilder<ResultT>

java.lang.Object

com.sap.cloud.sdk.datamodel.odatav4.core.ActionRequestBuilder<SingleValueActionRequestBuilder<ResultT>,ActionResponseSingle<ResultT>>

com.sap.cloud.sdk.datamodel.odatav4.core.SingleValueActionRequestBuilder<ResultT>

Type Parameters:

ResultT - The type of the result entity or complex type or primitive type, if any. For actions that return a single value or nothing, the result is wrapped inside a instance.

All Implemented Interfaces:

ModificationRequestBuilder<ActionResponseSingle<ResultT>>, RequestBuilder<ActionResponseSingle<ResultT>>, RequestBuilderExecutable<ActionResponseSingle<ResultT>>

public class SingleValueActionRequestBuilder<ResultT>
extends ActionRequestBuilder<SingleValueActionRequestBuilder<ResultT>,ActionResponseSingle<ResultT>>

Representation of an OData action request as a fluent interface for further configuring the request and executing it. This one handles actions where the return type is a single primitive or entity value or complex type. It also handles actions with no return type.

Constructor Summary

Constructors

Constructor and Description
SingleValueActionRequestBuilder(String servicePath, String actionName, Class<ResultT> resultClass) Instantiates this request builder using the given service path to send the requests.
SingleValueActionRequestBuilder(String servicePath, String actionName, Map<String,Object> parameters, Class<ResultT> resultClass) Instantiates this request builder using the given service path to send the requests.

Method Summary

Modifier and Type	Method and Description
ActionResponseSingle<ResultT>	execute(HttpDestinationProperties destination) Execute the OData request.
protected Map<String,String>	getHeaders() A map containing the headers to be used only for the actual request of this FluentHelper implementation.
protected List<ODataRequestListener>	getListeners()
protected Map<String,String>	getParametersForRequestOnly() A map containing the custom query parameters to be used only for the actual request of this FluentHelper implementation.
protected ODataResourcePath	getResourcePath()
protected Class<ResultT>	getResultClass()
protected String	getServicePath()
protected BuilderT	getThis() Get the reference to this instance.
BuilderT	withHeader(String key, String value) Gives the option to specify custom HTTP headers.
BuilderT	withHeaders(Map<String,String> map) Gives the option to specify a map of custom HTTP headers.
BuilderT	withListener(ODataRequestListener listener) An error handling class that implements the error result handler interface can be attached to this request builder.
BuilderT	withQueryParameter(String key, String value) Gives the option to specify custom query parameters for the request.

Methods inherited from class com.sap.cloud.sdk.datamodel.odatav4.core.ActionRequestBuilder

toRequest

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.sap.cloud.sdk.datamodel.odatav4.core.RequestBuilder

withHeader, withHeaders

Methods inherited from interface com.sap.cloud.sdk.datamodel.odatav4.core.RequestBuilderExecutable

tryExecute

Constructor Detail

SingleValueActionRequestBuilder

public SingleValueActionRequestBuilder(@Nonnull
                                       String servicePath,
                                       @Nonnull
                                       String actionName,
                                       @Nonnull
                                       Class<ResultT> resultClass)

Instantiates this request builder using the given service path to send the requests.

Parameters:

servicePath - The service path to direct the requests to.

actionName - The name of the unbound action

resultClass - The expected return type of the action.

SingleValueActionRequestBuilder

public SingleValueActionRequestBuilder(@Nonnull
                                       String servicePath,
                                       @Nonnull
                                       String actionName,
                                       @Nonnull
                                       Map<String,Object> parameters,
                                       @Nonnull
                                       Class<ResultT> resultClass)

Instantiates this request builder using the given service path to send the requests.

Parameters:

servicePath - The service path to direct the requests to.

actionName - The name of the unbound action

parameters - The parameters passed to the action.

resultClass - The expected return type of the action.

Method Detail

execute

@Nonnull
public ActionResponseSingle<ResultT> execute(@Nonnull
                                                      HttpDestinationProperties destination)

Description copied from interface: RequestBuilderExecutable

Execute the OData request.

Parameters:

destination - The destination to be used as request target.

Returns:

The generic OData response result.

getResultClass

protected Class<ResultT> getResultClass()

getThis

@Nonnull
protected BuilderT getThis()

Get the reference to this instance.

Returns:

The FluentHelper instance.

withListener

@Nonnull
 @Beta
public BuilderT withListener(@Nonnull
                                             ODataRequestListener listener)

An error handling class that implements the error result handler interface can be attached to this request builder. This allows custom logic to be called when an error occurs in the execute method. If this method is not called, then an instance of ODataRequestListener is used. Only one handler can be attached at a time per request builder object, so calling this multiple times will replace the handler.

Parameters:

listener - Instance of an error handler class that implements the error result handler interface.

Returns:

The same request builder with its error handler set to the provided object.

withHeader

@Nonnull
public BuilderT withHeader(@Nonnull
                                    String key,
                                    @Nullable
                                    String value)

Description copied from interface: RequestBuilder

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

Specified by:

withHeader in interface RequestBuilder<ResultT>

Parameters:

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

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

Returns:

A request builder to specify further headers and their intended usage.

withHeaders

@Nonnull
public BuilderT withHeaders(@Nonnull
                                     Map<String,String> map)

Description copied from interface: RequestBuilder

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.

Specified by:

withHeaders in interface RequestBuilder<ResultT>

Parameters:

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

Returns:

A request builder to specify further headers and their intended usage.

withQueryParameter

@Nonnull
 @Beta
public BuilderT withQueryParameter(@Nonnull
                                                   String key,
                                                   @Nullable
                                                   String value)

Gives the option to specify custom query parameters for the request.

Note: It is recommended to only use this function for query parameters which are not supported by the VDM by default. Using this function to bypass request builder method calls can lead to unsupported response handling. There is no contract on the order or priority of parameters added to the request.

Example: Use the request query option $search to reduce the result set, leaving only entities which match the specified search expression. This feature is supported in protocol OData v4.

 new DefaultBusinessPartnerService().getAllBusinessPartner().withQueryParameter("$search", "Köln OR Cologne")
 

Parameters:

key - Name of the query parameter.

value - Value of the query parameter.

Returns:

The same request builder.

getServicePath

@Nonnull
protected String getServicePath()

getResourcePath

@Nonnull
protected ODataResourcePath getResourcePath()

getHeaders

@Nonnull
protected Map<String,String> getHeaders()

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

getParametersForRequestOnly

@Nonnull
protected Map<String,String> getParametersForRequestOnly()

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

getListeners

@Nonnull
protected List<ODataRequestListener> getListeners()