io.smallrye.graphql.client.core.FragmentReference Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of smallrye-graphql-client-api Show documentation

SmallRye specific Client API, extending the MicroProfile client api, allowing us to play with the api first before we move it to the spec

There is a newer version: 2.11.0

Show newest version

package io.smallrye.graphql.client.core;

import static io.smallrye.graphql.client.core.utils.ServiceUtils.getNewInstanceOf;
import static java.util.Arrays.asList;
import static java.util.Collections.emptyList;

import java.util.List;

/**
 * Represents a reference to a named fragment.
 */
public interface FragmentReference extends FieldOrFragment {

    /**
     * Create a fragment reference by specifying the name of the target fragment.
     * In the resulting document, this will appear as `...FRAGMENTNAME`
     */
    static FragmentReference fragmentRef(String name) {
        FragmentReference ref = getNewInstanceOf(FragmentReference.class);
        ref.setName(name);
        ref.setDirectives(emptyList());
        return ref;
    }

    /**
     * Create a fragment reference by providing a built instance of a named fragment.
     * This will actually only use the name of the fragment - in the resulting document,
     * this will appear as `...FRAGMENTNAME`
     */
    static FragmentReference fragmentRef(Fragment fragment) {
        FragmentReference ref = getNewInstanceOf(FragmentReference.class);
        ref.setName(fragment.getName());
        ref.setDirectives(emptyList());
        return ref;
    }

    /**
     * Create a fragment reference by specifying the name of the target fragment and directives.
     * In the resulting document, this will appear as `...FRAGMENTNAME @DIRECTIVE`
     */
    static FragmentReference fragmentRefWithDirective(String name, Directive... directives) {
        FragmentReference ref = getNewInstanceOf(FragmentReference.class);
        ref.setName(name);
        ref.setDirectives(asList(directives));
        return ref;
    }

    /**
     * Create a fragment reference by providing a built instance of a named fragment and directives.
     * This will actually only use the name of the fragment - in the resulting document,
     * this will appear as `...FRAGMENTNAME @DIRECTIVE`
     */
    static FragmentReference fragmentRefWithDirective(Fragment fragment, Directive... directives) {
        FragmentReference ref = getNewInstanceOf(FragmentReference.class);
        ref.setName(fragment.getName());
        ref.setDirectives(asList(directives));
        return ref;
    }

    String getName();

    void setName(String name);

    List getDirectives();

    void setDirectives(List directives);
}