Kōhei Yamamoto

Jackson で JSON データを POJO に格納

前回に続いて。

Jackson を使うと、JSON から POJO へデータを格納できる。

基本

以下のような Book という POJO を考える。著者が一人しか設定できないなど、いろいろ問題があるが、例なので気にしないでほしい。

public final class Book {
    private String title;
    private String author;
  private String year;


    public Book() {}


    public String getTitle() { return title; }
  public void setTitle(String title) { this.title = title; }
  public String getAuthor() { return author; }
  public void setAuthor(String author) { this.author = author; }
  public String getYear() { return year; }
  public void setYear(String year) { this.year = year; }
}

一方、以下のような内容の JSON ファイル books.json を考える。ここで、

ことに注意。

[
    {
      "title":"Harry Potter and the Philosopher's Stone",
    "author":"J.K. Rowling",
    "year":"1997"
  }
]

このとき、以下のコードで、JSON ファイルから読み込んだデータが Book に格納される。

ObjectMapper mapper = new ObjectMapper();
Book book = mapper.readValue(new File("books.json"), Book.class)
book.getTitle();    // Harry Potter and the Philosopher's Stone
book.getAuthor();    // J.K. Rowling
book.getYear();    // 1997

JSON のキー名と POJO のフィールド名が不一致のとき

Book のフィールド名 year を firstEditionYear に変え、getter/setter もそれにしたがって変えるとする。このとき、POJO と JSON で持つ値の名前が一致しない。

このような場合、JsonProperty アノテーションを使えばよい。以下に例を示す。

public final class Book {
    private String title;
    private String author;


    @JsonProperty("year")
  private String firstEditionYear;    // <- 名前が JSON でのキー名と一致しないが、アノテーションで year に対応することを明示


    public Book() {}


    public String getTitle() { return title; }
  public void setTitle(String title) { this.title = title; }
  public String getAuthor() { return author; }
  public void setAuthor(String author) { this.author = author; }


    // 以下も名前が JSON のキー名と一致しないが、アノテーションで year に対応することを明示
  @JsonProperty("year")
  public String getFirstEditionYear() { return firstEditionYear; }
  public void setFirstEditionYear(String year) { this.firstEditionYear = firstEditionYear; }
}

これで、前の例と同じように JSON データを POJO へ格納できる。

不変オブジェクトへデータを格納するとき

これまでの POJO は setter を持っていた。つまり、不変でない。しかし、Effective Java 第 15 項にあったように、不変なオブジェクトには多くの利点がある。そのため、JSON から読み込んだデータを不変オブジェクトに格納したい。

まず、不変オブジェクトにするために setter を削除する。さらに、JSON から読み込んだデータによって、オブジェクト生成時にのみ値を設定できるように、JsonCreator アノテーションを付け、引数に JsonProperty を付けたコンストラクタを定義する。

不変な Book は以下のようになる。

public final class Book {
    private String title;
    private String author;
  private String year;


    @JsonCreator
    public Book(@JsonProperty("title") String title,
              @JsonProperty("author") String author,
        @JsonProperty("year") String year) {
      this.title = title;
    this.author = author;
    this.year = year;
  }


    public String getTitle() { return title; }
  public String getAuthor() { return author; }
  public String getYear() { return year; }
}

これで、JSON からデータを読み込んで、不変なオブジェクトを生成することができる。

コレクションに格納するとき

books.json が、以下のように複数の本のデータを持っているとする。

[
    {
      "title":"Harry Potter and the Philosopher's Stone",
    "author":"J.K. Rowling",
    "year":"1997"
  },
    {
      "title":"Effective Java",
    "author":"Joshua Bloch",
    "year":"2008"
  },
  {
      "title":"Effective C++",
    "author":"Scott Meyers",
    "year":"2005"
  }
]

これらのデータを Java のコレクション、例えば List<Book> に格納したいときは以下のようにする。TypeReference<List<Book>> のインスタンスを渡すことで、イレイジャにより消されるジェネリックス型情報を ObjectMapper に教えている。

ObjectMapper mapper = new ObjectMapper();
List<Book> books = mapper.readValue(new File("books.json"), new TypeReference<List<Book>>() {});

books には JSON から読み込んだ複数データが格納されている。

books.at(0).getTitle();    // Harry Potter and the Philosopher's Stone
books.at(0).getAuthor();    // J.K. Rowling
books.at(0).getYear();    // 1997
Book ecpp = books.at(2);
ecpp.getTitle();    // Effective C++
ecpp.getAuthor();    // Scott Meyers
ecpp.getYear();    // 2005

まとめ

コード

Java 8 で動作。

参考文献