Skip to content

Commit 089c754

Browse files
committed
Improve explanation of custom scalars vs Jackson
See gh-569
1 parent d1300f5 commit 089c754

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

spring-graphql-docs/src/docs/asciidoc/index.adoc

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -299,8 +299,10 @@ You can use `RuntimeWiringConfigurer` to register:
299299
`AnnotatedControllerConfigurer`, which detects annotated, `DataFetcher` handler methods.
300300
The Spring Boot starter adds the `AnnotatedControllerConfigurer` by default.
301301

302-
NOTE: Unlike web frameworks, GraphQL does not use Jackson annotations to drive JSON serialization/deserialization.
303-
Custom data types and their serialization https://www.graphql-java.com/documentation/scalars/[must be described as Scalars].
302+
NOTE: GraphQL Java, server applications use Jackson only for serialization to and from maps of data.
303+
Client input is parsed into a map. Server output is assembled into a map based on the field selection set.
304+
This means you can't rely on Jackson serialization/deserialization annotations.
305+
Instead, you can use https://www.graphql-java.com/documentation/scalars/[custom scalar types].
304306

305307
The Spring Boot starter detects beans of type `RuntimeWiringConfigurer` and
306308
registers them in the `GraphQlSource.Builder`. That means in most cases, you'll' have

0 commit comments

Comments
 (0)