com.commercetools.sync.commons.helpers

Class CustomReferenceResolver<D,B extends io.sphere.sdk.models.Builder<? extends D>,S extends BaseSyncOptions>

java.lang.Object

com.commercetools.sync.commons.helpers.BaseReferenceResolver<D,S>

com.commercetools.sync.commons.helpers.CustomReferenceResolver<D,B,S>

Type Parameters:

D - the resource draft type for which reference resolution has to be done on.

B - the resource draft builder where resolved values should be set. The builder type should correspond the D type.

S - a subclass implementation of BaseSyncOptions that is used to allow/deny some specific options, specified by the user, on reference resolution.

Direct Known Subclasses:

AssetReferenceResolver, CartDiscountReferenceResolver, CategoryReferenceResolver, CustomerReferenceResolver, InventoryReferenceResolver, LineItemReferenceResolver, PriceReferenceResolver, ShoppingListReferenceResolver, TextLineItemReferenceResolver

public abstract class CustomReferenceResolver<D,B extends io.sphere.sdk.models.Builder<? extends D>,S extends BaseSyncOptions>
extends BaseReferenceResolver<D,S>

This class is responsible for providing an abstract implementation of reference resolution on Custom CTP resources for example (Categories, inventories and resource with a custom field). For concrete reference resolution implementation of the CTP resources, this class should be extended.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	TYPE_DOES_NOT_EXIST

Fields inherited from class com.commercetools.sync.commons.helpers.BaseReferenceResolver

BLANK_ID_VALUE_ON_REFERENCE, BLANK_KEY_VALUE_ON_RESOURCE_IDENTIFIER, options

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CustomReferenceResolver(S options, TypeService typeService)

Method Summary

Modifier and Type	Method and Description
protected abstract java.util.concurrent.CompletionStage<B>	resolveCustomTypeReference(B draftBuilder) Given a draft of D (e.g.
protected java.util.concurrent.CompletionStage<B>	resolveCustomTypeReference(B draftBuilder, java.util.function.Function<B,io.sphere.sdk.types.CustomFieldsDraft> customGetter, java.util.function.BiFunction<B,io.sphere.sdk.types.CustomFieldsDraft,B> customSetter, java.lang.String errorMessage) Given a draft of D (e.g.

Methods inherited from class com.commercetools.sync.commons.helpers.BaseReferenceResolver

getIdFromReference, getKeyFromResourceIdentifier, resolveReferences

Methods inherited from class java.lang.Object

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

Field Detail

TYPE_DOES_NOT_EXIST

public static final java.lang.String TYPE_DOES_NOT_EXIST

See Also:

Constant Field Values

Constructor Detail

CustomReferenceResolver

protected CustomReferenceResolver(@Nonnull
                                  S options,
                                  @Nonnull
                                  TypeService typeService)

Method Detail

resolveCustomTypeReference

protected abstract java.util.concurrent.CompletionStage<B> resolveCustomTypeReference(@Nonnull
                                                                                      B draftBuilder)

Given a draft of D (e.g. CategoryDraft) this method attempts to resolve it's custom type reference to return CompletionStage which contains a new instance of the draft with the resolved custom type reference.

The method then tries to fetch the key of the custom type, optimistically from a cache. If the key is is not found, the resultant draft would remain exactly the same as the passed draft (without a custom type reference resolution).

Parameters:

draftBuilder - the draft builder to resolve it's references.

Returns:

a CompletionStage that contains as a result a new draft instance with resolved custom type references or, in case an error occurs during reference resolution, a ReferenceResolutionException.

resolveCustomTypeReference

@Nonnull
protected java.util.concurrent.CompletionStage<B> resolveCustomTypeReference(@Nonnull
                                                                                      B draftBuilder,
                                                                                      @Nonnull
                                                                                      java.util.function.Function<B,io.sphere.sdk.types.CustomFieldsDraft> customGetter,
                                                                                      @Nonnull
                                                                                      java.util.function.BiFunction<B,io.sphere.sdk.types.CustomFieldsDraft,B> customSetter,
                                                                                      @Nonnull
                                                                                      java.lang.String errorMessage)

Given a draft of D (e.g. CategoryDraft) this method attempts to resolve it's custom type reference to return CompletionStage which contains a new instance of the draft with the resolved custom type reference.

The method then tries to fetch the key of the custom type, optimistically from a cache. If the key is is not found, the resultant draft would remain exactly the same as the passed draft (without a custom type reference resolution).

Note: If the id field is set, then it is an evidence of resource existence on commercetools, so we can issue an update/create API request right away without reference resolution.

Parameters:

draftBuilder - the draft builder to resolve it's references.

customGetter - a function to return the CustomFieldsDraft instance of the draft builder.

customSetter - a function to set the CustomFieldsDraft instance of the builder and return this builder.

errorMessage - the error message to inject in the ReferenceResolutionException if it occurs.

Returns:

a CompletionStage that contains as a result a new draft instance with resolved custom type references or, in case an error occurs during reference resolution, a ReferenceResolutionException.