17.3. JAXB and XML provider
RESTEasy provides the required JAXB provider support for XML. It has several additional annotations to make application coding simpler.
17.3.1. @XmlHeader
and @Stylesheet
To set an XML header when you output XML documents, use the
@org.jboss.resteasy.annotations.providers.jaxb.XmlHeader
annotation.
@XmlRootElement public static class Thing { private String name; public String getName() { return name; } public void setName(String name) { this.name = name; } } @Path("/test") public static class TestService { @GET @Path("/header") @Produces("application/xml") @XmlHeader("<?xml-stylesheet type='text/xsl' href='${baseuri}foo.xsl' ?>") public Thing get() { Thing thing = new Thing(); thing.setName("bill"); return thing; } }
Here, the
@XmlHeader
forces an xml-stylesheet
header on the XML output. The same result can be obtained by placing the header on the Thing
class. Read the JavaDocs for further information regarding the substitution values provided by RESTEasy.
RESTEasy also has a convenient annotation for stylesheet headers. For example:
@XmlRootElement public static class Thing { private String name; public String getName() { return name; } public void setName(String name) { this.name = name; } } @Path("/test") public static class TestService { @GET @Path("/stylesheet") @Produces("application/xml") @Stylesheet(type="text/css", href="${basepath}foo.xsl") @Junk public Thing getStyle() { Thing thing = new Thing(); thing.setName("bill"); return thing; } }