Skip to main content

MicroProfile GraphQL 2.0

The intent of the MicroProfile GraphQL specification is to provide a “code-first” set of APIs that will enable users to quickly develop portable GraphQL-based applications in Java.

There are 2 main requirements for all implementations of this specification, namely:

  1. Generate and make the GraphQL Schema available. This is done by looking at the annotations in the users code, and must include all GraphQL Queries and Mutations as well as all entities as defined implicitly via the response type or argument(s) of Queries and Mutations.
  2. Execute GraphQL requests. This will be in the form of either a Query or a Mutation. As a minimum the specification must support executing these requests via HTTP.
  3. Functional Changes
    • Detail any changes in functionality from previous versions. Explain what has been added, modified, or removed, and the impact of these changes.

GraphQL 2.0 aligns with Jakarta EE 9.1 and works with MicroProfile 5.0. The only change is to update the dependencies from javax to jakarta and there is no other functional update.

This is a major release as it no longer work with the previous Jakarta EE 8 and Java EE releases.

Maven coordinates

<dependency>

  <groupId>org.eclipse.microprofile.graphql</groupId>

  <artifactId>microprofile-graphql-api</artifactId>

  <version>2.0</version>

</dependency>

Scope

Released

Finalised

Details

TCK

Ballots

Release Review

The Specification Committee Ballot concluded successfully on Wed, 21 Aug 2024 with the following results.

Representative Representative for: Vote
Summers Pittman, Vincent Mayers Atlanta JUG +1
Emily Jiang, Nathan Rauh IBM +1
John Clingan, Roberto Cortez Red Hat +1
David Blevins, Amelia Eiras Tomitribe +1
Chandra Guntur, Michael Redlich Garden State Java User Group +1
Ed Bratt, Dmitry Kornilov Oracle no vote
Jan Westerkamp iJUG +1
Kenji Kazumura, Takahiro Nagao Fujitsu +1
Total 7
Non-binding votes Role Vote
Total 0

Help optimize Enterprise Java for a microservices architecture.

Join the MicroProfile Google Group, peruse recent topics or create your own, and join in on the conversation. It's that easy!

JOIN THE DISCUSSION