JavaのJacksonライブラリを使ってXMLをPOJOに変換する方法

JacksonはJava向けの強力なライブラリで、優れたデータバインディング機能を備えています。JSONとJavaオブジェクト間のシリアライズ・デシリアライズを簡単に行えるフレームワークを提供しており、多くのJavaプロジェクトで標準的に利用されています。

実は、JacksonはJSONだけでなくXML形式のデータをPOJO（Plain Old Java Object）に変換することも可能です。その際に活用するのが、jackson-dataformat-xmlモジュールに含まれるXmlMapperクラスです。XmlMapperクラスのreadValue()メソッドを使うことで、XML文字列やストリームから直接Javaオブジェクトへのマッピングが行えます。

readValue()メソッドの構文

public <T> T readValue(XMLStreamReader r, Class<T> valueType) throws IOException

依存関係の追加

XmlMapperを使用するには、Mavenプロジェクトの場合、以下の依存関係をpom.xmlに追加します。

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

サンプルコード

以下は、XML文字列をPersonクラス（POJO）に変換する具体例です。

import com.fasterxml.jackson.dataformat.xml.*;

public class XMLToPOJOTest {
   public static void main(String args[]) throws Exception {
      try {
         XmlMapper xmlMapper = new XmlMapper();
         Person pojo = xmlMapper.readValue(getXmlString(), Person.class);
         System.out.println(pojo);
      } catch(Exception e) {
         e.printStackTrace();
      }
   }

   private static String getXmlString() {
      return "<person> <firstName>Adithya</firstName>"
            + "<lastName>Jai</lastName>"
            + "<address>Bangalore</address></person>";
   }
}

// Personクラス（POJO）
class Person {
   private String firstName;
   private String lastName;
   private String address;

   public String getFirstName() {
      return firstName;
   }
   public void setFirstName(String firstName) {
      this.firstName = firstName;
   }
   public String getLastName() {
      return lastName;
   }
   public void setLastName(String lastName) {
      this.lastName = lastName;
   }
   public String getAddress() {
      return address;
   }
   public void setAddress(String address) {
      this.address = address;
   }

   @Override
   public String toString() {
      return "Person[ " +
             "firstName = " + firstName +
             ", lastName = " + lastName +
             ", address = " + address +
             " ]";
   }
}

実行結果

Person[ firstName = Adithya, lastName = Jai, address = Bangalore ]

ポイント解説

• XmlMapperはObjectMapperのXML版であり、使い方はほぼ同じです。
• readValue()メソッドの第1引数にはXML文字列・File・InputStreamなど、第2引数にはマッピング先のクラスを指定します。
• XMLの要素名とPOJOのフィールド名が一致していれば、アノテーションなしでも自動的にマッピングされます。名前が異なる場合は@JacksonXmlPropertyアノテーションで対応付けできます。
• 逆にPOJOからXMLへ変換したい場合は、writeValueAsString()メソッドを使用します。