コンテナの選択

Web サービスは Web コンテナまたは EJB コンテナに配備できます。これは、選択する実装によって変わります。Java EE 6 アプリケーションを作成している場合、EJB を直接 Web アプリケーションに配置できるため、どのような場合でも Web コンテナを使用します。たとえば Tomcat Web サーバーに配備する予定の場合、Tomcat Web サーバーには Web コンテナしかないため、EJB モジュールではなく Web アプリケーションを作成します。

1. 「ファイル」>「新規プロジェクト」(Linux および Windows では Ctrl-Shift-N、MacOS では ⌘-Shift-N) を選択します。「Java Web」カテゴリから「Web アプリケーション」を選択するか、「Java EE」カテゴリから「EJB モジュール」を選択します。

   JAX-WS Web サービスを Maven プロジェクト内で作成できます。「ファイル」>「新規プロジェクト」(Linux および Windows の場合は Ctrl-Shift-N、MacOS の場合は ⌘-Shift-N) を選択し、「Maven」カテゴリから「Maven Web アプリケーション」または「Maven EJB モジュール」を選択します。NetBeans で Maven をまだ使用したことがない場合は、Maven のベストプラクティスを参照してください。

2. プロジェクトに CalculatorWSApplication という名前を付けます。プロジェクトの場所を選択します。「次へ」をクリックします。
3. サーバーと Java EE バージョンを選択し、「完了」をクリックします。

   Oracle WebLogic サーバーを使用するには、サーバーを IDE に登録します。また、WebLogic サーバーを使用する場合は、「Oracle WebLogic への Web アプリケーションの配備」のスクリーンキャストを視聴してください。

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

1. 「CalculatorWSApplication」ノードを右クリックし、「新規」>「Web サービス」を選択します。
2. Web サービスに CalculatorWS という名前を付け、「パッケージ」に「org.me.calculator」と入力します。「Web サービスを新規に作成」を選択したままにします。
3. Java EE 6 プロジェクトを作成する場合は、「ステートレスセッション Bean として Web サービスを実装」を選択します。
   
4. 「完了」をクリックします。「プロジェクト」ウィンドウに新しい Web サービスの構造が表示され、エディタ領域にソースコードが表示されます。
   

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

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

1. 「ファイル」>「新規プロジェクト」(Linux および Windows では Ctrl-Shift-N、MacOS では ⌘-Shift-N) を選択します。「Java」カテゴリから「Java アプリケーション」を選択します。プロジェクトに CalculatorWS_Client_Application という名前を付けます。「主クラスを作成」を選択状態にし、その他のデフォルト設定はそのまま受け入れます。「完了」をクリックします。
2. 「CalculatorWS_Client_Application」ノードを右クリックし、「新規」>「Web サービスクライアント」を選択します。「新規 Web サービスクライアント」ウィザードが開きます。
3. プロジェクトを WSDL ソースとして選択します。「参照」をクリックします。CalculatorWSApplication プロジェクトの CalculatorWS Web サービスを参照します。Web サービスを選択したら、「了解」をクリックします。
   
4. パッケージ名を選択しないでください。このフィールドは空のままにします。
   
5. その他の設定はデフォルトのままにし、「完了」をクリックします。

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

   
   
6. メインクラスをダブルクリックしてソースエディタで開きます。main() メソッドの下に add ノードをドラッグします。
   

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

   public static void main(String[] args) {
       // TODO アプリケーションロジックをここにコーディング
   }
   private static int add(int i, int j) {
       org.me.calculator.CalculatorWS_Service service = new org.me.calculator.CalculatorWS_Service();
       org.me.calculator.CalculatorWS port = service.getCalculatorWSPort();
       return port.add(i, j);
   }

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

7. main() メソッド本文で、TODO コメントを、i および j の値を初期化し、add() を呼び出し、結果を出力するコードに置き換えます。

   public static void main(String[] args) {
       int i = 3;
       int j = 4;
       int result = add(i, j);
       System.out.println("Result = " + result);
   }

