RESTful Web サービスについて

REST (REpresentational State Transfer) は、World Wide Web などの分散ハイパーメディアシステム用アーキテクチャースタイルです。RESTful アーキテクチャーで中心となるのは、URI (Universal Resource Identifier) によって識別されるリソースという概念です。これらのリソースは HTTP などの標準インタフェースを使用して操作できます。また情報は、これらのリソースの表現を使用して交換されます。このチュートリアルでは、最初に REST について少し学習したあと、NetBeans IDE がこのアーキテクチャー型をサポートする方法について説明します。

目次

• はじめに
• RESTful Web サービス、永続性、およびエンティティークラス
• データベースからの RESTful Web サービスの作成
  • プロジェクトの作成
  • エンティティークラスと RESTful サービスの生成
• RESTful Web サービスのテスト
• Google マップ機能の追加
• Spring Framework での RESTful Web サービス
  • Spring Framework を使用した Java Web アプリケーションの作成
  • プロジェクトへの aopalliance.jar の追加
  • Spring 対応プロジェクトでの RESTful サービスの作成
  • コンパイルエラー

このチュートリアルに従うには、次のソフトウェアとリソースが必要です。

ソフトウェアまたはリソース	必須バージョン
NetBeans IDE	Java EE ダウンロードバンドル
Java Development Kit (JDK)	version 6 または 7
Java EE 互換の Web サーバーまたはアプリケーションサーバー	Tomcat Web サーバー 6.x-7.x、Oracle WebLogic Server 11g-12c、 または GlassFish Server Open Source Edition 3.x。 重要: このチュートリアルで Tomcat を使用する場合は次を参照してください。 REST による Tomcat に関する NetBeans の Wiki。
jdbc/sample データベース - Java DB (Derby) データベースサーバーまたは MySQL データベースサーバー	Java DB (Derby) の場合、jdbc/sample データベースは NetBeans IDE によって生成され、 そのタイミングは IDE と GlassFish アプリケーションサーバーをインストールしたときです。 MySQL の場合、IDE 内から MySQL サーバー上でサンプルデータベースを作成したあと、IDE はサンプルデータベースにデータを生成します。

Tomcat および GlassFish サーバーは、どちらも NetBeans IDE の Web および Java EE の配布とともにインストールできます。または、GlassFish サーバーのダウンロードページか Apache Tomcat のダウンロードページからダウンロードすることもできます。

重要: Java EE 6 プロジェクトには、Tomcat 7.x、GlassFish Server 3.x、または Oracle WebLogic Server 12c が必要です。

はじめに

RESTful Web サービスは、RESTful アーキテクチャースタイルを使用して構築されたサービスです。RESTful アプローチを使用する Web サービスの構築は、インターネット上にサービスを配備するために、SOAP ベースのテクノロジを使用する代わりとして幅広く使用されています。これは、軽量かつ HTTP 経由でデータを直接送信できるためです。

IDE は、JAX-RS (JSR 311 - Java API for RESTful Web Services) および Jersey (JAX-RS のリファレンス実装) を使用する、RESTful Web サービスの迅速な開発をサポートしています。

詳細については、次を参照してください。

• JSR 311: JAX-RS: The Java API for RESTful Web Services
• Jersey, the open source JAX-RS (JSR 311) Reference Implementation for building RESTful Web services

RESTful Web サービスの構築に加え、IDE は RESTful Web サービスにアクセスするクライアントアプリケーションの構築、テスト、および Web サービスを呼び出すコードの生成 (RESTful と SOAP ベースの両方) もサポートしています。

IDE が提供する RESTful 機能の一覧は次のとおりです。

1. JPA エンティティークラスおよびパターンからの RESTful Web サービスの迅速な作成。
2. 「サービス」ウィンドウの Web サービスマネージャーからコンポーネントをドラッグ＆ドロップすることによる、Google マップ、Yahoo News Search、StrikeIron Web サービスなどの Web サービスを呼び出すコードの迅速な生成。
3. Web サービスマネージャーに登録されたサービスに対する RESTful Java クライアントの生成。
4. RESTful Web サービスのテスト用テストクライアントの生成。
5. プロジェクト内の RESTful Web サービスの実装クラスを簡単にナビゲートする論理ビュー。
6. Spring トランザクション処理を提供する、完全に統合された Spring Framework。

このチュートリアルでは、RESTful Web サービスを生成、実装、およびテストする際、IDE がどのようなサポートを提供するのかを説明します。

RESTful Web サービス、永続性、およびエンティティークラス

Java における RESTful Web サービスは、データベースと通信するために Java Persistence API に依存しています。具体的には、RESTful Web サービスは Persistence API に定義されるようにエンティティークラスと永続性ユニットに依存しています。エンティティークラスはリレーショナルデータベース内のオブジェクトに対応する Java クラスです。Java EE5 チュートリアルには次のように記載されています。「エンティティーは軽量な永続性ドメインオブジェクトです。一般的に、エンティティーはリレーショナルデータベースの表を表現し、各エンティティーインスタンスはその表の行に相当します。」永続性ユニットは、persistence.xml ファイルで定義されるように、一連のエンティティークラス、データソース、永続性プロバイダ、および永続性ユニットの独自の名前で構成されます。

NetBeans IDE を使用して、エンティティークラスと RESTful Web サービスを同じプロセスで作成することも、既存のエンティティークラスから RESTful Web サービスを作成することもできます。このチュートリアルでは、「データベースからの RESTful サービス」ウィザードを使用して、エンティティークラスと RESTful Web サービスを同じプロセスで生成します。ウィザードは永続性ユニットを自動的に生成します。

MySQL データベースサーバーの使用

JavaDB (Derby) でなく MySQL データベースサーバーを使用する場合、データベースサーバーを IDE に登録し、sample データベースをサーバーに追加する必要があります。

このチュートリアルで MySQL データベースサーバーを使用するには、次の手順に従います。

1. MySQL サーバーがまだ登録されていない場合、サーバーを IDE に登録します。MySQL サーバーを登録するには、IDE の「サービス」ウィンドウに移動し、「データベース」ノードを右クリックして「MySQL サーバーを登録」を選択します。
   

2. 管理者のユーザー名やパスワードなどの MySQL サーバーの構成の詳細情報を入力するダイアログが開きます。「MySQL データベースへの接続」の「MySQL サーバープロパティーの構成」を参照してください。

   
3. MySQL サーバーを起動し、これに接続します。「MySQL データベースへの接続」の「MySQL サーバーの起動」を参照してください。
4. MySQL サーバーのノードを右クリックし、「データベースを作成」を選択します。「MySQL データベースの作成」ダイアログが開きます。
   
5. 新規データベース名として「sample」と入力します。root ユーザーまたは選択したユーザーにフルアクセス権を付与します。
   
6. 「了解」をクリックします。ダイアログが開き、sample がサンプルデータベースの名前であることを通知し、このデータベースの表、オブジェクト、およびデータを作成するかどうかをユーザーに尋ねます。
   
7. 「はい」をクリックします。IDE はデータベースを作成してデータを生成し、このデータベースに接続を追加します。
   

データベースからの RESTful Web サービスの作成

この課題の目標は、プロジェクトを作成し、データベースからエンティティークラスと RESTful Web サービスを生成することです。

この節では JavaDB (Derby) データベースと jdbc/sample データソースを使用します。JavaDB は SDK に含まれています。jdbc/sample データソースは、IDE と GlassFish を一緒にインストールするとき、NetBeans IDE によって自動的に生成されます。

IDE により、RESTful Web サービスが生成されます。IDE が完了したら、「プロジェクト」ウィンドウを見ます。生成されたエンティティークラスは entities パッケージ内にあります。サービスは service パッケージ内にあります。EE5 プロジェクトの場合、JPA コントローラクラスが controller パッケージ内にあり、web.xml 配備記述子が「構成ファイル」の下にあります。

注意: IDE で「参照の問題を解決」プロンプトが表示されることがあります。この場合、「CustomerDB」プロジェクトノードを右クリックし、「参照の問題を解決」を選択します。この問題は、サービスが WebLogic インストールで実行される最初の Jersey アプリケーションである場合に発生することがあります。この場合、IDE は Jersey ライブラリをサーバーにコピーすることによって参照問題を解決します。

データベースからの EE6 RESTful Web サービスは、各サービスクラスの EntityManager をインスタンス化します。これにより、JPA コントローラクラスが不要になり、よりシンプルなコードが生成されます。

RESTful Web サービスのテスト

この課題の目標は、アプリケーションを試してみることです。

1. プロジェクトのノードを右クリックし、「RESTful Web サービスをテスト」を選択します。テストクライアントを生成する場所を、サービスプロジェクト内にするか、別の Java Web プロジェクト内にするかを尋ねるダイアログが開きます。このオプションによって、一部のブラウザのセキュリティー制限を回避できます。CustomerDB プロジェクトと同じサーバードメインに配備されるように構成されていれば、すべての Web プロジェクトを使用できます。
   
2. テストクライアントを生成する場所を選択し、「了解」をクリックします。サーバーが起動し、アプリケーションが配備されます。配備が完了すると、それぞれの Web サービスへのリンク付きで、ブラウザにアプリケーションが表示されます。

   1 つ以上のクラスが存在しておらず、プロジェクトが構築されないというエラーメッセージが「出力」ウィンドウに表示された場合、コンパイル時ライブラリに Jersey ライブラリを追加します。プロジェクトのノードを右クリックし、「プロパティー」を選択します。「プロパティー」ツリーメニューで、「ライブラリ」を選択します。「ライブラリを追加」をクリックし、Jersey ライブラリを参照します。

   

   左側にルートリソースの組があります。ここでは、customers と discountCodes という名前が付いています。

3. 「customers」ノードをクリックします。ブラウザウィンドウで Customers サービスのテスト用パラメータのリストが表示されます。
   

   次のパラメータを設定できます。

   • テストするメソッドを選択します。ドロップダウンリストから、GET または POST メソッドおよび MIME タイプを選択します。
   • 開始。表示する最初のエンティティー。番号設定は 1 ではなく 0 から開始します。
   • 最大。フェッチするエンティティーの最大数。0 を設定すると、すべてのエンティティーがフェッチされます。
   • 展開レベル。高度な機能。一部のサービスは、無限に繰り返されるツリー階層を返します。このパラメータは、raw データのビューで表示する階層の深さを指定します。
   • クエリー。高度な機能。JPA 構文に従って、XML または JSON ドキュメントを検索します。
4. メソッドのドロップダウンリストをクリックし、「GET(application/xml)」を選択します。「最大」フィールドに「3」を入力します。その他のパラメータはデフォルトの値のままにし、「テスト」をクリックします。結果が「テスト出力」セクションに表示されます。
   

   「テスト出力」セクションには 5 つのタブがあります。

   • 「表形式ビュー」は出力結果のドキュメントにあるすべての URI を表示するフラットなビューで、リンクをクリックすることで移動できます。
   • 「raw データのビュー」は実際に戻ってきたデータを表示します。選択した MIME タイプ (application/xml または application/json) により、表示されるデータはそれぞれ XML または JSON 形式です。
   • 「サブリソース」タブには、ルートリソースとサブリソースの URL が表示されます。RESTful Web サービスはデータベースのエンティティークラスに基づいており、ルートリソースはデータベース表を、サブリソースは列を表します。
   • 「ヘッダー」タブには HTTP ヘッダー情報が表示されます。
   • 「HTTP モニター」タブに、送受信された実際の HTTP 要求および応答が表示されます。

   最大 3 エンティティーを表示するよう指定しましたが、6 つの結果が一覧表示されています。その理由を参照するには、「raw データのビュー」タブを開いてください。各エンティティーが <customer> 要素に対応しており、テスト結果には 3 customer しかありません。しかし、Tablular ビューはエンティティーではなく URI を一覧表示しており、各エンティティーには親の <customer> 要素の属性と子の <discountCode> 要素の属性という 2 つの URI があります。そのため、customer エンティティーが 3 つしかなくても、URI は合計 6 つあります。

   
5. ブラウザを閉じ、IDE に戻ります。

Google マップ機能の追加

この課題の目標は、Google マップの機能を RESTful Web サービスに追加することです。

1. エディタで CustomerRESTFacade クラス (EE 5) または CustomerFacadeREST クラス (EE 6) を開きます。
2. クラスに次のメソッドを追加します。

   @GET
   @Produces("text/html")
   public String getGoogleMap() {
   // Drag and drop the getGoogleMap operation here
   
      return "";
   }

3. http://www.google.com/apis/maps/signup.html で Google マップのキーにサインアップします。Google マップのキー要求ダイアログには、ユーザーの Web サイトの URL を入力するフィールドがあります。このフィールドに「http://localhost:8080」と入力します。
4. IDE で「サービス」タブを開き、「Web サービス」ノードを展開します。「Web サービス」で「Google」を展開します。「Google」で「Map Service」を展開します。
   
   
5. getGoogleMap 項目をドラッグし、手順 2 で作成した getGoogleMap メソッド本文の return = ""; 行の直前にドロップします。「getGoogleMap SaaS サービスのカスタマイズ」ダイアログが開きます。デフォルト値のままにして、「了解」をクリックします。

   IDE によって、次の try ブロックが CustomerResource クラスの getGoogleMap メソッドに追加されます。

   @GET
   @Produces("text/html")
   public String getGoogleMap() {
   // Drag and drop the getGoogleMap operation here
           
       try {
                
            String address = "16 Network Circle, Menlo Park";
            java.lang.Integer zoom = 15;
            String iframe = "false";
            RestResponse result = GoogleMapService.getGoogleMap(address, zoom, iframe);
            //TODO - Uncomment the print Statement below to print result.
            //System.out.println("The SaasService returned: "+result.getDataAsString());
       } catch (Exception ex) {
            ex.printStackTrace();
       }
   
       return "";
   
   }
                   

   IDE は、次のクラスおよびリソースを含む org.netbeans.saas と org.netbeans.saas.google のパッケージも作成します。

   • RestConnection - HttpUrlConnection を囲むラッパー
   • RestResponse - HTTP 応答用のラッパー
   • googlemapservice.properties - API キーを格納するプロパティーファイル
   • GoogleMapService - ラッパーメソッドを含むサービスラッパーで、RestConnection を使用して Google マップサービスを呼び出します。
   
6. getGoogleMap() の try ブロックで、コメントアウトされた print 文を行 return result.getDataAsString(); に置き換えます。メソッドは次のようになります。

   @GET
   @Produces("text/html")
   public String getGoogleMap() {
   // Drag and drop the getGoogleMap operation here
           
       try {
                
            String address = "16 Network Circle, Menlo Park";
            java.lang.Integer zoom = 15;
            String iframe = "false";
            RestResponse result = GoogleMapService.getGoogleMap(address, zoom, iframe);
            return result.getDataAsString();
       } catch (Exception ex) {
            ex.printStackTrace();
       }
   
       return "";
   }

7. googlemapservice.properties を開きます。手順 3 で Google から取得した API キーにペーストします。
8. CustomerDB project ノードを右クリックし、「RESTful Web サービスをテスト」を選択します。IDE によってプロジェクトがサーバーから配備解除および再配備され、テストクライアントでブラウザウィンドウに表示されます。
9. 左サイドバーの「customers」を選択します。customers のテスト条件が主区画に表示されます。デフォルトのまま、「テスト」をクリックします。customers の表が開きます。
10. 表の customer1 をクリックします。その顧客のテストウィンドウが主区画で開きます。ドロップダウンメニューから、text/html MIME タイプを選択します。「テスト」をクリックします。Menlo Park、Network Circle 16 の Google マップが「raw データのビュー」で開きます。
    

11. Menlo Park の住所の Google マップは、データベースにあるすべての顧客に表示されます。顧客の実際の住所の Google マップを表示するには、Customer のインスタンスを作成し、その Customer のインスタンスの住所の各変数を連結したものを住所として設定します。

    EE5 サービスの場合、getEntity() メソッドを使用して、データベースの各エンティティーについて Customer のインスタンスを作成します (変更は太字で示しています)。

    EE5 サービス:

    @GET
    @Produces("text/html")
    public String getGoogleMap() {
        try {
             Customer c = getEntity();
             String address = c.getAddressline1() + " " + c.getAddressline2() + " " +
                     c.getCity() + " " + c.getState() + " " + c.getZip();
             java.lang.Integer zoom = 15;
             String iframe = "false";
     
             RestResponse result = GoogleMapService.getGoogleMap(address, zoom, iframe);
             return result.getDataAsString();
         
         } catch (Exception ex) {
             ex.printStackTrace();
         } 
    
         
         return "";
     }

    EE6 サービスの場合、抽象ファサードから汎用的な find() メソッドを呼び出すことによって Customer のインスタンスを作成します。汎用的な find() メソッドでは、オブジェクトへの明示的な引数型キャストと明示的なエンティティー ID が必要です。次の EE6 コードは、顧客 ID 番号 1 のマップ位置を表示します (変更は太字で示しています)。

    EE6 サービス:

    @GET
    @Produces("text/html")
    public String getGoogleMap() {
        try {
             Customer c = getEntityManager().find(Customer.class, 1);
             String address = c.getAddressline1() + " " + c.getAddressline2() + " " +
                     c.getCity() + " " + c.getState() + " " + c.getZip();
             java.lang.Integer zoom = 15;
             String iframe = "false";
     
             RestResponse result = GoogleMapService.getGoogleMap(address, zoom, iframe);
             return result.getDataAsString();
         
         } catch (Exception ex) {
             ex.printStackTrace();
         } 
    
         
         return "";
     }

12. RESTful Web サービスを再テストします。EE5 サービスの場合、いずれかの顧客について text/html MIME タイプを選択します。データベースにある顧客の住所の Google マップが「raw データのビュー」に表示されます。EE6 サービスの場合、顧客 ID は find() メソッドの引数として指定され、テスターはデフォルトで Raw ビューを表示します。customer1 の場合、次のマップが表示されます。
    

    注: Google マップが住所を検索できない場合、海を拡大表示します。

Spring Framework での RESTful Web サービス

Jersey は Spring Framework に統合されています。Spring Framework で Java Web アプリケーションを作成する場合、REST を認識するサーブレットが自動的に作成されます。ただし、Spring 3 には RESTful Web サービスが EntityManager オブジェクトを注入するために必要とする aopalliance.jar が含まれていません。

関連項目

NetBeans IDE を使用した Java EE アプリケーションの開発方法についての詳細は、次のリソースを参照してください。

• NetBeans による簡単な RESTful Web サービスの生成
• NetBeans モジュールでの RESTful サービスクライアントの作成
• Web サービスの学習
• YouTube: RESTful Web Services, Building and Deploying (Part 1)
• YouTube: NetBeans RESTful Testing and Invoking RESTful Resources (Part 2)

メーリングリストに登録することによって、NetBeans IDE Java EE 開発機能に関するご意見やご提案を送信したり、サポートを受けたり、最新の開発情報を入手したりできます。