corner imagecorner image
IDEPlatformPluginsDocs & SupportCommunityPartners

エンドツーエンドのバイナリ SOAP アタッチメント 2: Web サービスの作成

このレッスンの目標は、Web サービスを含む Web アプリケーションを作成することです。この Web サービスは、ステートレスセッション Bean として実装します。

Web サービスの完全版サンプルは、「NetBeans サンプルカタログ」からダウンロードできます。

このチュートリアルのレッスン

このページの内容は NetBeans IDE 6.9-7.1 が対象です
  1. 概要
  2. => Web サービスの作成
  3. Web サービスのコーディングおよびテスト
  4. バイナリデータを渡すためのスキーマと WSDL ファイルの変更
  5. Swing クライアントの作成

このレッスンの目次

  1. Web アプリケーションの作成
  2. Web サービスの追加

Web アプリケーションの作成

この節では、EE6 Web アプリケーションを作成します。このアプリケーションに、Web サービスがバイナリデータとして渡す画像を追加します。

Web アプリケーションを作成するには、次の手順に従います。

  1. 「ファイル」>「新規プロジェクト」(Linux および Windows では Ctrl-Shift-N、MacOS では ⌘-Shift-N) を選択します。「新規プロジェクト」ウィザードが表示されます。「Java Web」カテゴリから「Web アプリケーション」を選択し、「次へ」をクリックします。「名前と場所」ページが開きます。
  2. 「プロジェクト名」フィールドに「FlowerAlbumService」と入力します。このプロジェクトの場所を選択します。その他のオプションについては、デフォルトの設定を使用し、「次へ」をクリックします。「サーバーと設定」ページが開きます。
  3. GlassFish Server 3.1 と Java EE バージョン EE6 Web を選択します。

    重要: GlassFish Server Open Source Edition はバージョン 3.1 b27 以降である必要があります。「スキーマ および WSDL ファイルの変更」で作成するカスタムスキーマファイルは、GlassFish サーバーの 3.0.1 では使用できません。「サービス」ウィンドウで GlassFish サーバーのバージョンを確認してください。

  4. 「完了」をクリックします。FlowerAlbumService プロジェクトが作成され、「プロジェクト」ウィンドウに表示されます。
  5. 「ソースパッケージ」ノードを右クリックし、「新規」>「Java パッケージ」を選択します。「新規 Java パッケージ」ウィザードが開きます。
  6. パッケージ名を org.flower.resources にします。「完了」をクリックします。
    org.flower.resources パッケージの名前と場所が表示された「新規 Java パッケージ」ウィザード
  7. 次の画像を org.flower.resources にコピーします。

プロジェクトの「ソースパッケージ」に、org.flower.resources パッケージが追加されています。他の内容は追加されていません。

花の画像のみのプロジェクト

Web サービスの追加

この節では、Web アプリケーション内に Web サービスを作成します。このサービスは、ステートレスセッション Bean として作成します。次の Web オペレーションをサービスに追加します。

  • 花の名前を取得し、その名前に関連付けられた Image を取得するオペレーション。
  • すべての花の画像のサムネイルを取得し、それらのサムネイルを List として返すオペレーション。

Web サービスを追加するには、次の手順に従います。

  1. 「プロジェクト」ウィンドウで、「FlowerAlbumService」プロジェクトノードを右クリックし、「新規」>「Web サービス」を選択します。または、「新規」>「その他」を選択し、「新規ファイル」ウィザードの「Web サービス」の下にある「Web サービス」を選択します。「新規 Web サービス」ウィザードが開きます。
  2. 「新規 Web サービス」ウィザードで、「Web サービス名」に「FlowerService」、「パッケージ名」に「org.flower.service」と入力します。「Web サービスを新規に作成」を選択します。「ステートレスセッション Bean として Web サービスを実装」を選択します。「完了」をクリックします。
    完了した「新規 Web サービス」ウィザード

    Web サービスが、「プロジェクト」ウィンドウのこのプロジェクトのノードに表示されます。「ソースパッケージ」ディレクトリには、「service」パッケージと「resources」パッケージが含まれています。

    花の画像と Web サービスが表示された「プロジェクト」ウィンドウ
  3. エディタで FlowerService.java を開きます。「デザイン」ビューに切り替えます。オペレーションおよびサービス品質の要素を Web サービスに追加できるフォームが表示されます。
    何も追加されていない FlowerService の「デザイン」ビュー
  4. 「オペレーションを追加」をクリックします。「オペレーションを追加」ウィザードが開きます。
  5. このオペレーションに getFlower という名前を付けます。「戻り値の型」フィールドに、「java.awt.Image」と直接入力するか、参照して入力します。
  6. 「パラメータ」タブで、「追加」をクリックします。このパラメータに name という名前を付け、デフォルトの java.lang.String 型を受け入れます。
    getFlower オペレーションの名前と戻り値の型、および name パラメータが表示された「オペレーションを追加」ダイアログ
  7. 「例外」タブを開きます。「IOException」を追加します。
    「IOException」を参照した状態
  8. 「了解」をクリックしてウィザードを閉じます。次に、「オペレーションを追加」をもう一度クリックして、次のプロパティーを持つオペレーションを追加します。
    • 名前: getThumbnails
    • 戻り値の型: java.util.List
    • 例外: IOException

「デザイン」ビューに、getFlower オペレーションと getThumbnails オペレーションが表示されます。両方のオペレーションで一覧表示に切り替えると、オペレーションのパラメータをすべて確認できます。

オペレーションが表示された Flower サービスの「デザイン」ビュー

 

次の手順:

Web サービスのコーディングおよびテスト


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