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

Class FluentHelperFunction<FluentHelperT,ObjectT,ResultT>

java.lang.Object

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

com.sap.cloud.sdk.datamodel.odata.helper.FluentHelperFunction<FluentHelperT,ObjectT,ResultT>

Type Parameters:

FluentHelperT - The fluent helper type.

ObjectT - The type of the object this OData request operates on, if any.

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

Direct Known Subclasses:

AddEventDrivenKanbanContainerFluentHelper, AddSerialNumberToDeliveryItemFluentHelper, AddSerialNumberToDeliveryItemFluentHelper, AdoptFluentHelper, AssignAltDateToDocInfoRecdObjectMgmtRecFluentHelper, AssignAltDateToMaterialObjectMgmtRecFluentHelper, AssignAltDateToMatlBOMObjectMgmtRecFluentHelper, AssignAlternativeDateToObjectMgmtRecordFluentHelper, AssignWarehouseOrderFluentHelper, BOMComparisonFluentHelper, CalculateAvailabilityTimeseriesFluentHelper, CancelFluentHelper, CancelFluentHelper, CancelFluentHelper, CancelFluentHelper, CancelFluentHelper, CancelFluentHelper, CancelItemFluentHelper, CancelProcOrdConfFluentHelper, CancelProdnOrdConfFluentHelper, CancelWarehouseTaskFluentHelper, CheckCreditBlockFluentHelper, CheckCreditBlockFluentHelper, CloseOrderFluentHelper, CloseProdnOrdFluentHelper, CompleteFluentHelper, CompleteFluentHelper, CompleteFluentHelper, CompleteTechnicallyProdnOrdFluentHelper, ConfirmPickingAllItemsFluentHelper, ConfirmPickingAllItemsFluentHelper, ConfirmPickingOneItemFluentHelper, ConfirmPickingOneItemFluentHelper, ConfirmPutawayAllItemsFluentHelper, ConfirmPutawayAllItemsFluentHelper, ConfirmPutawayAllItemsFluentHelper, ConfirmPutawayAllItemsFluentHelper, ConfirmPutawayOneItemFluentHelper, ConfirmPutawayOneItemFluentHelper, ConfirmPutawayOneItemFluentHelper, ConfirmPutawayOneItemFluentHelper, ConfirmWarehouseTaskExactFluentHelper, ConfirmWarehouseTaskHUFluentHelper, ConfirmWarehouseTaskProductFluentHelper, ConvertPlannedOrderFluentHelper, ConvertPlndOrderFluentHelper, CreateFromRFQFluentHelper, CreateUrlAsAttachmentFluentHelper, DeclareInvoiceFluentHelper, DeleteActiveTimeSeriesFluentHelper, DeleteActvCharcValCombinationFluentHelper, DeleteAllSerialNumbersFromDeliveryItemFluentHelper, DeleteAllSerialNumbersFromDeliveryItemFluentHelper, DeleteSequenceAssignmentFluentHelper, DeleteSerialNumberFromDeliveryItemFluentHelper, DeleteSerialNumberFromDeliveryItemFluentHelper, DeletionFlagOrderFluentHelper, DeletionIndOrderFluentHelper, DetermineAvailabilityAtFluentHelper, DetermineAvailabilityOfFluentHelper, DiscardFluentHelper, DiscardFromPurchasingFluentHelper, DiscardOrderFluentHelper, DiscardOrderFluentHelper, EnableForPurchasingFluentHelper, ExplodeBOMFluentHelper, ExplodeBOMFluentHelper, GetAllOriginalsFluentHelper, GetAttachmentCountFluentHelper, GetPDFFluentHelper, InitiateRecountFluentHelper, InitiateRecountOnItemFluentHelper, InspectionSubsetTrigger_valuationFluentHelper, InventoryPriceChangeFluentHelper, JobAbortFluentHelper, JobCancelFluentHelper, JobScheduleFluentHelper, JobStatusGetFluentHelper, LogoffFromWarehouseResourceFluentHelper, LogonToWarehouseResourceFluentHelper, PickAllItemsFluentHelper, PickAllItemsFluentHelper, PickAndBatchSplitOneItemFluentHelper, PickOneItemFluentHelper, PickOneItemFluentHelper, PickOneItemWithBaseQuantityFluentHelper, PickOneItemWithSalesQuantityFluentHelper, PlannedOrderScheduleFluentHelper, PostDifferencesFluentHelper, PostDifferencesOnItemFluentHelper, PostGoodsIssueFluentHelper, PostGoodsIssueFluentHelper, PostGoodsReceiptFluentHelper, PostGoodsReceiptFluentHelper, PostGoodsReceiptFluentHelper, PostGoodsReceiptFluentHelper, PutawayAllItemsFluentHelper, PutawayAllItemsFluentHelper, PutawayAllItemsFluentHelper, PutawayAllItemsFluentHelper, PutawayOneItemFluentHelper, PutawayOneItemFluentHelper, PutawayOneItemFluentHelper, PutawayOneItemFluentHelper, PutawayOneItemWithBaseQuantityFluentHelper, PutawayOneItemWithBaseQuantityFluentHelper, PutawayOneItemWithSalesQuantityFluentHelper, PutawayOneItemWithSalesQuantityFluentHelper, ReceiveInvoiceFluentHelper, RejectApprovalRequestFluentHelper, RejectApprovalRequestFluentHelper, RejectApprovalRequestFluentHelper, RejectCreditBlockFluentHelper, RejectCreditBlockFluentHelper, RejectFluentHelper, ReleaseApprovalRequestFluentHelper, ReleaseApprovalRequestFluentHelper, ReleaseApprovalRequestFluentHelper, ReleaseCreditBlockFluentHelper, ReleaseCreditBlockFluentHelper, ReleaseFluentHelper, ReleaseOperationFluentHelper, ReleaseOrderFluentHelper, ReleaseProductionOrderFluentHelper, ReleaseProductionOrderOprFluentHelper, ReleaseVersionBOMFluentHelper, ReleaseVersionBOMFluentHelper, RenameAttachmentFluentHelper, RequestClarificationFluentHelper, ResumeFluentHelper, ReverseGoodsIssueFluentHelper, ReverseGoodsIssueFluentHelper, ReverseGoodsReceiptFluentHelper, ReverseGoodsReceiptFluentHelper, ReverseGoodsReceiptFluentHelper, ReverseGoodsReceiptFluentHelper, RevokeApprovalFluentHelper, ScheduleProcessOrderOperationFluentHelper, ScheduleProductionOrderOperationFluentHelper, SendFluentHelper, SetDeltnFlagProdnOrdFluentHelper, SetDeltnIndProdnOrdFluentHelper, SetInProcessWarehouseOrderFluentHelper, SetKanbanContainerLockFluentHelper, SetKanbanContainerStatusFluentHelper, SetKanbanControlCycleLifeCycleStatusFluentHelper, SetLifecycleStatusToActiveFluentHelper, SetLifecycleStatusToInactiveFluentHelper, SetPickingQuantityWithBaseQuantityFluentHelper, SetProcessingStatusFluentHelper, SetProjElemProcessingStatusFluentHelper, SetPutawayQuantityWithBaseQuantityFluentHelper, SetPutawayQuantityWithBaseQuantityFluentHelper, ShiftValidityStartDateOfChangeMasterFluentHelper, SignoffInvoiceFluentHelper, SubmitFluentHelper, SubmitFluentHelper, SubmitForApprovalFluentHelper, SubmitForApprovalFluentHelper, SubmitForApprovalFluentHelper, SuspendFluentHelper, TechlyCmpltOrderFluentHelper, TerminateFluentHelper, UnassignAltDateFromDocInfoRecdObjMgmtRecFluentHelper, UnassignAltDateFromMaterialObjMgmtRecFluentHelper, UnassignAltDateFromMatlBOMObjMgmtRecFluentHelper, UnassignAlternativeDateFromObjMgmtRecordFluentHelper, UnassignWarehouseOrderFluentHelper, ValidateFluentHelper, WithdrawFromApprovalFluentHelper, WithdrawQuantityFromControlCycleFluentHelper, WithdrawQuantityFromKanbanContainerFluentHelper

