準備

使用するためには JAR ファイルをライブラリパスに追加するとか、Maven の依存関係管理に追加するとかする必要があります。 2014 年 11 月 8 日現在の最新バージョンは 1.19.0 で、Maven Central Repository に置かれています。

• Artifact Details For com.google.http-client:google-http-client:1.19.0

Gradle を使っているならば次のように依存関係を記述すればよいです。

repositories {    mavenCentral()}dependencies {    compile'com.google.http-client:google-http-client:1.19.0'}

HTTP リクエストを行う処理の全体の流れ

1. HttpTransport オブジェクトを用意する。
   • これはアプリケーション全体で 1 つだけ存在すればよい。
2. HttpTransport のcreateRequestFactoryメソッドを呼んでHttpRequestFactory オブジェクトを生成する。
3. HttpRequestFactory からHttpRequest を生成する。
4. HttpRequest のexecuteメソッドを呼び出してリクエスト実行、レスポンスとしてHttpResponse を取得。
5. レスポンスを処理したあと、終了処理。

サンプルコード

GET リクエストを投げてレスポンスボディを表示する例を Gist に置いてあります。 バージョン 1.19.0 を使用しています。

• サンプルコード:google-http-java-client を使用するサンプルコード

サンプルコード

/* 必要な import 文import com.google.api.client.http.GenericUrl;import com.google.api.client.http.HttpResponse;import com.google.api.client.http.UrlEncodedParser;import com.google.api.client.util.GenericData;*/// HttpRequest オブジェクトにパーサーを設定しておく。// (req は HttpRequest オブジェクト)req.setParser(new UrlEncodedParser());// リクエスト実行。HttpResponse res = req.execute();try {// レスポンスのパースを行う。 (上で設定した UrlEncodedParser が使われる。)    GenericData d = res.parseAs(GenericData.class);}finally {// (以下略)

レスポンスのパース後のクラスを作る

上の例ではパース後のクラスとしてGenericData を使用しましたが、どういうパラメータが渡ってくるかわかっている場合、それを受け取るためのクラスを用意しておいて、フィールドに値を設定させることもできます。

例えば、OAuth 1.0 Protocol の Temporary Credentials を取得するためのリクエストのレスポンスをパースする場合を考えてみましょう。 レスポンスの形式は 「oauth_token=xxxxx&oauth_token_secret=xxxxx&oauth_callback_confirmed=true」 というものであることはわかっているので、次のようなクラスでレスポンスを受け取ることができます。@Key アノテーション をフィールドに付けることで、パースした結果を受け取るフィールドであることを示しています。

/* 必要な import 文import com.google.api.client.util.GenericData;import com.google.api.client.util.Key;*/// 必ずしも GenericData を継承する必要はないが、継承しておけばフィールドで定義されていないパラメータも受け取ることができる。publicclass OAuthTemporaryCredentialResponseextends GenericData {@Key("oauth_token")public String identifier;@Key("oauth_token_secret")public String sharedSecret;@Key("oauth_callback_confirmed")public String callbackConfirmed;}

そして、パース時にこのクラスを指定することでパース結果をOAuthTemporaryCredentialResponse オブジェクトとして受け取ることができます。

    OAuthTemporaryCredentialResponse d = res.parseAs(OAuthTemporaryCredentialResponse.class);    System.out.println("identifier: " + d.identifier);// フィールドアクセスによりレスポンスの値にアクセスできる。