このチュートリアルでは、Javaビルド・イン

HTTPクライアント・ライブラリ

を使用してRESTful Javaクライアントを作成する方法を説明します。使い方が簡単で、RESTサービスの基本操作を実行するのに十分です。

最後の ”

Jackson JAX-RS

“記事のRESTfulサービスが再利用され、 “java.net.URL`を使用します。 “java.net.HttpURLConnection`” ”

GET

“と ”

POST

“リクエストを送信する単純なJavaクライアントを作成します。

1. GETリクエスト

最後のRESTサービスを確認し、 “json”データをクライアントに返します。

@Path("/json/product")
public class JSONService {

    @GET
    @Path("/get")
    @Produces("application/json")
    public Product getProductInJSON() {

        Product product = new Product();
        product.setName("iPad 3");
        product.setQty(999);

        return product;

    }
   //...

Javaクライアントは “GET”要求を送信します。

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.URL;

public class NetClientGet {

   //http://localhost:8080/RESTfulExample/json/product/get
    public static void main(String[]args) {

      try {

        URL url = new URL("https://localhost:8080/RESTfulExample/json/product/get");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("GET");
        conn.setRequestProperty("Accept", "application/json");

        if (conn.getResponseCode() != 200) {
            throw new RuntimeException("Failed : HTTP error code : "
                    + conn.getResponseCode());
        }

        BufferedReader br = new BufferedReader(new InputStreamReader(
            (conn.getInputStream())));

        String output;
        System.out.println("Output from Server .... \n");
        while ((output = br.readLine()) != null) {
            System.out.println(output);
        }

        conn.disconnect();

      } catch (MalformedURLException e) {

        e.printStackTrace();

      } catch (IOException e) {

        e.printStackTrace();

      }

    }

}

出力…​

Output from Server ....

{"qty":999,"name":"iPad 3"}

2. POSTリクエスト

最後のRESTサービスを確認し、 “json”データを受け入れて、自動的にJacksonプロバイダ経由でProductオブジェクトに変換します。

@Path("/json/product")
public class JSONService {

        @POST
    @Path("/post")
    @Consumes("application/json")
    public Response createProductInJSON(Product product) {

        String result = "Product created : " + product;
        return Response.status(201).entity(result).build();

    }
   //...

Javaクライアントはjson文字列で “POST”リクエストを送信します。

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.URL;

public class NetClientPost {

   //http://localhost:8080/RESTfulExample/json/product/post
    public static void main(String[]args) {

      try {

        URL url = new URL("https://localhost:8080/RESTfulExample/json/product/post");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setDoOutput(true);
        conn.setRequestMethod("POST");
        conn.setRequestProperty("Content-Type", "application/json");

        String input = "{\"qty\":100,\"name\":\"iPad 4\"}";

        OutputStream os = conn.getOutputStream();
        os.write(input.getBytes());
        os.flush();

        if (conn.getResponseCode() != HttpURLConnection.HTTP__CREATED) {
            throw new RuntimeException("Failed : HTTP error code : "
                + conn.getResponseCode());
        }

        BufferedReader br = new BufferedReader(new InputStreamReader(
                (conn.getInputStream())));

        String output;
        System.out.println("Output from Server .... \n");
        while ((output = br.readLine()) != null) {
            System.out.println(output);
        }

        conn.disconnect();

      } catch (MalformedURLException e) {

        e.printStackTrace();

      } catch (IOException e) {

        e.printStackTrace();

     }

    }

}

出力…​

Output from Server ....

Product created : Product[name=iPad 4, qty=100]....

=== ソースコードをダウンロードする

ダウンロードする -  link://wp-content/uploads/2011/07/JAX-RS-Client-JavaURL-Example.zip[JAX-RS-Client-JavaURL-Example.zip](8 KB)

=== 参考文献

.  http://jackson.codehaus.org/%20[Jackson Official Website]

.  http://download.oracle.com/javase/6/docs/api/java/net/URL.html[java.net.URL

JavaDoc]。 http://download.oracle.com/javase/6/docs/api/java/net/HttpURLConnection.html[java.net.HttpURLConnection

JavaDoc]

link://tag/jax-rs/[jax-rs]link://tag/restful/[restful]link://tag/url/[url]