Apache HttpClientを使用したRESTful Javaクライアント

Apache HttpClient は、RESTfulなサービスを含め、HTTP操作を実行するための堅牢で完全なソリューションJavaライブラリです。このチュートリアルでは、 HttpClient を使用してRESTful Javaクライアントを作成し、「 GET 」および「 POST 」リクエストを実行する方法を説明します。

1. Apache HttpClientを入手する

Apache HttpClientはMavenの中央リポジトリで利用でき、Mavenの `pom.xml`ファイルで宣言します。

File:pom.xml

    <dependency>
        <groupId>org.apache.httpcomponents</groupId>
        <artifactId>httpclient</artifactId>
        <version>4.1.1</version>
    </dependency>

2. GETリクエスト

最後のRESTサービスをもう一度見直してください。

@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;

    }
   //...

Apache HttpClientが「GET」リクエストを送信します。

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import org.apache.http.HttpResponse;
import org.apache.http.client.ClientProtocolException;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.DefaultHttpClient;

public class ApacheHttpClientGet {

    public static void main(String[]args) {
      try {

        DefaultHttpClient httpClient = new DefaultHttpClient();
        HttpGet getRequest = new HttpGet(
            "http://localhost:8080/RESTfulExample/json/product/get");
        getRequest.addHeader("accept", "application/json");

        HttpResponse response = httpClient.execute(getRequest);

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

        BufferedReader br = new BufferedReader(
                         new InputStreamReader((response.getEntity().getContent())));

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

        httpClient.getConnectionManager().shutdown();

      } catch (ClientProtocolException e) {

        e.printStackTrace();

      } catch (IOException e) {

        e.printStackTrace();
      }

    }

}

出力…​

Output from Server ....

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

3. POSTリクエスト

最後のRESTサービスも見直してください。

@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();

    }
   //...

Apache HttpClientが "POST"リクエストを送信します。

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.MalformedURLException;
import org.apache.http.HttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.DefaultHttpClient;

public class ApacheHttpClientPost {

    public static void main(String[]args) {

      try {

        DefaultHttpClient httpClient = new DefaultHttpClient();
        HttpPost postRequest = new HttpPost(
            "http://localhost:8080/RESTfulExample/json/product/post");

        StringEntity input = new StringEntity("{\"qty\":100,\"name\":\"iPad 4\"}");
        input.setContentType("application/json");
        postRequest.setEntity(input);

        HttpResponse response = httpClient.execute(postRequest);

        if (response.getStatusLine().getStatusCode() != 201) {
            throw new RuntimeException("Failed : HTTP error code : "
                + response.getStatusLine().getStatusCode());
        }

        BufferedReader br = new BufferedReader(
                        new InputStreamReader((response.getEntity().getContent())));

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

        httpClient.getConnectionManager().shutdown();

      } 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/RESTful-Java-Client-ApacheHttpClient-Example.zip[RESTful-Java-Client-ApacheHttpClient-Example.zip](9 KB)

=== 参考文献

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

.  http://hc.apache.org/httpcomponents-client-ga/index.html[Apache

HttpClient]。リンク://webservices/jax-rs/restfull-java-client-with-java-net-url/[RESTful

Javaクライアントとjava.net.URL]

link://タグ/クライアント/[クライアント]リンク://タグ/httpclient/[httpclient]link://tag/jax-rs/[jax-rs]link://tag/restful/[restful]
前の投稿:Java正規表現チュートリアル
次の投稿:JSONを読み書きするGsonストリーミング