Spring/spring-boot
Spring/spring-boot
1
0
Fork 0
mirror of https://github.com/spring-projects/spring-boot.git synced 2024-07-15 01:07:30 +08:00
Code Issues Packages Projects Releases Wiki Activity

Update instructions on how to use JAXB as XML renderer

Browse Source 
See gh-16005
This commit is contained in:
Lars Grefer 2019-02-20 14:38:30 +01:00 committed by Stephane Nicoll
parent 53326695ea
commit 221ff8d69f
1 changed files with 19 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
spring-boot-project/spring-boot-docs/src/main/asciidoc/howto.adoc
View File

@ -1154,9 +1154,15 @@ tend to send accept headers that prefer XML.
[[howto-write-an-xml-rest-service]]
=== Write an XML REST Service
If you have the Jackson XML extension (`jackson-dataformat-xml`) on the classpath, you
If you have the Jackson XML extension (`jackson-dataformat-xml`) or JAXB on the classpath, you
can use it to render XML responses. The previous example that we used for JSON would
work. To use the Jackson XML renderer, add the following dependency to your project:
work.
NOTE: To get the server to render XML instead of JSON, you might have to send an
`Accept: text/xml` header (or use a browser).
==== Jackson XML
To use the Jackson XML renderer, add the following dependency to your project:
[source,xml,indent=0,subs="verbatim,quotes,attributes"]
----
@ -1166,8 +1172,9 @@ work. To use the Jackson XML renderer, add the following dependency to your proj
</dependency>
----
If Jackson's XML extension is not available, JAXB (provided by default in the JDK) is
used, with the additional requirement of having `MyThing` annotated as
==== JAXB
If Jackson's XML extension is not available, JAXB is tried next,
with the additional requirement of having `MyThing` annotated as
`@XmlRootElement`, as shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"]
@ -1179,9 +1186,15 @@ used, with the additional requirement of having `MyThing` annotated as
}
----
To get the server to render XML instead of JSON, you might have to send an
`Accept: text/xml` header (or use a browser).
To use JAXB as XML renderer, add the following dependency to your project:
[source,xml,indent=0,subs="verbatim,quotes,attributes"]
----
<dependency>
<groupId>org.glassfish.jaxb</groupId>
<artifactId>jaxb-runtime</artifactId>
</dependency>
----
[[howto-customize-the-jackson-objectmapper]]