Spring boot starter for GraphQL
Clone or download
Latest commit 9c6ee97 Dec 7, 2017


Join the chat at https://gitter.im/merapar/graphql-spring-boot-starter Build Status Code coverage Latest Release Dev version

GraphQL Spring boot starter

This is a Spring boot starter project for the GraphQL Java project.

Table of Contents


The implementation is based on Spring boot starter web project that will expose the GraphQL endpoint as rest controller.

It takes care of exposing a rest endpoint with all configured graphQL fields automatically.

The library aims for real-life usage in production with the ease of Spring Boot.

Getting started

Check out the following documentation on using spring boot starter project.

By adding GraphQL Spring boot starter as maven dependency on the application a @Controller will be created pointing to the configured request mapping with default "/v1/graphql". During startup all components that implement "GraphQlFields" interface will be applied on the GraphQL schema exposed by the controller.

An example from the sample project:

package com.merapar.graphql.sample.fields;

import com.merapar.graphql.GraphQlFields;
import graphql.schema.GraphQLFieldDefinition;
import org.springframework.stereotype.Component;

import java.util.Collections;
import java.util.List;

import static graphql.Scalars.GraphQLString;
import static graphql.schema.GraphQLFieldDefinition.newFieldDefinition;

public class HelloWorldFields implements GraphQlFields {

    public List<GraphQLFieldDefinition> getQueryFields() {
        return Collections.singletonList(

    public List<GraphQLFieldDefinition> getMutationFields() {
        return Collections.emptyList();


The following default properties can be configured via properties file:

  rootQueryName: "queries"
  rootQueryDescription: ""
  rootMutationName: "mutations"
  rootMutationDescription: ""
    path: "/v1/graphql"
    minimumThreadPoolSizeQuery: 10
    maximumThreadPoolSizeQuery: 20
    keepAliveTimeInSecondsQuery: 30
    minimumThreadPoolSizeMutation: 10
    maximumThreadPoolSizeMutation: 20
    keepAliveTimeInSecondsMutation: 30
    minimumThreadPoolSizeSubscription: 10
    maximumThreadPoolSizeSubscription: 20
    keepAliveTimeInSecondsSubscription: 30

How to use the latest release with Maven



How to use the latest build with Maven

Add the repository:





We use SemVer for versioning. For the versions available, see the tags on this repository.

Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By contributing to this project (commenting or opening PR/Issues etc) you are agreeing to follow this conduct, so please take the time to read it.


Every contribution to make this project better is welcome: Thank you!

In order to make this a pleasant as possible for everybody involved, here are some tips:


This implementation is based on the graphql-java project.


GraphQL Spring boot starter is licensed under the MIT License. See LICENSE for details.

Copyright (c) 2016 Merapar Technologies

graphql-java License