8. main() メソッドのコードを、例外を出力する try/catch ブロックで囲みます。

   public static void main(String[] args) {
       try {
           int i = 3;
           int j = 4;
           int result = add(i, j);
           System.out.println("Result = " + result);
       } catch (Exception ex) {
           System.out.println("Exception: " + ex);
       }
   }

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

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

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

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

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

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

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

3. プロジェクトを WSDL ソースとして選択します。「参照」をクリックします。CalculatorWSApplication プロジェクトの CalculatorWS Web サービスを参照します。Web サービスを選択したら、「了解」をクリックします。
   
4. パッケージ名を選択しないでください。このフィールドは空のままにします。
5. その他の設定はデフォルトのままにし、「完了」をクリックします。

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

   
   
6. 「CalculatorWSServletClient」プロジェクトノードを右クリックし、「新規」>「サーブレット」を選択します。サーブレットに ClientServlet と名前を付け、org.me.calculator.client というパッケージに保存します。「完了」をクリックします。
7. サーブレットをアプリケーションのエントリポイントにするには、「CalculatorWSServletClient」プロジェクトノードを右クリックし、「プロパティー」を選択します。「実行」プロパティーを開き、「相対 URL」フィールドに「/ClientServlet」と入力します。「了解」をクリックします。
8. ClientServlet.java のエラーアイコンがある場合、プロジェクトノードを右クリックし、「生成物を削除して構築」を選択します。
9. ソースエディタで、add 操作を ClientServlet クラスの本文の任意の場所にドラッグします。add() メソッドがクラスコードの末尾に表示されます。

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

   private int add(int i, int j) {
       org.me.calculator.CalculatorWS port = service.getCalculatorWSPort();
       return port.add(i, j);
   }

10. processRequest() メソッドで、この行のあとに空白行をいくつか追加します。

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

11. i および j の値を初期化し、add() を呼び出し、結果を出力するコードを追加します。追加されたコードはボールドで示されています。

    protected void processRequest(HttpServletRequest request, HttpServletResponse response)
             throws ServletException, IOException {
        response.setContentType("text/html;charset=UTF-8");
        PrintWriter out = response.getWriter();
        try {
            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>");
    
            int i = 3;
            int j = 4;
            int result = add(i, j);
            out.println("Result = " + result);
    
            out.println("</body>");
            out.println("</html>");
            
        } finally {            
            out.close();
        }
    }

12. 追加されたコードを、例外を出力する try/catch ブロックで囲みます。

    protected void processRequest(HttpServletRequest request, HttpServletResponse response)
             throws ServletException, IOException {
        response.setContentType("text/html;charset=UTF-8");
        PrintWriter out = response.getWriter();
        try {
            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 {
                int i = 3;
                int j = 4;
                int result = add(i, j);
                out.println("Result = " + result);
            } catch (Exception ex) {
                out.println("Exception: " + ex);
            }
            out.println("</body>");
            out.println("</html>");
            
        } finally {            
            out.close();
        }
    }

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

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

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

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

注: JSP Web アプリケーションクライアントを Oracle WebLogic 上で実行する場合は、「WebLogic での Java Server Faces 2.0 アプリケーションの実行」を参照してください。

1. 「ファイル」>「新規プロジェクト」(Linux および Windows では Ctrl-Shift-N、MacOS では ⌘-Shift-N) を選択します。「Java Web」カテゴリから「Web アプリケーション」を選択します。プロジェクトに CalculatorWSJSPClient という名前を付けます。「完了」をクリックします。
2. 「CalculatorWSJSPClient」ノードを右クリックし、「新規」>「Web サービスクライアント」を選択します。
3. プロジェクトを WSDL ソースとして選択します。「参照」をクリックします。CalculatorWSApplication プロジェクトの CalculatorWS Web サービスを参照します。Web サービスを選択したら、「了解」をクリックします。
   
4. パッケージ名を選択しないでください。このフィールドは空のままにします。
5. その他の設定はデフォルトのままにし、「完了」をクリックします。

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

   
   
6. 「Web サービス参照」ノードで、Web サービスを示すノードを展開します。ここで、クライアントから呼び出す add オペレーションが表示されます。
7. 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 などの整数に変更します。catch ブロック内のコメントアウトされた TODO 行を out.println("exception" + ex); に置き換えます。

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

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