8567402969
This commit extract spring-related links and recurring external links into asciidoctor attributes to be used by the Antora toolchain. It notably homogenizes links to: - IETF RFCs - Java Community Process JSRs - the Java API Documentation (on the Java 17 version) - Kotlin documentations (on the Kotlinlang.org version) - the Spring Boot reference guide (on the `html` version) This commit also reworks most link attributes to follow a Project-Category-Misc syntax. For example, `spring-boot-docs` rather than `docs-spring-boot`. Finally, it makes an effort to clean up remainders from the previous documentation toolchain, namely the `docs/asciidoc` folder and `modules/ROOT/pages/attributes.adoc` file. Closes gh-26864 Closes gh-31619
47 lines
2.0 KiB
Plaintext
47 lines
2.0 KiB
Plaintext
[[mvc-view-jackson]]
|
|
= Jackson
|
|
|
|
[.small]#xref:web/webflux-view.adoc#webflux-view-httpmessagewriter[See equivalent in the Reactive stack]#
|
|
|
|
Spring offers support for the Jackson JSON library.
|
|
|
|
|
|
|
|
[[mvc-view-json-mapping]]
|
|
== Jackson-based JSON MVC Views
|
|
[.small]#xref:web/webflux-view.adoc#webflux-view-httpmessagewriter[See equivalent in the Reactive stack]#
|
|
|
|
The `MappingJackson2JsonView` uses the Jackson library's `ObjectMapper` to render the response
|
|
content as JSON. By default, the entire contents of the model map (with the exception of
|
|
framework-specific classes) are encoded as JSON. For cases where the contents of the
|
|
map need to be filtered, you can specify a specific set of model attributes to encode
|
|
by using the `modelKeys` property. You can also use the `extractValueFromSingleKeyModel`
|
|
property to have the value in single-key models extracted and serialized directly rather
|
|
than as a map of model attributes.
|
|
|
|
You can customize JSON mapping as needed by using Jackson's provided
|
|
annotations. When you need further control, you can inject a custom `ObjectMapper`
|
|
through the `ObjectMapper` property, for cases where you need to provide custom JSON
|
|
serializers and deserializers for specific types.
|
|
|
|
|
|
|
|
[[mvc-view-xml-mapping]]
|
|
== Jackson-based XML Views
|
|
[.small]#xref:web/webflux-view.adoc#webflux-view-httpmessagewriter[See equivalent in the Reactive stack]#
|
|
|
|
`MappingJackson2XmlView` uses the
|
|
{jackson-github-org}/jackson-dataformat-xml[Jackson XML extension's] `XmlMapper`
|
|
to render the response content as XML. If the model contains multiple entries, you should
|
|
explicitly set the object to be serialized by using the `modelKey` bean property. If the
|
|
model contains a single entry, it is serialized automatically.
|
|
|
|
You can customized XML mapping as needed by using JAXB or Jackson's provided
|
|
annotations. When you need further control, you can inject a custom `XmlMapper`
|
|
through the `ObjectMapper` property, for cases where custom XML
|
|
you need to provide serializers and deserializers for specific types.
|
|
|
|
|
|
|
|
|