graphql-query-builder

GraphQL query builder for Java

Installation

Maven (pom.xml)

<dependencies>
    <dependency>
        <groupId>com.github.k0kubun</groupId>
        <artifactId>graphql-query-builder</artifactId>
        <version>0.4.0</version>
    </dependency>
</dependencies>

Gradle (build.gradle)

dependencies {
    compile 'com.github.k0kubun:graphql-query-builder:0.4.0'
}

Usage

To build following query:

user(name:"k0kubun") {
  name
  friends(first:10 after:"Y3Vyc29yMQ==") {
    totalCount
    edges {
      cursor
      node {
        ... on User {
          name
        }
      }
    }
  }
}

You can write code in the following way:

import com.github.k0kubun.builder.query.graphql.GraphQLQueryBuilder;
import java.util.HashMap;
import java.util.Map;

public class Example {
    
    public example() {
    
        Map<String, String> userParams = new HashMap<>();
        userParams.put("name", "k0kubun");
        
        String query = GraphQL.createQueryBuilder()
            .object("user", userParams, GraphQL.createObjectBuilder()
                .field("name")
                .objects("friends", 10, "Y3Vyc29yMQ==", GraphQL.createObjectBuilder()
                    .field("totalCount")
                    .object("edges", GraphQL.createObjectBuilder()
                        .field("cursor")
                        .object("node", GraphQL.createObjectBuilder()
                            .on("User", GraphQL.createObjectBuilder()
                                .field("name")
                                .build()
                            ).build()
                        ).build()
                    ).build()
                ).build()
            ).build();
    }
}

Project Status

Experimental.

Unsupported features

@include
@skip
Mutation
Fragments
Variables
Aliases

Code style

Airlift

(https://github.com/airlift/codestyle)

Release

Create ~/.gradle/gradle.properties like:

sonatypeUsername=k0kubun
sonatypePassword=PASSWORD
signing.keyId=KEYID
signing.password=PASSWORD
signing.secretKeyRingFile=/Users/k0kubun/.gnupg/secring.gpg

KEYID is the last 8 characters of what's shown at gpg -K.

Then run:

$ ./gradlew uploadArchives

At https://oss.sonatype.org/#stagingRepositories, push "Close" and then "Release". Sync to maven repository might take some time.

License

MIT License

lprovenzano/graphql-query-builder