コンテナの選択

WebサービスはWebコンテナまたはEJBコンテナにデプロイできます。これは、選択する実装によって変わります。Java EEアプリケーションを作成している場合、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. GlassFishまたはWebLogicでJava EEプロジェクトを作成する場合は、「ステートレス・セッション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サービスを選択した後、「OK」をクリックします。
   
4. パッケージ名を選択しないでください。このフィールドは空のままにします。
   
5. その他の設定はデフォルトのままにし、「終了」をクリックします。

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

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

   次のようになります。

   public static void main(String[] args) {
       // TODO code application logic here
   }
   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ソースとしてプロジェクトを選択し、「参照」をクリックして「Webサービスを参照」ダイアログ・ボックスを開きます。
4. CalculatorWSApplicationプロジェクトでCalculatorWS Webサービスを選択します。「OK」をクリックして、「Webサービスを参照」ダイアログ・ボックスを閉じます。
   
5. 新規Webサービス・クライアント・ウィザードでパッケージ名が空白であることを確認し、他の設定はデフォルト値のままにします。「終了」をクリックします。

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

6. 「CalculatorWSServletClient」プロジェクト・ノードを右クリックし、「新規」>「サーブレット」を選択します。サーブレットにClientServletと名前を付け、org.me.calculator.clientというパッケージに保存します。「終了」をクリックします。
7. サーブレットをアプリケーションのエントリ・ポイントにするには、「CalculatorWSServletClient」プロジェクト・ノードを右クリックし、「プロパティ」を選択します。「実行」プロパティを開き、「相対URL」フィールドに「/ClientServlet」と入力します。「OK」をクリックします。
8. ClientServlet.javaのエラー・アイコンがある場合、プロジェクト・ノードを右クリックし、「消去してビルド」を選択します。
9. processRequest()メソッドで、この行の後に空白行をいくつか追加します。

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

10. ソース・エディタで、add操作をClientServletクラスの本文の任意の場所にドラッグします。add()メソッドがクラス・コードの末尾に表示されます。

    注意: 別の方法として、addノードをドラッグするかわりに、エディタ上で右クリックして「コードを挿入」>「Webサービス操作をコール」を選択することもできます。

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

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. プロジェクト・ノードの下でWeb Pagesノードを展開して、index.htmlを削除します。
3. Web Pagesノードを右クリックして、ポップアップ・メニューで「新規」>「JSP」を選択します。

   ポップアップ・メニューに「JSP」がない場合は、「新規」>「その他」を選択し、新規ファイル・ウィザードの「Web」カテゴリで「JSP」を選択します。

4. 新規ファイル・ウィザードでJSPファイルの名前にindexと入力します。「終了」をクリックします。
5. 「CalculatorWSJSPClient」ノードを右クリックし、「新規」>「Webサービス・クライアント」を選択します。
6. プロジェクトをWSDLソースとして選択します。「参照」をクリックします。CalculatorWSApplicationプロジェクトのCalculatorWS Webサービスを参照します。Webサービスを選択した後、「OK」をクリックします。
   
7. パッケージ名を選択しないでください。このフィールドは空のままにします。
8. その他の設定はデフォルトのままにし、「終了」をクリックします。

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

   
9. 「Webサービス参照」ノードで、Webサービスを示すノードを展開します。ここで、クライアントから呼び出すadd操作が表示されます。
10. 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);に置き換えます。

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

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