com.adobe.cq.commerce.magento.graphql.__SchemaQuery Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of magento-graphql Show documentation
AEM bundle for the Magento GraphQL data models and query builders
There is a newer version: 11.1.0-magento244ee
/*******************************************************************************
 *
 *    Copyright 2020 Adobe. All rights reserved.
 *    This file is licensed to you under the Apache License, Version 2.0 (the "License");
 *    you may not use this file except in compliance with the License. You may obtain a copy
 *    of the License at http://www.apache.org/licenses/LICENSE-2.0
 *
 *    Unless required by applicable law or agreed to in writing, software distributed under
 *    the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
 *    OF ANY KIND, either express or implied. See the License for the specific language
 *    governing permissions and limitations under the License.
 *
 ******************************************************************************/

package com.adobe.cq.commerce.magento.graphql;

import com.shopify.graphql.support.AbstractQuery;
import com.shopify.graphql.support.Fragment;

/**
 * A GraphQL Schema defines the capabilities of a GraphQL server. It exposes all available types and
 * directives on the server, as well as the entry points for query, mutation, and subscription
 * operations.
 */
public class __SchemaQuery extends AbstractQuery<__SchemaQuery> {
    __SchemaQuery(StringBuilder _queryBuilder) {
        super(_queryBuilder);
    }

    /**
     * A list of all directives supported by this server.
     */
    public __SchemaQuery directives(__DirectiveQueryDefinition queryDef) {
        startField("directives");

        _queryBuilder.append('{');
        queryDef.define(new __DirectiveQuery(_queryBuilder));
        _queryBuilder.append('}');

        return this;
    }

    /**
     * If this server supports mutation, the type that mutation operations will be rooted at.
     */
    public __SchemaQuery mutationType(__TypeQueryDefinition queryDef) {
        startField("mutationType");

        _queryBuilder.append('{');
        queryDef.define(new __TypeQuery(_queryBuilder));
        _queryBuilder.append('}');

        return this;
    }

    /**
     * The type that query operations will be rooted at.
     */
    public __SchemaQuery queryType(__TypeQueryDefinition queryDef) {
        startField("queryType");

        _queryBuilder.append('{');
        queryDef.define(new __TypeQuery(_queryBuilder));
        _queryBuilder.append('}');

        return this;
    }

    /**
     * If this server support subscription, the type that subscription operations will be rooted at.
     */
    public __SchemaQuery subscriptionType(__TypeQueryDefinition queryDef) {
        startField("subscriptionType");

        _queryBuilder.append('{');
        queryDef.define(new __TypeQuery(_queryBuilder));
        _queryBuilder.append('}');

        return this;
    }

    /**
     * A list of all types supported by this server.
     */
    public __SchemaQuery types(__TypeQueryDefinition queryDef) {
        startField("types");

        _queryBuilder.append('{');
        queryDef.define(new __TypeQuery(_queryBuilder));
        _queryBuilder.append('}');

        return this;
    }

    /**
     * Creates a GraphQL "named" fragment with the specified query type definition.
     * The generics nature of fragments ensures that a fragment can only be used at the right place in the GraphQL request.
     * 
     * @param name The name of the fragment, must be unique for a given GraphQL request.
     * @param queryDef The fragment definition.
     * @return The fragment of a given generics type.
     */
    public static Fragment<__SchemaQuery> createFragment(String name, __SchemaQueryDefinition queryDef) {
        StringBuilder sb = new StringBuilder();
        queryDef.define(new __SchemaQuery(sb));
        return new Fragment<>(name, "__Schema", sb.toString());
    }

    /**
     * Adds a __SchemaQuery fragment reference at the current position of the query.
     * For example for a fragment named test, calling this method will add the
     * reference ...test in the query. For GraphQL types implementing an interface, there
     * will be some similar methods using the Query type of each implemented interface.
     * 
     * @param fragment The fragment to reference.
     */
    public __SchemaQuery addFragmentReference(Fragment<__SchemaQuery> fragment) {
        startField("..." + fragment.getName());
        return this;
    }
}