How jimsong9345/spring-graphql works
Project type and purpose
• This is a multi‐module, open‐source library and documentation project (“Spring for GraphQL”).
• It provides GraphQL support on the Spring platform by building on GraphQL Java.
• It includes:
– Core library modules implementing server and client APIs, execution, data binding, observation, etc.
– A test module with reusable test utilities for GraphQL flows.
– A documentation site module (Antora‐based).
– A “platform” BOM module for dependency management.
– Build‐logic plugins under buildSrc.
– CI/CD workflows and publication steps.
File structure
Top-level elements:
• build.gradle / settings.gradle / gradle.properties – root build.
• buildSrc/ – Gradle plugins and architecture checks used by all modules.
• platform/ – Bill of Materials for version alignment across Spring GraphQL and dependencies.
• spring-graphql/ – Core library, subpackages by concern: server (webflux, webmvc, transports), client (HTTP, WebSocket, RSocket), data (repository bindings, federation), execution (GraphQlSource builders, exception resolvers), observation (Micrometer), support classes, resources (graphiql, native‐image configs).
• spring-graphql-test/ – Utilities for testing clients and servers, GraphQlTester implementations, transport mocks, AOT support.
• spring-graphql-docs/ – Antora playbook, AsciiDoc pages, sample Java code under src/main/java/org/springframework/graphql/docs. Produces published reference docs.
• .github/ – Actions that orchestrate build, publish, release, docs deployment, sync to Maven central, etc.
Additional insights from the README
• Emphasis on reference documentation (published and source).
• Samples in legacy branch will be moved out.
• GraphQL Java is the underlying execution engine.