public abstract class FluentHelperFunction<FluentHelperT,ObjectT,ResultT>
extends FluentHelperBasic<FluentHelperT,ObjectT,ResultT>

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

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
protected abstract org.apache.http.client.methods.HttpUriRequest	createRequest(URI uri) Creates a request for this function based on the given URI.
protected List<ObjectT>	executeMultiple(HttpDestinationProperties destination) Default implementation for the case that this function returns a collection of entries.
protected ObjectT	executeSingle(HttpDestinationProperties destination) Default implementation for the case that this function returns a single type.
protected abstract String	getFunctionName() The exact name of the function to be called on the OData Endpoint.
protected String	getJsonResponseObjectName() Deprecated. In order to customize JSON response parsing, use refineJsonResponse(com.google.gson.JsonElement) instead.
protected abstract Map<String,Object>	getParameters() Getter for the map of parameters to be used in the function call.
protected com.google.gson.JsonElement	refineJsonResponse(com.google.gson.JsonElement jsonElement) Transform the JSON element from the response to extract a result entity.

Methods inherited from class com.sap.cloud.sdk.datamodel.odata.helper.FluentHelperBasic

cachingMetadata, execute, getEntityClass, getHeadersForRequestAndImplicitRequests, getHeadersForRequestOnly, getParametersForRequestOnly, getServicePath, getThis, getVersionIdentifier, isCachingMetadata, withHeader, withHeaders, withoutCachingMetadata, withQueryParameter

