How to deserialize XML with annotations using FasterXML

sbenderli picture sbenderli · May 13, 2014 · Viewed 12.6k times · Source

I have the following XML schema:

<Courses semester="1">
    <Course code="A231" credits="3">Intermediate A</Course>
    <Course code="A105" credits="2">Intro to A</Course>
    <Course code="B358" credits="4">Advanced B</Course>
</Courses>

I need to convert this into POJO as:

public class Schedule
{
   public int semester;
   public Course[] courses;
}

public class Course
{
   public String code;
   public int credits;
   public String name;
}

There are two important things to note here:

  1. The courses object are not wrapped in a tag
  2. Some of the properties are attributes

How do I need to annotate my objects to get FasterXML to deserialize this xml?

Answer

Michał Ziober picture Michał Ziober · May 13, 2014

You have to add jackson-dataformat-xml dependency to your project:

<dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-xml</artifactId>
    <version>2.3.3</version>
</dependency>

After that you can use XML annotations in this way:

@JacksonXmlRootElement(localName = "Courses")
class Schedule {

    @JacksonXmlProperty(isAttribute = true)
    private int semester;

    @JacksonXmlProperty(localName = "Course")
    private Course[] courses;

    // getters, setters, toString, etc
}

class Course {

    @JacksonXmlProperty(isAttribute = true)
    private String code;

    @JacksonXmlProperty(isAttribute = true)
    private int credits;

    @JacksonXmlText(value = true)
    private String name;

    // getters, setters, toString, etc
}

Now, you have to use XmlMapper instead of ObjectMapper:

JacksonXmlModule module = new JacksonXmlModule();
module.setDefaultUseWrapper(false);
XmlMapper xmlMapper = new XmlMapper(module);

System.out.println(xmlMapper.readValue(xml, Schedule.class));

Above script prints:

Schedule [semester=1, courses=[[code=A231, credits=3, name=Intermediate A], [code=A105, credits=2, name=Intro to A], [code=B358, credits=4, name=Advanced B]]]