io.sphere.sdk.products.queries

Interface ProductProjectionByKeyGet

All Superinterfaces:

ExpansionPathContainer<ProductProjection>, Get<ProductProjection>, GetDsl<ProductProjection,ProductProjection,ProductProjectionByKeyGet>, LocaleSelectionRequestDsl<ProductProjectionByKeyGet>, MetaModelGetDsl<ProductProjection,ProductProjection,ProductProjectionByKeyGet,ProductProjectionExpansionModel<ProductProjection>>, MetaModelReferenceExpansionDsl<ProductProjection,ProductProjectionByKeyGet,ProductProjectionExpansionModel<ProductProjection>>, PriceSelectionRequestDsl<ProductProjectionByKeyGet>, ReferenceExpansionDsl<ProductProjection,ProductProjectionByKeyGet>, ReferenceExpansionSupport<ProductProjection>, SphereRequest<ProductProjection>, StoreSelectionRequestDsl<ProductProjectionByKeyGet>

public interface ProductProjectionByKeyGet
extends MetaModelGetDsl<ProductProjection,ProductProjection,ProductProjectionByKeyGet,ProductProjectionExpansionModel<ProductProjection>>, PriceSelectionRequestDsl<ProductProjectionByKeyGet>, LocaleSelectionRequestDsl<ProductProjectionByKeyGet>, StoreSelectionRequestDsl<ProductProjectionByKeyGet>

Retrieves a product projection by a known key.

final String key = randomKey();
ProductFixtures.withProduct(client(), builder -> builder.key(key), product -> {
    final ProductProjectionByKeyGet request = ProductProjectionByKeyGet.ofStaged(key);
    final ProductProjection productProjection = client().executeBlocking(request);
    assertThat(productProjection.getId()).isEqualTo(product.getId());
});
See the test code.

Method Summary

Modifier and Type	Method and Description
List<ExpansionPath<ProductProjection>>	expansionPaths()
static ProductProjectionByKeyGet	of(String key, ProductProjectionType projectionType)
static ProductProjectionByKeyGet	ofCurrent(String key)
static ProductProjectionByKeyGet	ofStaged(String key)
ProductProjectionByKeyGet	plusExpansionPaths(ExpansionPath<ProductProjection> expansionPath) Creates a new object with the properties of the old object but adds expansionPath to the expansion paths.
ProductProjectionByKeyGet	withExpansionPaths(ExpansionPath<ProductProjection> expansionPath) Creates a new object with the properties of the old object but replaces all expansion paths with a single expansionPath.
ProductProjectionByKeyGet	withExpansionPaths(List<ExpansionPath<ProductProjection>> expansionPaths) Creates a new object with the properties of the old object but replaces all expansion paths with expansionPaths.

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

deserialize

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

canDeserialize, httpRequestIntent

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

plusExpansionPaths, withExpansionPaths

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

plusExpansionPaths, plusExpansionPaths, plusExpansionPaths, withExpansionPaths, withExpansionPaths

Methods inherited from interface io.sphere.sdk.products.search.PriceSelectionRequestDsl

getPriceSelection, withPriceSelection

Methods inherited from interface io.sphere.sdk.selection.LocaleSelectionRequestDsl

getLocaleSelection, withLocaleSelection

Methods inherited from interface io.sphere.sdk.selection.StoreSelectionRequestDsl

getStoreSelection, withStoreSelection

Method Detail

ofStaged

static ProductProjectionByKeyGet ofStaged(String key)

ofCurrent

static ProductProjectionByKeyGet ofCurrent(String key)

of

static ProductProjectionByKeyGet of(String key,
                                    ProductProjectionType projectionType)

expansionPaths

List<ExpansionPath<ProductProjection>> expansionPaths()

Specified by:

expansionPaths in interface ExpansionPathContainer<ProductProjection>

Specified by:

expansionPaths in interface ReferenceExpansionSupport<ProductProjection>

plusExpansionPaths

ProductProjectionByKeyGet plusExpansionPaths(ExpansionPath<ProductProjection> expansionPath)

Description copied from interface: ReferenceExpansionDsl

Creates a new object with the properties of the old object but adds expansionPath to the expansion paths.

An example in the product projection context:

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

assertThat(fetch.expansionPaths()).isEmpty();

final ProductProjectionByIdGet fetch2 =
        fetch.plusExpansionPaths(ProductProjectionExpansionModel.of().categories());

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

Specified by:

plusExpansionPaths in interface ReferenceExpansionDsl<ProductProjection,ProductProjectionByKeyGet>

Parameters:

expansionPath - the new expansion path to add to the existing ones

Returns:

new object

withExpansionPaths

ProductProjectionByKeyGet withExpansionPaths(ExpansionPath<ProductProjection> expansionPath)

Description copied from interface: ReferenceExpansionDsl

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

An example in the product projection context:

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

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

final ProductProjectionByIdGet fetch2 =
        fetch.withExpansionPaths(ProductProjectionExpansionModel.of().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.

This method also can be used to use the same expansions as in another request:

final ProductProjectionQuery query = ProductProjectionQuery.ofCurrent().withExpansionPaths(m -> m.categories());
final ProductProjectionSearch search = ProductProjectionSearch.ofCurrent().withExpansionPaths(query);
assertThat(query.expansionPaths())
        .hasSize(1)
        .as("reuse expansion spec from other request")
        .isEqualTo(search.expansionPaths());
See the test code.

Specified by:

withExpansionPaths in interface ReferenceExpansionDsl<ProductProjection,ProductProjectionByKeyGet>

Parameters:

expansionPath - the new expansion paths

Returns:

new object

withExpansionPaths

ProductProjectionByKeyGet withExpansionPaths(List<ExpansionPath<ProductProjection>> expansionPaths)

Description copied from interface: ReferenceExpansionDsl

Creates a new object with the properties of the old object but replaces all expansion paths with expansionPaths.

Specified by:

withExpansionPaths in interface ReferenceExpansionDsl<ProductProjection,ProductProjectionByKeyGet>

Parameters:

expansionPaths - the new expansion paths

Returns:

new object