Spring boot starter for GraphQL
This is a Spring boot starter project for the GraphQL Java project.
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.
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;
@Component
public class HelloWorldFields implements GraphQlFields {
@Override
public List<GraphQLFieldDefinition> getQueryFields() {
return Collections.singletonList(
newFieldDefinition()
.type(GraphQLString)
.name("hello")
.staticValue("world")
.build()
);
}
@Override
public List<GraphQLFieldDefinition> getMutationFields() {
return Collections.emptyList();
}
}
The following default properties can be configured via properties file:
com.merapar.graphql:
rootQueryName: "queries"
rootQueryDescription: ""
rootMutationName: "mutations"
rootMutationDescription: ""
requestMapping:
path: "/v1/graphql"
executor:
minimumThreadPoolSizeQuery: 10
maximumThreadPoolSizeQuery: 20
keepAliveTimeInSecondsQuery: 30
minimumThreadPoolSizeMutation: 10
maximumThreadPoolSizeMutation: 20
keepAliveTimeInSecondsMutation: 30
minimumThreadPoolSizeSubscription: 10
maximumThreadPoolSizeSubscription: 20
keepAliveTimeInSecondsSubscription: 30
Dependency:
<dependency>
<groupId>com.merapar</groupId>
<artifactId>graphql-spring-boot-starter</artifactId>
<version>1.0.2</version>
</dependency>
Add the repository:
<repository>
<id>bintray-merapar-maven</id>
<name>bintray</name>
<url>http://dl.bintray.com/merapar/maven</url>
</repository>
Dependency:
<dependency>
<groupId>com.merapar</groupId>
<artifactId>graphql-spring-boot-starter</artifactId>
<version>1.0.3-alpha</version>
</dependency>
We use SemVer for versioning. For the versions available, see the tags on this repository.
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