Skip to content

Document the tools changes in 15.0.0 - #84

Open
oryan-block wants to merge 5 commits into
masterfrom
tools/jackson-3
Open

oryan-block wants to merge 5 commits into
masterfrom
tools/jackson-3

Conversation

@oryan-block

@oryan-block oryan-block commented Oct 24, 2026 •

Copy link
Copy Markdown
Contributor

Docs for graphql-java-tools 15.0.0. Merge it with the 15.0.0 release, not before. It has #83 (14.5.0) merged in, since both touch getting started and the options page, so merge #83 first and this diff shrinks to the 15.0.0 part.

Getting started:

  • 15.0.0, plus a line that it needs Java 17, graphql-java 26 and Jackson 3, and that graphql-spring-boot-starter doesn't work with it. Its autoconfiguration still calls SchemaParserDictionary.getDictionary() and builds a Jackson 2 mapper, and the repo has been archived since December 2023, so it won't get a fix.

Schema parser options:

  • objectMapperConfigurer / objectMapperProvider: it's a Jackson 3 mapper now (#925), all fields share one mapper by default instead of each getting its own, and the configurer gets the JsonMapper.Builder instead of the mapper. Also says what the library's mapper does differently from plain Jackson 3 (fails on unknown properties, enums by name()) and that a provider's mappers are used as they are.
  • unmappedInputFields: plain Jackson 3 and Spring Boot mappers drop unknown fields, so that's the case the warning is mostly about now.
  • missingResolverDataFetcher is replaced by missingResolverDataFetcherProvider (#915).
  • introspectionEnabled is gone (#912). The graphql-java switches to turn introspection off moved under fieldVisibility.
  • addProxyHandler: a JDK dynamic proxy resolver fails the build now (#913).

Directives: invalid applied directives fail the build instead of logging a warning (#914).

Schema definition: a method that takes the environment or context in an argument's place fails the build (#911).

The rest of the behaviour changes (repeated declarations, nested wrappers, Jackson 3 defaults, legacy context fallbacks) are only in the release notes, since no page covers them.

Built it locally with Hugo 0.168.0 (same as the workflow). No errors.

Bump getting started to 15.0.0 with its requirements, and update the
pages that describe options removed or warnings turned into errors.
@oryan-block oryan-block changed the title Document the Jackson 3 ObjectMapper options in tools 15.0.0 Document the tools changes in 15.0.0 Oct 24, 2026
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.

1 participant