io.sphere.sdk.customobjects.queries.CustomObjectByIdGet Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of commercetools-models Show documentation
There is a newer version: 2.16.0
package io.sphere.sdk.customobjects.queries;

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.JsonNode;
import io.sphere.sdk.customobjects.CustomObject;
import io.sphere.sdk.customobjects.expansion.CustomObjectExpansionModel;
import io.sphere.sdk.expansion.ExpansionPath;
import io.sphere.sdk.json.SphereJsonUtils;
import io.sphere.sdk.json.TypeReferences;
import io.sphere.sdk.queries.Get;
import io.sphere.sdk.queries.MetaModelGetDsl;
import io.sphere.sdk.types.Type;
import io.sphere.sdk.types.queries.TypeByIdGet;

import java.util.List;

/**
 * {@link io.sphere.sdk.client.SphereRequest} to fetch one {@link CustomObject} by id.
 *
 * {@include.example io.sphere.sdk.customobjects.queries.CustomObjectByIdGetIntegrationTest#execution()}
 *
 * @param  The type of the value of the custom object.
 * @see CustomObject
 */
public interface CustomObjectByIdGet extends MetaModelGetDsl, CustomObject, CustomObjectByIdGet, CustomObjectExpansionModel>> {

    /**
     * Creates an object to fetch a custom object by id with POJO mapping.
     * @param id id of the custom object to fetch
     * @param valueClass the class of the value, if it not uses generics like lists, typically for POJOs
     * @param  the type of the value in the custom object
     * @return query object
     */
    static  CustomObjectByIdGet of(final String id, final Class valueClass) {
        return new CustomObjectByIdGetImpl(id, SphereJsonUtils.convertToJavaType(valueClass));
    }

    /**
     * Creates an object to fetch a custom object by the container and key with POJO mapping.
     * @param id id of the custom object to fetch
     * @param valueTypeReference the type reference of the value of the custom object
     * @param  the type of the value in the custom object
     * @return query object
     */
    static  CustomObjectByIdGet of(final String id, final TypeReference valueTypeReference) {
        return new CustomObjectByIdGetImpl(id, SphereJsonUtils.convertToJavaType(valueTypeReference));
    }

    /**
     * Creates an object to fetch a custom object by the container and get the result as {@link JsonNode}.
     * @param id id of the custom object to fetch
     * @return query object
     */
    static CustomObjectByIdGet ofJsonNode(final String id) {
        return of(id, TypeReferences.jsonNodeTypeReference());
    }

    @Override
    List>> expansionPaths();

    @Override
    CustomObjectByIdGet plusExpansionPaths(final ExpansionPath> expansionPath);

    @Override
    CustomObjectByIdGet withExpansionPaths(final ExpansionPath> expansionPath);

    @Override
    CustomObjectByIdGet withExpansionPaths(final List>> expansionPaths);
}