{"id":1460,"date":"2012-07-31T01:00:00","date_gmt":"2012-07-31T01:00:00","guid":{"rendered":"http:\/\/www.javacodegeeks.com\/2012\/10\/jaxb-no-annotations-required.html"},"modified":"2012-10-22T05:49:06","modified_gmt":"2012-10-22T05:49:06","slug":"jaxb-no-annotations-required","status":"publish","type":"post","link":"https:\/\/www.javacodegeeks.com\/2012\/07\/jaxb-no-annotations-required.html","title":{"rendered":"JAXB – No Annotations Required"},"content":{"rendered":"
There appears to be a misconception that annotations are required on the model in order to use a JAXB (JSR-222)<\/a> implementation. The truth is that JAXB is configuration by exception, so annotations are only required when you want to override default behaviour. In this example I’ll demonstrate how to use JAXB without providing any metadata. <\/p>\n

Domain Model <\/strong> <\/p>\n

I will use the following domain model for this example. Note how there are no annotations of any kind. <\/p>\n

Customer <\/strong> <\/p>\n

Customer<\/i> is the root object in this example. Normally we would annotate it with @XmlRootElement<\/i>. Later in the demo code you will see how we can use an instance of JAXBElement<\/i> instead. <\/strong> <\/p>\n

package blog.defaults;\r\n\r\nimport java.util.List;\r\n\r\npublic class Customer {\r\n\r\n    private String firstName;\r\n    private String lastName;\r\n    private List<PhoneNumber> phoneNumbers;\r\n\r\n    public String getFirstName() {\r\n        return firstName;\r\n    }\r\n\r\n    public void setFirstName(String firstName) {\r\n        this.firstName = firstName;\r\n    }\r\n\r\n    public String getLastName() {\r\n        return lastName;\r\n    }\r\n\r\n    public void setLastName(String lastName) {\r\n        this.lastName = lastName;\r\n    }\r\n\r\n    public List<PhoneNumber> getPhoneNumbers() {\r\n        return phoneNumbers;\r\n    }\r\n\r\n    public void setPhoneNumbers(List<PhoneNumber> phoneNumbers) {\r\n        this.phoneNumbers = phoneNumbers;\r\n    }\r\n\r\n}\r\n<\/pre>\n
PhoneNumber<\/strong>                    <\/p>\n
I have purposefully given the fields in this class nonsense names, so that later when we look at the XML you will be able to see that by default the element names are derived from the properties and not the fields.                      
 
<\/div> <\/div><\/p>\n
package blog.defaults;\r\n\r\npublic class PhoneNumber {\r\n\r\n    private String foo;\r\n    private String bar;\r\n\r\n    public String getType() {\r\n        return foo;\r\n    }\r\n\r\n    public void setType(String type) {\r\n        this.foo = type;\r\n    }\r\n\r\n    public String getNumber() {\r\n        return bar;\r\n    }\r\n\r\n    public void setNumber(String number) {\r\n        this.bar = number;\r\n    }\r\n\r\n}\r\n<\/pre>\n
Demo Code<\/strong>                                        <\/p>\n
Since we haven’t used                     @XmlRootElement<\/i>                    (or                     @XmlElementDecl<\/i>                   ) to associate a root element with our                     Customer<\/i>                    class we will need to tell JAXB what class we want to unmarshal the XML document to.  This is done by using one of the                     unmarshal <\/i>                   methods that take a                     Class<\/i>                    parameter (line 14).  This will return a J                    AXBElement<\/i>                   , the                     Customer<\/i>                    object is then accessed by calling                     getValue<\/i>                    on it (line 15).  To marshal the object back to XML we need to ensure that it is wrapped in a JAXBElement <\/i>to supply the root element information (line 17).<\/p>\n
package blog.defaults;\r\n\r\nimport javax.xml.bind.*;\r\nimport javax.xml.namespace.QName;\r\nimport javax.xml.transform.stream.StreamSource;\r\n\r\npublic class Demo {\r\n\r\n    public static void main(String[] args) throws Exception {\r\n        JAXBContext jc = JAXBContext.newInstance(Customer.class);\r\n\r\n        StreamSource xml = new StreamSource(\"src\/blog\/defaults\/input.xml\");\r\n        Unmarshaller unmarshaller = jc.createUnmarshaller();\r\n        JAXBElement<Customer> je1 = unmarshaller.unmarshal(xml, Customer.class);\r\n        Customer customer = je1.getValue();\r\n\r\n        JAXBElement<Customer> je2 = new JAXBElement<Customer>(new QName(\"customer\"), Customer.class, customer);\r\n        Marshaller marshaller = jc.createMarshaller();\r\n        marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);\r\n        marshaller.marshal(je2, System.out);\r\n    }\r\n\r\n}<\/pre>\n
input.xml\/Output <\/strong>                                                              <\/p>\n
The following is the input to and output from running the demo code.  The first thing we see is that it is a very reasonable XML representation of the data, there aren’t any JAXB artifacts. By default JAXB will marshal everything as XML elements, and based on our                      PhoneNumber<\/i> class we see that the element names were derived from the property names.                                           <\/p>\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n<customer>\r\n    <firstName>Jane<\/firstName>\r\n    <lastName>Doe<\/lastName>\r\n    <phoneNumbers>\r\n        <number>555-1111<\/number>\r\n        <type>work<\/type>\r\n    <\/phoneNumbers>\r\n    <phoneNumbers>\r\n        <number>555-2222<\/number>\r\n        <type>home<\/type>\r\n    <\/phoneNumbers>\r\n<\/customer>\r\n<\/pre>\n
Further Reading<\/strong>                   <\/p>\n
If you enjoyed this post then you may also be interested in:                                          <\/p>\n