[Java] JSON Binding with JAX-RS - Moxy, JSON-P, Jackson, Jettison (TOTD #214)

原文はこちら。
https://blogs.oracle.com/arungupta/entry/json_binding_with_jax_rs

---

プレゼンテーション中に頂く典型的な質問の一つに、「JAX-RSでJSONを使えるようにするにはどうすればいいの？」というものです。

JerseyでJSONを使えるようにする場合、基本的に3個のアプローチと、4個の異なるモジュールがあります。以下に簡単にまとめました。

	MOXy	JSON-P	Jackson	Jettison
POJO-based JSON Binding	○	×	○	×
JAXB-based JSON Binding	○	×	○	○
Low-level JSON parsing & processing	×	○	×	○

MOXyは、JerseyアプリケーションでサポートしているJSONバインディングのうちデフォルトかつ望ましい方法です。新しいサンプルが以下に追加されています。

glassfish~svn - Revision 62395: /branches/arun/javaee7-samples/samples/jaxrs/moxy
https://svn.java.net/svn/glassfish~svn/branches/arun/javaee7-samples/samples/jaxrs/moxy/

リソースの定義は以下のように行います。

@Path("endpoint")
public class MyResource {
    @POST
    @Produces(MediaType.APPLICATION_JSON)
    @Consumes(MediaType.APPLICATION_JSON)
    public MyObject echoObject(MyObject mo) {
        return mo;
    }
}

POJOは以下のように定義します。

public class MyObject {

    private String name;
    private int age;

    public MyObject() {
    }

    public MyObject(String name, int age) {
        this.name = name;
        this.age = age;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

アプリケーションのクラスは

@ApplicationPath("webresources")
public class MyApplication extends Application {
}

クライアントコードは、

Client client = ClientBuilder.newClient();

WebTarget target = client.target("http://"
        + request.getServerName()
        + ":"
        + request.getServerPort()
        + request.getContextPath()
        + "/webresources/endpoint");
System.out.println("POST request");
MyObject mo = target
        .request()
        .post(Entity.entity(new MyObject("Duke", 18), MediaType.APPLICATION_JSON), MyObject.class);
out.println("Received response: " + mo.getName() + ", " + mo.getAge() + "<br><br>");

JSON MOXyモジュール(jersey-media-moxy.jar)はクラスパスに入っているので、Jerseyが自動的にモジュールを発見し、JSONバインディングのサポートが有効になります。

すべてのアプローチおよびモジュールに関する詳細の説明は、以下のリンクからどうぞ。

Jersey 2.0 User Guide
Support for Common Media Type Representations
http://jersey.java.net/documentation/latest/media.html