com.commercetools.sync.commons.helpers

Class CustomReferenceResolver<D extends io.sphere.sdk.types.CustomDraft,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, CategoryReferenceResolver, InventoryReferenceResolver, PriceReferenceResolver

public abstract class CustomReferenceResolver<D extends io.sphere.sdk.types.CustomDraft,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 inherited from class com.commercetools.sync.commons.helpers.BaseReferenceResolver

BLANK_ID_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

getKeyFromResourceIdentifier, resolveReferences

Methods inherited from class java.lang.Object

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

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 key of the custom type is taken from the from the id field of the 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 key of the custom type is taken from the from the id field of the 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.

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.