Methods inherited from class java.lang.Object

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

Constructor Detail

FluentHelperFunction

public FluentHelperFunction(@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

getParameters

@Nonnull
protected abstract Map<String,Object> getParameters()

Getter for the map of parameters to be used in the function call.

The map maps the ODataName of a parameter to the corresponding value.

Returns:

A map containing the parameter for the function call.

getFunctionName

@Nonnull
protected abstract String getFunctionName()

The exact name of the function to be called on the OData Endpoint.

Returns:

The function name on the endpoint.

createRequest

@Nonnull
protected abstract org.apache.http.client.methods.HttpUriRequest createRequest(@Nonnull
                                                                                        URI uri)

Creates a request for this function based on the given URI.

Examples for such requests are HttpGet and HttpPost.

Parameters:

uri - The URI the request should target.

Returns:

The instantiated request.

executeSingle

@Nullable
protected ObjectT executeSingle(@Nonnull
                                          HttpDestinationProperties destination)
                                   throws com.sap.cloud.sdk.odatav2.connectivity.ODataException

Default implementation for the case that this function returns a single type.

This method can be used in subclasses to implement the FluentHelperBasic.execute(HttpDestinationProperties) method.

Parameters:

destination - The destination to run the function against.

Returns:

The single object returned by the function call. Returns null if the function did not return a result.

Throws:

com.sap.cloud.sdk.odatav2.connectivity.ODataException - If the execution of the function failed.

executeMultiple

@Nonnull
protected List<ObjectT> executeMultiple(@Nonnull
                                                 HttpDestinationProperties destination)
                                          throws com.sap.cloud.sdk.odatav2.connectivity.ODataException

Default implementation for the case that this function returns a collection of entries.

This method can be used in subclasses to implement the FluentHelperBasic.execute(HttpDestinationProperties) method.

Parameters:

destination - The destination to run the function against.

Returns:

A list of the objects returned by the function call. Returns an empty list if the function did not return a result.

Throws:

com.sap.cloud.sdk.odatav2.connectivity.ODataException - If the execution of the function failed.

getJsonResponseObjectName

@Deprecated
 @Nonnull
protected String getJsonResponseObjectName()

Deprecated. In order to customize JSON response parsing, use refineJsonResponse(com.google.gson.JsonElement) instead.

Get the name of the JSON object, which contains the result entity. The default implementation uses the provided function name.

Returns:

The name of the expected JSON object

refineJsonResponse

@Nullable
protected com.google.gson.JsonElement refineJsonResponse(@Nullable
                                                                   com.google.gson.JsonElement jsonElement)

Transform the JSON element from the response to extract a result entity. By default this method returns the original object.

Parameters:

jsonElement - The optional response JSON element

Returns:

The refined JSON element