コンテナの選択

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

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

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

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

   Oracle WebLogic Server を使用するには、IDE にサーバーを登録します。また、WebLogic Server を使用している場合は、「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. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。「Java」カテゴリから「Java アプリケーション」を選択します。プロジェクトに CalculatorWS_Client_Application という名前を付けます。「主クラスを作成」を選択状態にし、その他のデフォルト設定はそのまま受け入れます。「完了」をクリックします。
2. 「CalculatorWS_Client_Application」ノードを右クリックし、「新規」>「Web サービスクライアント」を選択します。「新規 Web サービスクライアント」ウィザードが開きます。
3. WSDL ソースとして「プロジェクト」を選択します。「参照」をクリックします。「CalculatorWSApplication」プロジェクトの「CalculatorWS」Web サービスを探します。Web サービスを選択したら、「了解」をクリックします。
   
4. NetBeans IDE 7.0-7.1 では、クライアント Java アーティファクトのパッケージを選択できます。このフィールドは空のままにします。
   
5. その他の設定はデフォルトのままにし、「完了」をクリックします。

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

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

   コードは次のようになります。

   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. 例外を出力する try/catch ブロックで main() メソッドのコードを囲みます。

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

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

3. WSDL ソースとして「プロジェクト」を選択します。「参照」をクリックします。「CalculatorWSApplication」プロジェクトの「CalculatorWS」Web サービスを探します。Web サービスを選択したら、「了解」をクリックします。
   
4. NetBeans IDE 7.0-7.1 では、クライアント Java アーティファクトのパッケージを選択できます。このフィールドは空のままにします。
5. その他の設定はデフォルトのままにし、「完了」をクリックします。

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

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

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

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

10. processRequest メソッドの本体をコメントアウトしている行を削除します。次の行です。

        /* TODO output your page here

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

        */

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

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

    ここで、i および j の値を初期化し、add() を呼び出し、結果を出力するコードを追加します。

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

    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();
        }
    }

11. 追加したコードを、例外を出力する 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();
        }
    }

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

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

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

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

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

1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。「Java Web」カテゴリから「Web アプリケーション」を選択します。プロジェクトに CalculatorWSJSPClient という名前を付けます。「完了」をクリックします。
2. 「CalculatorWSJSPClient」ノードを右クリックし、「新規」>「Web サービスクライアント」を選択します。
3. WSDL ソースとして「プロジェクト」を選択します。「参照」をクリックします。「CalculatorWSApplication」プロジェクトの「CalculatorWS」Web サービスを探します。Web サービスを選択したら、「了解」をクリックします。
   
4. NetBeans IDE 7.0-7.1 では、クライアント Java アーティファクトのパッケージを選択できます。このフィールドは空のままにします。
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. プロジェクトのノードを右クリックし、「実行」を選択します。

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