JAX-RSを使ったWebサービスの作成

Java EE 6 開発入門（8）

パラメータとURIパス

　では先ほど生成されたリソースクラスに対してGETメソッドの内容を実装して、動作確認をします。生成された@GETを実装するメソッドは以下のようになっていました。

リスト2 リソースクラス UserResource.java

@Path("user")
public class UserResource {
    …(中略)…
    @GET
    @Produces("text/plain")
    public String getText() {
        //TODO return proper representation object
        throw new UnsupportedOperationException();
    }
    …(中略)…
}

　getText()メソッドはStringで値を返すよう定義しており、このメソッドはまだ実装していないのでUnsupportedOperationExceptionを返しています。この内容を修正していきましょう。

　まずは単純に何らかの文字列を返す、非常に簡単な機能を実装します。次のようにgetText()メソッドの内容を修正してみましょう。

リスト3 @GETメソッド変更後のリソースクラス UserResource.java

@Path("user")
public class UserResource {
    …(中略)…
    @GET
    @Produces("text/plain")
    public String getText() {
        return "This is JAX-RS Message.";
    }
    …(中略)…
}

　これでリソースクラスの準備はできましたので、実際にサーバーを動作してからリソースを取得してみましょう。まずはサーバーへアプリケーションを搭載（デプロイ）します。次の図のように、SampleAppプロジェクトを選択し、右クリックを押して「デプロイ」を選択します（デプロイは初回のみ行います。デプロイ後に変更したクラスは自動的にサーバーへ反映されます）。

図10 サーバーへアプリケーションをデプロイ

　デプロイを選択すると、自動的にGlassFishサーバーが起動し、プロジェクトが配置されます。サーバーが起動完了するまでに数秒～数十秒必要です。無事サーバーの起動が完了したらテストを行い、先ほど編集したメッセージが出力されるかを確認します。

　テストの開始方法は、以下の図のようにSampleAppプロジェクト内の「RESTful Webサービス」内にある「UserResource[user]」を選択して右クリックをし、「テスト・リソースURI」を選びます。

図11 RESTful Webサービスのテスト選択

　テスト・リソースURIを選択すると、ブラウザが自動的に起動してアドレスバーに次のURIが入力され、次の図の画面が表示されます。

• http://localhost:8080/SampleApp/webresources/user

図12 Webサービスのテスト結果

　先ほどGETメソッドに編集した「This is JAX-RS Message.」が表示されたことを確認できました。今回の例では@Producesで「text/plain」と設定していますので、ブラウザはそのままテキストを表示していますが、他にもHTMLやJSON形式のデータも選べます。

まとめ

　今回はJAX-RSでWebサービスを作成し、確認するところまで紹介しました。次回は作成したWebサービスに対して、機能を追加していきます。

参考文献

• The Java EE 6 Tutorial:Creating a RESTful Root Resource Class
• Example Applications for JAX-RS