Skip to content

[Chapter 12 - MicroProfile GraphQL 2.0] Add new chapter about MicroProfile GraphQL 2.0#68

Open
ttelang wants to merge 9 commits into
microprofile:mainfrom
ttelang:mp-graphql-2.0
Open

[Chapter 12 - MicroProfile GraphQL 2.0] Add new chapter about MicroProfile GraphQL 2.0#68
ttelang wants to merge 9 commits into
microprofile:mainfrom
ttelang:mp-graphql-2.0

Conversation

@ttelang

@ttelang ttelang commented Mar 31, 2026

Copy link
Copy Markdown
Contributor

This chapter introduces MicroProfile GraphQL 2.0, covering its features, advantages over REST, and how to implement GraphQL APIs in Jakarta EE and MicroProfile applications.

It covers the following topics:

  • What is GraphQL and key differences from REST
  • Schema-first and Code-first approaches
  • Project Dependencies (Maven and Gradle)
  • Defining GraphQL service endpoints
  • Annotations for defining GraphQL operations and metadata
  • Scalar types, enumerations, and GraphQL interfaces
  • Custom Object Mapping and Field Resolution
  • Error Handling and Partial Results
  • Integration with MicroProfile Config

This chapter introduces MicroProfile GraphQL 2.0, covering its features, advantages over REST, and how to implement GraphQL APIs in Jakarta EE and MicroProfile applications. It includes topics such as defining endpoints, using annotations, error handling, and project dependencies.
@ttelang ttelang marked this pull request as ready for review March 31, 2026 16:43
@ttelang ttelang changed the title Add chapter on MicroProfile GraphQL 2.0 [Chapter 11 - MicroProfile GraphQL 2.0] Add new chapter about MicroProfile GraphQL 2.0 Apr 7, 2026
@ttelang ttelang changed the title [Chapter 11 - MicroProfile GraphQL 2.0] Add new chapter about MicroProfile GraphQL 2.0 [Chapter 12 - MicroProfile GraphQL 2.0] Add new chapter about MicroProfile GraphQL 2.0 Apr 7, 2026

@t1 t1 left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great work! I wouldn't say that and add all this nitpicking comments, if I thought differently ;-)

Comment thread modules/ROOT/pages/chapter12/chapter12.adoc Outdated
Comment thread modules/ROOT/pages/chapter12/chapter12.adoc Outdated
Comment thread modules/ROOT/pages/chapter12/chapter12.adoc Outdated
Comment thread modules/ROOT/pages/chapter12/chapter12.adoc Outdated
Comment thread modules/ROOT/pages/chapter12/chapter12.adoc Outdated
Comment thread modules/ROOT/pages/chapter12/chapter12.adoc Outdated
Comment thread modules/ROOT/pages/chapter12/chapter12.adoc Outdated
Comment thread modules/ROOT/pages/chapter12/chapter12.adoc Outdated
Comment thread modules/ROOT/pages/chapter12/chapter12.adoc Outdated
Comment thread modules/ROOT/pages/chapter12/chapter12.adoc
ttelang and others added 4 commits June 9, 2026 19:42
Co-authored-by: Rüdiger zu Dohna <ruediger.dohna@codecentric.de>
Corrected punctuation and improved sentence structure in the introduction and various sections of the chapter.
Revised introduction to clarify the challenges of REST APIs and the advantages of GraphQL in addressing diverse client needs.
Revised text for clarity and improved flow regarding network overhead and composite endpoints. Enhanced explanation of the `@Source` annotation in MicroProfile GraphQL.
@ttelang

ttelang commented Jun 9, 2026

Copy link
Copy Markdown
Contributor Author

Great work! I wouldn't say that and add all this nitpicking comments, if I thought differently ;-)

@t1 - Thanks for your valuable feedback and appreciation.

ttelang added 4 commits June 9, 2026 22:34
Added explanations for using @name and @description annotations in GraphQL schema. Included Maven and Gradle configurations for preserving parameter names.
Expanded the explanation of GraphQL to include its suitability for machine-to-machine communication and the benefits of schema-first contracts.
Removed the word 'schema-first' from the description of GraphQL service contract.
Clarified the explanation of GraphQL introspection and its similarities to OpenAPI and Swagger UI.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants