コンテナの選択

Web サービスは Web コンテナまたは EJB コンテナに配備できます。これは実装方法の選択によって決まります。たとえば Tomcat Web サーバーに配備する予定の場合、Tomcat Web サーバーには Web コンテナしかないため、EJB モジュールではなく Web アプリケーションの作成を選択してください。

1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。「Web」カテゴリから「Web アプリケーション」を選択するか、「エンタープライズ」カテゴリから「EJB モジュール」を選択します。
2. プロジェクトに CalculatorWSApplication という名前を付けます。
3. 使用する予定の配備先サーバーにより、次の作業を行います。
   • GlassFish の場合、「Java EE バージョン」を「Java EE 5」に設定します。
   • Tomcat Web サーバーの場合、「ソースレベルを 1.4 に設定」チェックボックスの選択を解除します。
4. 残りのページもクリックして進み、「完了」をクリックします。

Java クラスからの Web サービスの作成

1. 「CalculatorWSApplication」ノードを右クリックし、「新規」>「Web サービス」を選択します。
2. Web サービス名を「CalculatorWS」とし、「パッケージ」に「org.me.calculator」と入力して「完了」をクリックします。

   「プロジェクト」ウィンドウに新しい Web サービスの構造が表示され、エディタ領域にビジュアルデザイナが表示されます。たとえば Web アプリケーションの場合、次のように表示されているはずです。

   
   

Web サービスへのビジネスロジックの追加

1. ビジュアルデザイナで「オペレーションを追加」をクリックします。新しいオペレーションを定義できるダイアログが表示されます。
2. 「オペレーションを追加」ダイアログの上の部分で、「名前」に「add」、「戻り値の型」ドロップダウンリストに「int」と入力します。「オペレーションを追加」ダイアログの下の部分で、「追加」をクリックして int 型の i という名前のパラメータを作成します。ふたたび「追加」をクリックし、int 型の j というパラメータを作成します。

   画面は次のようになります。

   
   
3. 「オペレーションを追加」ダイアログの最下部で「了解」をクリックします。

   ビジュアルデザイナでは次のように表示されます。

   
   
4. 「ソース」をクリックすると、前の手順で生成されたソースコードが、次のようになっていることがわかります。
   
5. エディタで、スケルトンの add オペレーションを次のように拡張します (変更部分はボールドで表示)。

       @WebMethod
       public int add(@WebParam(name = "i") int i, @WebParam(name = "j") int j) {
           int k = i + j;
           return k;
               }

このコードからわかるように、この Web サービスは単に 2 つの数字を受け取り、合計を返すだけです。次の節では IDE でこの Web サービスをテストします。

クライアント 1: Java SE アプリケーションの Java クラス

この節では、標準の Java アプリケーションを作成します。アプリケーションの作成に使用するウィザードで Java クラスも作成できます。続いて IDE のツールで、このチュートリアルの初めに作成した Web サービスを使用します。

1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。「Java」カテゴリから「Java アプリケーション」を選択します。プロジェクトに CalculatorWS_Client_Application という名前を付けます。「主クラスを作成」を選択状態にし、その他のデフォルト設定はそのまま受け入れます。「完了」をクリックします。
2. NetBeans IDE 6.0.x を使用している場合、CalculatorWS_Client_Application プロジェクトのプロパティーを修正します。プロジェクトノードを右クリックし、「プロパティー」を選択します。「プロジェクトプロパティー」ダイアログが開きます。次の手順は使用している JDK によって異なります。
   • JDK 6 Update 4 より前の JDK の場合、「ライブラリ」カテゴリを選択して JAX-WS ライブラリおよび JAXB ライブラリをインポートします。
   • JDK 6 Update 4 以降の場合、「実行」カテゴリを選択して「VM オプション」を削除します。
3. 「CalculatorWS_Client_Application」ノードを右クリックし、「新規」>「Web サービスクライアント」を選択します。
4. 「プロジェクト」で「参照」をクリックします。使用する Web サービスを見つけます。Web サービスを選択したら、「了解」をクリックします。
5. ほかの設定はデフォルトのまま (6.0.x の場合、パッケージ名を設定しない) にし、「完了」をクリックします。

   次のように、「プロジェクト」ウィンドウに新しい Web サービスクライアントが表示され、作成した add メソッドのノードが追加されています。

   
   
6. Main.java をダブルクリックして、ソースエディタで開きます。TODO コメントを削除し、続いて add ノードを空の行の上にドラッグします。画面は次のようになります。

   public static void main(String[] args) {
   
       try { // Call Web Service Operation
           org.me.calculator.CalculatorWSService service = new org.me.calculator.client.CalculatorWSService();
           org.me.calculator.CalculatorWS port = service.getCalculatorWSPort();
           // TODO initialize WS operation arguments here
           int i = 0;
           int j = 0;
           // TODO process result here
           int result = port.add(i, j);
           System.out.println("Result = "+result);
       } catch (Exception ex) {
           // TODO handle custom exceptions here
       }
   
                   }

   注: 別の方法として、add ノードをドラッグする代わりに、エディタ上で右クリックして「Web サービスクライアントのリソース」>「Web サービスオペレーションを呼び出す」を選択します。

7. 3 や 4 など意味のある数字で 2 つの int を初期化します。前述の int の値を 0 から別の数字に変更するだけです。
8. プロジェクトのノードを右クリックし、「実行」を選択します。

   「出力」ウィンドウで次のような合計が表示されるはずです。

       compile:
       run:
       Result = 7
               BUILD SUCCESSFUL (total time: 1 second)

クライアント 2: Web アプリケーションのサーブレット

この節では、新しい Web アプリケーションを作成し、続いてサーブレットを作成します。次にこのサーブレットを使用して、チュートリアルの初めに作成した Web サービスを使用します。

1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。「Web」カテゴリから「Web アプリケーション」を選択します。プロジェクトに CalculatorWSServletClient という名前を付けます。「完了」をクリックします。
2. 「CalculatorWSServletClient」ノードを右クリックし、「新規」>「Web サービスクライアント」を選択します。

   「新規 Web サービスクライアント」ウィザードが表示されます。

3. 「プロジェクト」で「参照」をクリックします。使用する Web サービスを見つけます。Web サービスを選択したら、「了解」をクリックします。
4. ほかの設定はデフォルトのまま (6.0.x の場合、パッケージ名を設定しない) にし、「完了」をクリックします。

先ほどこのチュートリアルで作成した add オペレーションも含め、「プロジェクト」ウィンドウの「Web サービス参照」ノードに新しく作成したクライアントの構造が次のように表示されます。



5. 「CalculatorWSServletClient」プロジェクトノードを右クリックし、「新規」>「サーブレット」を選択します。サーブレットに ClientServlet と名前を付け、org.me.calculator.client というパッケージに保存します。「完了」をクリックします。
6. このサーブレットをアプリケーションの入場点として指定するには、プロジェクトのノードを右クリックして「プロパティー」を選択し、「実行」をクリックして「相対 URL」に「/ClientServlet」と入力します。「閉じる」をクリックします。
7. ソースエディタで、processRequest メソッドの本文をコメントアウトしている行を削除します。次の行です。

       /* TODO output your page here

   続いて、コメントアウトコードのセクションの終わりの行を削除します。

       */

   この行のあとに空の行をいくつか追加します。

       out.println("<h1>Servlet ClientServlet at " + request.getContextPath () + "</h1>");

   次に、add オペレーションを示すノードを、作成した空の行にドラッグします。

   processRequest メソッドは次のように表示されるはずです (追加されたコードはボールドで表示)。

       protected void processRequest(HttpServletRequest request, HttpServletResponse response)
       throws ServletException, IOException {
           response.setContentType("text/html;charset=UTF-8");
           PrintWriter out = response.getWriter();
           out.println("<html>");
           out.println("<head>");
           out.println("<title>Servlet ClientServlet</title>");
           out.println("</head>");
           out.println("<body>");
           out.println("<h1>Servlet ClientServlet at " + request.getContextPath () + "</h1>");
   
           try { // Call Web Service Operation
               org.me.calculator.CalculatorWS port = service.getCalculatorWSPort();
               // TODO initialize WS operation arguments here
               int i = 0;
               int j = 0;
               // TODO process result here
               int result = port.add(i, j);
               out.println("Result = "+result);
           } catch (Exception ex) {
               // TODO handle custom exceptions here
           }
   
           out.println("</body>");
           out.println("</html>");
           out.close();
                       }

   i および j の値を 3 や 4 など意味のある数字に変更します。

8. プロジェクトのノードを右クリックし、「実行」を選択します。

   サーバーが起動していない場合は起動し、アプリケーションが構築および配備され、ブラウザが開いて次のように計算結果を表示します。
   

クライアント 3: Web アプリケーションの JSP ページ

この節では、新しい Web アプリケーションを作成したあと、「Web アプリケーション」ウィザードで作成したデフォルトの JSP ページで Web サービスを使用します。

1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。「Web」カテゴリから「Web アプリケーション」を選択します。プロジェクトに CalculatorWSJSPClient という名前を付けます。「完了」をクリックします。
2. 「CalculatorWSJSPClient」ノードを右クリックし、「新規」>「Web サービスクライアント」を選択します。
3. 「プロジェクト」で「参照」をクリックします。使用する Web サービスを見つけます。Web サービスを選択したら、「了解」をクリックします。
4. ほかの設定はデフォルトのまま (6.0.x の場合、パッケージ名を設定しない) にし、「完了」をクリックします。

   次のように、「プロジェクト」ウィンドウに新しい Web サービスクライアントが表示されます。

   
   
5. 「Web サービス参照」ノードで、Web サービスを示すノードを展開します。ここで、クライアントから呼び出す add オペレーションが表示されます。
6. add オペレーションをクライアントの index.jsp ページにドラッグし、H1 タグの下にドロップします。次のように、サービスのオペレーションを呼び出すコードが index.jsp ページに生成されます。

   <%
   try {
       org.me.calculator.CalculatorWSService service =
           new org.me.calculator.CalculatorWSService();
       org.me.calculator.CalculatorWS port =
           service.getCalculatorWSPort();
        // TODO initialize WS operation arguments here
       int i = 0;
       int j = 0;
       // TODO process result here
       int result = port.add(i, j);
       out.println("Result = "+result);
   } catch (Exception ex) {
       // TODO handle custom exceptions here
   }
   %>

   i および j の値を 0 から 3 や 4 など意味のある数字に変更します。

7. プロジェクトのノードを右クリックし、「実行」を選択します。

   サーバーが起動していない場合は起動し、アプリケーションが構築および配備され、ブラウザが開いて次のように計算結果を表示します。