com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.productmaster

Class ProductByKeyFluentHelper

java.lang.Object

com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.productmaster.ProductByKeyFluentHelper

public class ProductByKeyFluentHelper
extends Object

Fluent helper to fetch a single Product entity using key fields. This fluent helper allows methods which modify the underlying query to be called before executing the query itself.

Constructor Summary

Constructors

Constructor and Description
ProductByKeyFluentHelper(String product) Creates a fluent helper object that will fetch a single Product entity with the provided key field values.

Method Summary

Modifier and Type	Method and Description
Product	execute() Executes the underlying query using the stored key field values, plus any query modifiers that were previously called.
Product	execute(ErpConfigContext erpConfigContext) Executes the underlying query using the stored key field values, plus any query modifiers that were previously called.
Product	execute(ErpEndpoint erpEndpoint) Executes the underlying query using the stored key field values, plus any query modifiers that were previously called.
ProductByKeyFluentHelper	select(EntityField<Product,?>... fields) Query modifier to limit which field values within an entity get fetched & populated.
com.sap.cloud.sdk.odatav2.connectivity.ODataQuery	toQuery() Provides access to the underlying Query object, to allow for custom integration scenarios not yet supported by the virtual data model.
ProductByKeyFluentHelper	withErrorHandler(com.sap.cloud.sdk.odatav2.connectivity.ErrorResultHandler<?> errorResultHandler) An error handling class that implements the ErrorResultHandler interface can be attached to this fluent helper.

Methods inherited from class java.lang.Object

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

Constructor Detail

ProductByKeyFluentHelper

public ProductByKeyFluentHelper(String product)

Creates a fluent helper object that will fetch a single Product entity with the provided key field values. To perform execution, call the execute method on the fluent helper object.

Parameters:

product - Alphanumeric key uniquely identifying the product.

Constraints: Not nullable, Maximum length: 40

Method Detail

select

@SafeVarargs
public final ProductByKeyFluentHelper select(EntityField<Product,?>... fields)

Query modifier to limit which field values within an entity get fetched & populated. If this method is never called, then all fields will be fetched & populated. But if this method is called at least once, then only the specified fields will be fetched & populated. Calling this multiple times will combine the set(s) of fields of each call.

Parameters:

fields - Fields to fetch & populate. See Product for available fields.

Returns:

The same fluent helper with this query modifier applied.

toQuery

public com.sap.cloud.sdk.odatav2.connectivity.ODataQuery toQuery()

Provides access to the underlying Query object, to allow for custom integration scenarios not yet supported by the virtual data model.

Returns:

The underlying query object.

withErrorHandler

public ProductByKeyFluentHelper withErrorHandler(com.sap.cloud.sdk.odatav2.connectivity.ErrorResultHandler<?> errorResultHandler)

An error handling class that implements the ErrorResultHandler interface can be attached to this fluent helper. 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 ODataVdmErrorResultHandler is used. Only one handler can be attached at a time per fluent helper object, so calling this multiple times will replace the handler.

Parameters:

errorResultHandler - Instance of an error handler class that implements the ErrorResultHandler interface.

Returns:

The same fluent helper with its error handler set to the provided object.

execute

public Product execute(ErpEndpoint erpEndpoint)
                throws com.sap.cloud.sdk.odatav2.connectivity.ODataException

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

Parameters:

erpEndpoint - Supply the ERP system instance for executing the underlying OData query.

Returns:

An Product 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(), ErpEndpoint.ErpEndpoint(ErpConfigContext)

execute

public Product execute(ErpConfigContext erpConfigContext)
                throws com.sap.cloud.sdk.odatav2.connectivity.ODataException

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

Parameters:

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

Returns:

An Product 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(), ErpEndpoint.ErpEndpoint(ErpConfigContext)

execute

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

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

The default ERP configuration context will be used.

Returns:

An Product 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(), ErpEndpoint.ErpEndpoint(ErpConfigContext)