io.sphere.sdk.zones.queries

Interface ZoneQuery

All Superinterfaces:

ExpansionPathContainer<Zone>, MetaModelQueryDsl<Zone,ZoneQuery,ZoneQueryModel,ZoneExpansionModel<Zone>>, MetaModelReferenceExpansionDsl<Zone,ZoneQuery,ZoneExpansionModel<Zone>>, Query<Zone>, QueryDsl<Zone,ZoneQuery>, ReferenceExpansionDsl<Zone,ZoneQuery>, ReferenceExpansionSupport<Zone>, ResourceQuery<Zone>, SphereRequest<PagedQueryResult<Zone>>

public interface ZoneQuery
extends MetaModelQueryDsl<Zone,ZoneQuery,ZoneQueryModel,ZoneExpansionModel<Zone>>

{@doc.gen summary zones

Field Summary

Fields inherited from interface io.sphere.sdk.queries.Query

MAX_OFFSET, MIN_OFFSET

Method Summary

Modifier and Type	Method and Description
default ZoneQuery	byCountry(com.neovisionaries.i18n.CountryCode countryCode) Predicate which matches the country of a location, does not take the state into the consideration.
default ZoneQuery	byLocation(Location location) Predicate which matches the country and state of a location.
default ZoneQuery	byName(String name)
static ZoneQuery	of()
ZoneQuery	plusExpansionPaths(Function<ZoneExpansionModel<Zone>,ExpansionPathContainer<Zone>> m) Creates a new object with the properties of the old object but adds a new expansion path to it by using meta models.
ZoneQuery	plusPredicates(Function<ZoneQueryModel,QueryPredicate<Zone>> m) Returns a new instance with the new predicate appended (AND semantics).
ZoneQuery	plusPredicates(List<QueryPredicate<Zone>> queryPredicates) Returns a new instance with the new predicate list appended to the existing predicates (AND semantic).
ZoneQuery	plusPredicates(QueryPredicate<Zone> queryPredicate) Returns a new instance with the new predicate appended to the existing predicates (AND semantic).
ZoneQuery	plusSort(Function<ZoneQueryModel,QuerySort<Zone>> m) Returns a query with the sort expression appended to the existing ones.
ZoneQuery	plusSort(List<QuerySort<Zone>> sort) Returns a query with the sort expressions appended to the existing ones.
ZoneQuery	plusSort(QuerySort<Zone> sort) Returns a query with the sort expression appended to the existing ones.
static com.fasterxml.jackson.core.type.TypeReference<PagedQueryResult<Zone>>	resultTypeReference() Creates a container which contains the full Java type information to deserialize the query result (NOT this class) from JSON.
ZoneQuery	withExpansionPaths(Function<ZoneExpansionModel<Zone>,ExpansionPathContainer<Zone>> m) Creates a new object with the properties of the old object but replaces all expansion paths with a single expansionPath by using meta models.
ZoneQuery	withFetchTotal(boolean fetchTotal) Enables/disables a flag it the total amount of items should be counted.
ZoneQuery	withLimit(Long limit) Creates a new instance which a limited amount of results.
ZoneQuery	withOffset(Long offset) Returns a new query with the new offset as offset.
ZoneQuery	withPredicates(Function<ZoneQueryModel,QueryPredicate<Zone>> predicateFunction) Returns a new instance with the new predicate as only predicate.
ZoneQuery	withPredicates(List<QueryPredicate<Zone>> queryPredicates) Returns a new instance with the new predicate list as predicates.
ZoneQuery	withPredicates(QueryPredicate<Zone> queryPredicate) Returns a new instance with the new predicate as only predicate.
ZoneQuery	withSort(Function<ZoneQueryModel,QuerySort<Zone>> m) Returns a query with the new sort as only sort parameter.
ZoneQuery	withSort(List<QuerySort<Zone>> sort) Returns a query with the new sort list as only sort parameters.
ZoneQuery	withSort(QuerySort<Zone> sort) Returns a query with the new sort as only sort parameter.
ZoneQuery	withSortMulti(Function<ZoneQueryModel,List<QuerySort<Zone>>> m) Returns a query with the new sort list as only sort parameters.

Methods inherited from interface io.sphere.sdk.queries.MetaModelQueryDsl

plusPredicates, plusSort, withPredicates, withQueryParam, withSort

Methods inherited from interface io.sphere.sdk.queries.QueryDsl

withLimit, withOffset

Methods inherited from interface io.sphere.sdk.queries.ResourceQuery

endpoint, expansionPaths, fetchTotal, limit, offset, predicates, sort

Methods inherited from interface io.sphere.sdk.queries.Query

deserialize, toQuery

Methods inherited from interface io.sphere.sdk.client.SphereRequest

canDeserialize, httpRequestIntent

Methods inherited from interface io.sphere.sdk.expansion.ReferenceExpansionDsl

plusExpansionPaths, plusExpansionPaths, plusExpansionPaths, plusExpansionPaths, withExpansionPaths, withExpansionPaths, withExpansionPaths, withExpansionPaths

Method Detail

resultTypeReference

static com.fasterxml.jackson.core.type.TypeReference<PagedQueryResult<Zone>> resultTypeReference()

Creates a container which contains the full Java type information to deserialize the query result (NOT this class) from JSON.

Returns:

type reference

See Also:

SphereJsonUtils.readObject(byte[], TypeReference), SphereJsonUtils.readObject(String, TypeReference), SphereJsonUtils.readObject(com.fasterxml.jackson.databind.JsonNode, TypeReference), SphereJsonUtils.readObjectFromResource(String, TypeReference)

of

static ZoneQuery of()

plusPredicates

ZoneQuery plusPredicates(Function<ZoneQueryModel,QueryPredicate<Zone>> m)

Description copied from interface: MetaModelQueryDsl

Returns a new instance with the new predicate appended (AND semantics).

Specified by:

plusPredicates in interface MetaModelQueryDsl<Zone,ZoneQuery,ZoneQueryModel,ZoneExpansionModel<Zone>>

Parameters:

m - function given a meta model description of the model return a QueryPredicate

Returns:

instance with the predicate appended

See Also:

MetaModelQueryDsl.withPredicates(Function)

plusPredicates

ZoneQuery plusPredicates(QueryPredicate<Zone> queryPredicate)

Description copied from interface: QueryDsl

Returns a new instance with the new predicate appended to the existing predicates (AND semantic).

Specified by:

plusPredicates in interface MetaModelQueryDsl<Zone,ZoneQuery,ZoneQueryModel,ZoneExpansionModel<Zone>>

Specified by:

plusPredicates in interface QueryDsl<Zone,ZoneQuery>

Parameters:

queryPredicate - the new predicate

Returns:

instance with the existing predicate list plus the new predicate list

See Also:

QueryDsl.withPredicates(QueryPredicate)

plusPredicates

ZoneQuery plusPredicates(List<QueryPredicate<Zone>> queryPredicates)

Description copied from interface: QueryDsl

Returns a new instance with the new predicate list appended to the existing predicates (AND semantic).

Specified by:

plusPredicates in interface MetaModelQueryDsl<Zone,ZoneQuery,ZoneQueryModel,ZoneExpansionModel<Zone>>

Specified by:

plusPredicates in interface QueryDsl<Zone,ZoneQuery>

Parameters:

queryPredicates - the new predicate list

Returns:

instance with the existing predicate list plus the new predicate list

See Also:

QueryDsl.withPredicates(List)

plusSort

ZoneQuery plusSort(Function<ZoneQueryModel,QuerySort<Zone>> m)

Description copied from interface: MetaModelQueryDsl

Returns a query with the sort expression appended to the existing ones.

Specified by:

plusSort in interface MetaModelQueryDsl<Zone,ZoneQuery,ZoneQueryModel,ZoneExpansionModel<Zone>>

Parameters:

m - function given a meta model description of the model returns a list of QuerySort

Returns:

Query with sort

See Also:

MetaModelQueryDsl.withSort(Function)

plusSort

ZoneQuery plusSort(List<QuerySort<Zone>> sort)

Description copied from interface: QueryDsl

Returns a query with the sort expressions appended to the existing ones.

Specified by:

plusSort in interface MetaModelQueryDsl<Zone,ZoneQuery,ZoneQueryModel,ZoneExpansionModel<Zone>>

Specified by:

plusSort in interface QueryDsl<Zone,ZoneQuery>

Parameters:

sort - sort expressions how the results of the query should be sorted

Returns:

Query with sort

See Also:

QueryDsl.withSort(List)

plusSort

ZoneQuery plusSort(QuerySort<Zone> sort)

Description copied from interface: QueryDsl

Returns a query with the sort expression appended to the existing ones.

Specified by:

plusSort in interface MetaModelQueryDsl<Zone,ZoneQuery,ZoneQueryModel,ZoneExpansionModel<Zone>>

Specified by:

plusSort in interface QueryDsl<Zone,ZoneQuery>

Parameters:

sort - sort expression how the results of the query should be sorted

Returns:

Query with sort

See Also:

QueryDsl.withSort(QuerySort)

withPredicates

ZoneQuery withPredicates(Function<ZoneQueryModel,QueryPredicate<Zone>> predicateFunction)

Description copied from interface: MetaModelQueryDsl

Returns a new instance with the new predicate as only predicate.

Specified by:

withPredicates in interface MetaModelQueryDsl<Zone,ZoneQuery,ZoneQueryModel,ZoneExpansionModel<Zone>>

Parameters:

predicateFunction - function given a meta model description of the model return a QueryPredicate

Returns:

instance with the predicate

See Also:

MetaModelQueryDsl.plusPredicates(Function)

withPredicates

ZoneQuery withPredicates(QueryPredicate<Zone> queryPredicate)

Description copied from interface: QueryDsl

Returns a new instance with the new predicate as only predicate.

Specified by:

withPredicates in interface MetaModelQueryDsl<Zone,ZoneQuery,ZoneQueryModel,ZoneExpansionModel<Zone>>

Specified by:

withPredicates in interface QueryDsl<Zone,ZoneQuery>

Parameters:

queryPredicate - the new predicate

Returns:

instance with the predicate

See Also:

QueryDsl.plusPredicates(QueryPredicate)

withPredicates

ZoneQuery withPredicates(List<QueryPredicate<Zone>> queryPredicates)

Description copied from interface: QueryDsl

Returns a new instance with the new predicate list as predicates.

Specified by:

withPredicates in interface MetaModelQueryDsl<Zone,ZoneQuery,ZoneQueryModel,ZoneExpansionModel<Zone>>

Specified by:

withPredicates in interface QueryDsl<Zone,ZoneQuery>

Parameters:

queryPredicates - the new predicate list

Returns:

instance with the predicate list

See Also:

QueryDsl.plusPredicates(List)

withSort

ZoneQuery withSort(Function<ZoneQueryModel,QuerySort<Zone>> m)

Description copied from interface: MetaModelQueryDsl

Returns a query with the new sort as only sort parameter.

Specified by:

withSort in interface MetaModelQueryDsl<Zone,ZoneQuery,ZoneQueryModel,ZoneExpansionModel<Zone>>

Parameters:

m - function given a meta model description of the model returns a QuerySort

Returns:

Query with sort

See Also:

MetaModelQueryDsl.plusSort(Function)

withSort

ZoneQuery withSort(List<QuerySort<Zone>> sort)

Description copied from interface: QueryDsl

Returns a query with the new sort list as only sort parameters.

Specified by:

withSort in interface MetaModelQueryDsl<Zone,ZoneQuery,ZoneQueryModel,ZoneExpansionModel<Zone>>

Specified by:

withSort in interface QueryDsl<Zone,ZoneQuery>

Parameters:

sort - list of sorts how the results of the query should be sorted

Returns:

Query with sort

See Also:

QueryDsl.plusSort(List)

withSort

ZoneQuery withSort(QuerySort<Zone> sort)

Description copied from interface: QueryDsl

Returns a query with the new sort as only sort parameter.

Specified by:

withSort in interface MetaModelQueryDsl<Zone,ZoneQuery,ZoneQueryModel,ZoneExpansionModel<Zone>>

Specified by:

withSort in interface QueryDsl<Zone,ZoneQuery>

Parameters:

sort - sort expression how the results of the query should be sorted

Returns:

Query with sort

See Also:

QueryDsl.plusSort(QuerySort)

withSortMulti

ZoneQuery withSortMulti(Function<ZoneQueryModel,List<QuerySort<Zone>>> m)

Description copied from interface: MetaModelQueryDsl

Returns a query with the new sort list as only sort parameters.

Specified by:

withSortMulti in interface MetaModelQueryDsl<Zone,ZoneQuery,ZoneQueryModel,ZoneExpansionModel<Zone>>

Parameters:

m - function given a meta model description of the model returns a list of QuerySort

Returns:

Query with sort

See Also:

MetaModelQueryDsl.plusSort(List), MetaModelQueryDsl.withSort(Function)

plusExpansionPaths

ZoneQuery plusExpansionPaths(Function<ZoneExpansionModel<Zone>,ExpansionPathContainer<Zone>> m)

Description copied from interface: MetaModelReferenceExpansionDsl

Creates a new object with the properties of the old object but adds a new expansion path to it by using meta models.

An example in the product projection context:

final ProductProjectionByIdGet fetch1 = ProductProjectionByIdGet.of("id", ProductProjectionType.CURRENT)
        .plusExpansionPaths(m -> m.categories());
assertThat(fetch1.expansionPaths())
        .isEqualTo(asList(ExpansionPath.of("categories[*]")));

final ProductProjectionByIdGet fetch2 = fetch1.plusExpansionPaths(m -> m.productType());
assertThat(fetch2.expansionPaths())
        .isEqualTo(asList(ExpansionPath.of("categories[*]"), ExpansionPath.of("productType")))
        .isEqualTo(listOf(fetch1.expansionPaths(), ExpansionPath.of("productType")));

//this is equivalent to

final ExpansionPath<ProductProjection> categoryExpand = ProductProjectionExpansionModel.of().categories().expansionPaths().get(0);
final ExpansionPath<ProductProjection> productTypeExpand = ProductProjectionExpansionModel.of().productType().expansionPaths().get(0);
final ProductProjectionByIdGet fetchB = ProductProjectionByIdGet.of("id", ProductProjectionType.CURRENT)
                .withExpansionPaths(asList(categoryExpand, productTypeExpand));
assertThat(fetchB.expansionPaths())
        .isEqualTo(asList(ExpansionPath.of("categories[*]"), ExpansionPath.of("productType")));
See the test code.

Specified by:

plusExpansionPaths in interface MetaModelReferenceExpansionDsl<Zone,ZoneQuery,ZoneExpansionModel<Zone>>

Parameters:

m - function to use the meta model for expansions to create an expansion path

Returns:

new object

withExpansionPaths

ZoneQuery withExpansionPaths(Function<ZoneExpansionModel<Zone>,ExpansionPathContainer<Zone>> m)

Description copied from interface: MetaModelReferenceExpansionDsl

Creates a new object with the properties of the old object but replaces all expansion paths with a single expansionPath by using meta models.

An example in the product projection context:

final ProductProjectionByIdGet fetch = ProductProjectionByIdGet.of("id", ProductProjectionType.CURRENT)
                .plusExpansionPaths(ProductProjectionExpansionModel.of().categories());

assertThat(fetch.expansionPaths())
        .isEqualTo(asList(ExpansionPath.of("categories[*]")));

final ProductProjectionByIdGet fetch2 =
        fetch.withExpansionPaths(m -> m.productType());

assertThat(fetch.expansionPaths()).overridingErrorMessage("old object is unchanged")
        .isEqualTo(asList(ExpansionPath.of("categories[*]")));
assertThat(fetch2.expansionPaths()).isEqualTo(asList(ExpansionPath.of("productType")));
assertThat(fetch2).isNotSameAs(fetch);
See the test code.

Specified by:

withExpansionPaths in interface MetaModelReferenceExpansionDsl<Zone,ZoneQuery,ZoneExpansionModel<Zone>>

Parameters:

m - function to use the meta model for expansions to create an expansion path

Returns:

new object

withFetchTotal

ZoneQuery withFetchTotal(boolean fetchTotal)

Description copied from interface: QueryDsl

Enables/disables a flag it the total amount of items should be counted.

If fetchTotal is true then PagedQueryResult.getTotal() is null.

Specified by:

withFetchTotal in interface QueryDsl<Zone,ZoneQuery>

Parameters:

fetchTotal - enable the total count if true (default on the construction of the QueryDsl).

Returns:

the same QueryDsl as this instance but with the updated flag

withLimit

ZoneQuery withLimit(Long limit)

Description copied from interface: QueryDsl

Creates a new instance which a limited amount of results.

Limit restrictions on the API.

Specified by:

withLimit in interface QueryDsl<Zone,ZoneQuery>

Parameters:

limit - the maximum amount of items of T which should be included in the PagedQueryResult.

Returns:

copy of this item with modified limit settings

See Also:

PagedQueryResult.getResults()

withOffset

ZoneQuery withOffset(Long offset)

Description copied from interface: QueryDsl

Returns a new query with the new offset as offset.

Specified by:

withOffset in interface QueryDsl<Zone,ZoneQuery>

Parameters:

offset - the number of items which should be omitted in the query result.

Returns:

a new query

byName

default ZoneQuery byName(String name)

byCountry

default ZoneQuery byCountry(com.neovisionaries.i18n.CountryCode countryCode)

Predicate which matches the country of a location, does not take the state into the consideration. For considering also the state use byLocation(io.sphere.sdk.zones.Location).

Parameters:

countryCode - the country to query for

Returns:

query with the same values but a predicate searching for a specific country

byLocation

default ZoneQuery byLocation(Location location)

Predicate which matches the country and state of a location. For ignoring the state use byCountry(com.neovisionaries.i18n.CountryCode).

Parameters:

location - the location to query for

Returns:

query with the same values but a predicate searching for a specific location