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

Class CountryByKeyFluentHelper

java.lang.Object

com.sap.cloud.sdk.s4hana.datamodel.odata.namespaces.readcountry.CountryByKeyFluentHelper

public class CountryByKeyFluentHelper
extends Object

Fluent helper to fetch a single Country 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
CountryByKeyFluentHelper(String country) Creates a fluent helper object that will fetch a single Country entity with the provided key field values.

Method Summary

Modifier and Type	Method and Description
Country	execute() Executes the underlying query using the stored key field values, plus any query modifiers that were previously called.
Country	execute(ErpConfigContext erpConfigContext) Executes the underlying query using the stored key field values, plus any query modifiers that were previously called.
Country	execute(ErpEndpoint erpEndpoint) Executes the underlying query using the stored key field values, plus any query modifiers that were previously called.
CountryByKeyFluentHelper	select(EntityField<Country,?>... 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.
CountryByKeyFluentHelper	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

CountryByKeyFluentHelper

public CountryByKeyFluentHelper(String country)

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

Parameters:

country - Here you specify the country key for the customer or vendor.

Constraints: Not nullable, Maximum length: 3

Method Detail

select

@SafeVarargs
public final CountryByKeyFluentHelper select(EntityField<Country,?>... 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 Country 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 CountryByKeyFluentHelper 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 Country 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 Country 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 Country 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 Country 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 Country 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 Country 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)