WebOTXマニュアル

Size: px

Start display at page:

Download "WebOTXマニュアル"

さみらおいもり
5 years ago
Views:

2 目次 4. プログラミング開発 (WebOTX) EJBアプリケーション EJB プロジェクトの作成 EJB の新規作成画面セッションBeanの作成エンティティBeanの作成メッセージ駆動型 Beanの作成 EJBテストクライアントの作成 EJBテストクライアントの作成...13 付録 4-2-2

4. プログラミング開発 (WebOTX) 4.2.EJB アプリケーション本節では EJB アプリケーションについて記述しています EJB プロジェクトの作成 EJB の新規作成画面セッションBeanの作成エンティティBeanの作成メッセージ駆動型 Beanの作成 EJB テストクライアントの作成 EJBメソッドの作成 4.2.1.

3 4. プログラミング開発 (WebOTX) 4.2.EJB アプリケーション本節では EJB アプリケーションについて記述しています EJB プロジェクトの作成 EJB の新規作成画面セッションBeanの作成エンティティBeanの作成メッセージ駆動型 Beanの作成 EJB テストクライアントの作成 EJBメソッドの作成 EJB プロジェクトの作成 EJB プロジェクトの作成について説明します以下の説明事項があります EJB プロジェクト画面 EJB プロジェクト画面その概要を説明します Java 設定画面 Java 設定画面その概要を説明します EJB プロジェクト画面下図のような EJB プロジェクト画面が表示されます付録 4-2-3

プロジェクト名アプリケーションクライアントプロジェクトの名前を新規作成します空白目次プロジェクトの生成箇所を指定しますワークスペース内に新規プロジェクトを作成 (W) をチェックしています JDK 準拠モジュールが引用する JDK ですデフォルトのコンパイラー準拠を使用 ( 現在は 1.

4 プロジェクト名アプリケーションクライアントプロジェクトの名前を新規作成します空白目次プロジェクトの生成箇所を指定しますワークスペース内に新規プロジェクトを作成 (W) をチェックしています JDK 準拠モジュールが引用する JDK ですデフォルトのコンパイラー準拠を使用 ( 現在は 1.4) (A) をチェックしていますプロジェクトレモジュールの出力フォルダを設定しまプロジェクトフォルダーをイアウトすソースおよびクラスファイルのルートとして使用 (U) をチェックしています必要な情報を入力後に終了 (F) を押すと EJB プロジェクトウィザードはその情報に基づきファイルの雛形を作成し Eclipse のプロジェクトに登録します Java 設定画面下図のような EJB プロジェクト画面が表示されます付録 4-2-4

プロジェクト名 (P) ディレクトリー (Y) 新しい EJB プロジェクトの名前を入力します EJB プロジェクトを格納する local フォルダを設定します空白デフォルトの使用を選択した場合ディレクトリーテキストが利用不可ですデフォルトの使用を選択しない場合空白を表示します必要な情報を入力後に終了 (F) を押すと EJB プロジェクトウィザードはその情報に基づき

5 プロジェクト名 (P) ディレクトリー (Y) 新しい EJB プロジェクトの名前を入力します EJB プロジェクトを格納する local フォルダを設定します空白デフォルトの使用を選択した場合ディレクトリーテキストが利用不可ですデフォルトの使用を選択しない場合空白を表示します必要な情報を入力後に終了 (F) を押すと EJB プロジェクトウィザードはその情報に基づきファイルの雛形を作成し Eclipse のプロジェクトに登録します EJB の新規作成画面 EJB の新規作成画面について説明します以下の説明事項があります EJB の新規作成画面 EJB の新規作成画面その概要を説明します EJB の新規作成画面下図のような EJB の新規作成画面が表示されますソースフォルダー (D) 新規クラスのソースフォルダーを入力します有効なソースフォルダーパスを入力しますかまたはブラウズ (O) をウィザードが開始されたときに選択されたエレメントのソースフォルダー付録 4-2-5

パッケージ (K) 名前 (M) EJB タイプの選択クリックしてダイアログからソースフォルダーを選択してください新規クラスを入れるパッケージを入力します有効なパッケージ名を入力しますかまたはブラウズ (W) をクリックしてダイアログからパッケージを選択します新しいセッションBeanの名前を入力します新しい EJB のタイプを選択します

6 パッケージ (K) 名前 (M) EJB タイプの選択クリックしてダイアログからソースフォルダーを選択してください新規クラスを入れるパッケージを入力します有効なパッケージ名を入力しますかまたはブラウズ (W) をクリックしてダイアログからパッケージを選択します新しいセッションBeanの名前を入力します新しい EJB のタイプを選択しますウィザードが開始されたときに選択されたエレメントのパッケージ空白 Session Bean 必要な情報を入力後に次へ (N) を押すと Session Bean の生成画面を表示しますセッション Bean の作成セッション Bean の作成について説明します以下の説明事項があります Session Bean の生成画面 Session Bean の生成画面その概要を説明します Session Bean の生成画面下図のような Session Bean の生成画面が表示されます Session Bean タイプの選択新しい Session Bean のタイプを選択します Stateless Session Bean 付録 4-2-6

7 インタフェースタイプの選択新規セッション Bean が関連するインタフェースですデフォルトでチェックしません Synchronize Timer service 新しいステートフルセッションBeanの Synchronizeを選択します新しいステートレスセッションBeanの Timer serviceを選択します Synchronize CheckBox が利用不可な状態です Timer service CheckBox が利用可能な状態です必要な情報を入力後に終了 (F) を押すとセッション Bean はその情報に基づきファイルの雛形を作成します Remote 及び Remote Home インタフェースを選択した場合 Remote インタフェース及び Remote Home インタフェースのソースファイルを作成します Local 及び Local Home インタフェースを選択した場合 Local インタフェース及び Local Home インタフェースのソースファイルを作成します該当する Bean クラスを作成しますエンティティ Bean の作成エンティティ Bean の作成について説明します以下の説明事項があります Entity Bean の生成画面 Entity Bean の生成画面その概要を説明します Cmp Entity Bean の永続性画面 Cmp Entity Bean の永続性画面その概要を説明します永続性フィールドの指定画面永続性フィールドの指定画面その概要を説明します Entity Bean の生成画面下図のような Entity Bean の生成画面が表示されます付録 4-2-7

永続性タイプの選択インタフェースタイプの選択新しい Entity Bean のタイプを選択します新規エンティティ Bean が関連するインタフェースです Container-ManagedPersiste nce(cmp) をチェックしていますデフォルトでチェックしません Timer service

8 永続性タイプの選択インタフェースタイプの選択新しい Entity Bean のタイプを選択します新規エンティティ Bean が関連するインタフェースです Container-ManagedPersiste nce(cmp) をチェックしていますデフォルトでチェックしません Timer service 新しいエンティティ Bean の Timer service を選択しますデフォルトでチェックしません必要な情報を入力後に次へ (N) を押すと Session Bean の生成画面を表示します Cmp Entity Bean の永続性画面下図のような Cmp Entity Bean の永続性画面が表示されます付録 4-2-8

名前タイプ追加した永続性フィールドの名前を表示します永続性フィールドのタイプを表示します空白空白主キー新しい永続性フィールドの主キーを選択しますデフォルトでチェックしません必要な情報を入力後に終了 (F) を押すとエンティティ Bean はその情報に基づきファイルの雛形を作成します Remote 及び Remote Home インタフェースを選択した場合

9 名前タイプ追加した永続性フィールドの名前を表示します永続性フィールドのタイプを表示します空白空白主キー新しい永続性フィールドの主キーを選択しますデフォルトでチェックしません必要な情報を入力後に終了 (F) を押すとエンティティ Bean はその情報に基づきファイルの雛形を作成します Remote 及び Remote Home インタフェースを選択した場合 Remote インタフェース及び Remote Home インタフェースのソースファイルを作成します Local 及び Local Home インタフェースを選択した場合 Local インタフェース及び Local Home インタフェースのソースファイルを作成します該当する Bean クラスを作成します追加を押すと永続性フィールドの指定画面を表示します永続性フィールドの指定画面下図のような永続性フィールドの指定画面が表示されます付録 4-2-9

フィールド名フィールドタイプ追加した永続性フィールドの名前を表示します永続性フィールドのタイプを表示します空白空白主キーの設定新しい永続性フィールドの主キーとして設定を選択しますデフォルトでチェックしません必要な情報を入力後に OK を押すと永続性フィールドの指定画面が消えて Cmp Entity Bean の永続性画面のリストにはレコードを一件追加します 4.2.

10 フィールド名フィールドタイプ追加した永続性フィールドの名前を表示します永続性フィールドのタイプを表示します空白空白主キーの設定新しい永続性フィールドの主キーとして設定を選択しますデフォルトでチェックしません必要な情報を入力後に OK を押すと永続性フィールドの指定画面が消えて Cmp Entity Bean の永続性画面のリストにはレコードを一件追加しますメッセージ駆動型 Bean の作成メッセージ駆動型 Bean の作成について説明します以下の説明事項があります Message-Driven Bean の生成画面 Message-Driven Bean の生成画面その概要を説明します Message-Driven Bean の生成画面下図のような Message-Driven Bean の生成画面が表示されます付録

Messaging タイプの選択 Timer Service Messaging タイプを選択します新しい Message-Driven Bean の Timer service を選択します JMS デフォルトでチェックしません Message リスナーインタフェース名新しい Message-Driven Bean の Message リスナーインタフェース名を表示します

11 Messaging タイプの選択 Timer Service Messaging タイプを選択します新しい Message-Driven Bean の Timer service を選択します JMS デフォルトでチェックしません Message リスナーインタフェース名新しい Message-Driven Bean の Message リスナーインタフェース名を表示しますデフォルトで Message リスナーインタフェース名 Text が利用不可な状態です必要な情報を入力後に終了 (F) を押すと Message-Driven Bean はその情報に基づきファイルの雛形を作成します該当する Bean クラスを作成します EJB テストクライアントの作成 EJB テストクライアントの作成について説明します以下の説明事項があります EJB テストクライアントの生成画面 EJB テストクライアントの生成画面その概要を説明します EJB テストクライアントの作成画面下図のような EJB テストクライアント設定ページが表示されます付録

ソースフォルダー (D) パッケージ (K) 名前 (M) スーパークラス (S) EJB Home EJB Interface 新規クラスのソースフォルダーを入力します有効なソースフォルダーパスを入力しますかまたはブラウズ (O) をクリックしてダイアログからソースフォルダーを選択してください新規クラスを入れるパッケージを入力します有効なパッケージ名を入力しますかまたは

12 ソースフォルダー (D) パッケージ (K) 名前 (M) スーパークラス (S) EJB Home EJB Interface 新規クラスのソースフォルダーを入力します有効なソースフォルダーパスを入力しますかまたはブラウズ (O) をクリックしてダイアログからソースフォルダーを選択してください新規クラスを入れるパッケージを入力します有効なパッケージ名を入力しますかまたはブラウズ (W) をクリックしてダイアログからパッケージを選択します新しいEJBテストクライアントクラスの名前を入力します EJB テストクライアントクラスのスーパークラスですテストされる EJB の Remote Home インタフェーステストされる EJB の Remote インタフェースウィザードが開始されたときに選択されたエレメントのソースフォルダーウィザードが開始されたときに選択されたエレメントのパッケージ空白 java.lang.object ejb-jar.xml から取得した EJB Remote Home インタフェース ejb-jar.xml から取得した EJB Remote インタフェース必要な情報を入力後に終了 (F) を押すと EJB テストクライアントウィザードはその情報に基づきファイルの雛形を作成し Eclipse のプロジェクトに登録します付録

13 4.2.7.EJB テストクライアントの作成 EJB メソッドの作成について説明します以下の説明事項がありますメニューの起動について EJB メソッドの起動について説明します EJB メソッドの生成 EJB メソッドの生成手順についてその概要を説明しますメッセージ表示 EJB メソッドの作成における注意点を表示するメッセージに関してその概要を説明しますメニューの起動について EJB プロジェクトを選択し右クリックし EJB モジュールエディタメニューのメソッドメニューを選択しメソッドダイアログを起動します下図のようなダイアログが表示されますコンポーネント説明デフォルト EJBモジュールメソッド種別メソッドリストデフォルトで選択されたEJBプロジェクト配下にejb-jar.xml 中のEJBの名前リストです詳細はEJBモジュールとメソッド種別の対応一覧表をご参照くださいリストで全ての条件に該当するメソッドを表示しますデフォルトで選択されたEJB プロジェクト配下に ejb-jar.xml 中の一番目の Session Beanの名前を表示します Session Beanがない場合一番目のEntity Bean の名前を表示しますそうでない場合一番目の Message-driven Bean の名前を表示します Business Method 一番目のEJBのBusiness メソッド付録

選択された EJB のタイプによってメソッド種別リストの内容は以下の通りです EJB モジュールとメソッド種別の対応一覧表 EJB Type Method Category list Session Bean Create Method Business Method Create Method Business Method Entity Bean(CMP) Find Method

14 選択された EJB のタイプによってメソッド種別リストの内容は以下の通りです EJB モジュールとメソッド種別の対応一覧表 EJB Type Method Category list Session Bean Create Method Business Method Create Method Business Method Entity Bean(CMP) Find Method Select Method Home Method Create Method Entity Bean(BMP) Business Method Find Method Home Method メソッド追加 / 削除の完了ボタンをクリックした後該当する Bean クラスインターフェースと ejb-jar.xml ファイルには該当する内容が追加されます EJB メソッドの生成 Business メソッドを追加するダイアログ追加する Business メソッドの関連情報を設定しますメソッド名称追加するメソッドの名前を入力します空白付録

返却タイプパラメータユーザ定義異常メソッド異常関連するインタフェースメソッドの返却タイプを表示します追加するメソッドの引数を入力しますユーザが定義した追加するメソッドの例外型を入力します追加するメソッドの例外型を入力しますメソッドダイアログの EJB モジュールで表示される EJB が関連するインタフェースです java.lang.string 空白空白 java.rmi.

15 返却タイプパラメータユーザ定義異常メソッド異常関連するインタフェースメソッドの返却タイプを表示します追加するメソッドの引数を入力しますユーザが定義した追加するメソッドの例外型を入力します追加するメソッドの例外型を入力しますメソッドダイアログの EJB モジュールで表示される EJB が関連するインタフェースです java.lang.string 空白空白 java.rmi.remoteexcept ion デフォルト状態では関連するインタフェースは選択された状態です必要な情報を入力後に OK を押すと Business メソッドを追加するダイアログ画面が消えてメソッドダイアログ画面のメソッドリストに該当するメソッドを追加します関連する Local インタフェースを選択した場合 Local インタフェースのソースファイルにメソッドが追加されます関連する Remote インタフェースを選択した場合 Remote インタフェースのソースファイルにメソッドが追加されます該当する Bean クラスには該当する内容が追加されます Create メソッドを追加するダイアログ追加する Create メソッドの関連情報を設定します付録

メソッド名称パラメータユーザ定義異常メソッド異常関連するインタフェース追加するメソッドの名前を入力します追加するメソッドの引数を入力しますユーザが定義した追加するメソッドの例外型を入力します追加するメソッドの例外型を入力しますメソッドダイアログの EJB モジュールで表示される EJB が関連するインタフェースです ejbcreate 空白空白 java.ejb.createexcep tion, java.

16 メソッド名称パラメータユーザ定義異常メソッド異常関連するインタフェース追加するメソッドの名前を入力します追加するメソッドの引数を入力しますユーザが定義した追加するメソッドの例外型を入力します追加するメソッドの例外型を入力しますメソッドダイアログの EJB モジュールで表示される EJB が関連するインタフェースです ejbcreate 空白空白 java.ejb.createexcep tion, java.rmi.remoteexce ption デフォルト状態では関連するインタフェースは選択された状態です必要な情報を入力後に OK を押すと Create メソッドを追加するダイアログ画面が消えてメソッドダイアログ画面のメソッドリストに該当するメソッドを追加します関連する Local Home インタフェースを選択した場合 Local Home インタフェースのソースファイルにメソッドが追加されます関連する Home インタフェースを選択した場合 Home インタフェースのソースファイルにメソッドが追加されます該当する Bean クラスには該当する内容が追加されます Find メソッドを追加するダイアログ (CMP) 追加する Find メソッドの関連情報を設定します付録

17 Home 名称返却タイプパラメータユーザ定義異常メソッド異常追加するメソッドの名前を入力しますメソッドの返却タイプを表示します追加するメソッドの引数を入力しますユーザが定義した追加するメソッドの例外型を入力します追加するメソッドの例外型を入力します find java.util.collection 空白空白 Java.ejb.FinderException, java.rmi.remoteexception 関連するインタフェースメソッドダイアログの EJB モジュールで表示される EJB が関連するインタフェースですデフォルト状態では関連するインタフェースは選択された状態です EJB QL テキスト入力した内容は ejb-jar.xml ファイル中の ejb-ql タグ内容と対応する空白必要な情報を入力後に OK を押すと Find メソッドを追加するダイアログ画面が消えてメソッドダイアログ画面のメソッドリストに該当するメソッドを追加します関連する Local Home インタフェースを選択した場合 Local Home インタフェースのソースファイルにメソッドが追加されます関連する Home インタフェースを選択した場合 Home インタフェースのソースファイルにメソッドが追加されます該当する Bean クラスと ejb-jar.xml ファイルには該当する内容が追加されます Find メソッドを追加するダイアログ (BMP) 追加する Find メソッドの関連情報を設定します付録

メソッド名称返却タイプパラメータユーザ定義異常メソッド異常追加するメソッドの名前を入力しますメソッドの返却タイプを表示します追加するメソッドの引数を入力しますユーザが定義した追加するメソッドの例外型を入力します追加するメソッドの例外型を入力します ejbfind java.util.collection 空白空白 Java.ejb.FinderException, java.rmi.

18 メソッド名称返却タイプパラメータユーザ定義異常メソッド異常追加するメソッドの名前を入力しますメソッドの返却タイプを表示します追加するメソッドの引数を入力しますユーザが定義した追加するメソッドの例外型を入力します追加するメソッドの例外型を入力します ejbfind java.util.collection 空白空白 Java.ejb.FinderException, java.rmi.remoteexception 関連するインタフェースメソッドダイアログの EJB モジュールで表示される EJB が関連するインタフェースですデフォルト状態では関連するインタフェースは選択された状態です必要な情報を入力後に OK を押すと Find メソッドを追加するダイアログ画面が消えてメソッドダイアログ画面のメソッドリストに該当するメソッドを追加します関連する Local Home インタフェースを選択した場合 Local Home インタフェースのソースファイルにメソッドが追加されます関連する Home インタフェースを選択した場合 Home インタフェースのソースファイルにメソッドが追加されます付録

該当する Bean クラスには該当する内容が追加されます Select メソッドを追加するダイアログ追加する Select メソッドの関連情報を設定しますメソッド名称返却タイプパラメータユーザ定義異常メソッド異常関連するインタフェース ReturnTypeMapp ing 追加するメソッドの名前を入力しますメソッドの返却タイプを表示します追加するメソッドの引数を入力します

19 該当する Bean クラスには該当する内容が追加されます Select メソッドを追加するダイアログ追加する Select メソッドの関連情報を設定しますメソッド名称返却タイプパラメータユーザ定義異常メソッド異常関連するインタフェース ReturnTypeMapp ing 追加するメソッドの名前を入力しますメソッドの返却タイプを表示します追加するメソッドの引数を入力しますユーザが定義した追加するメソッドの例外型を入力します追加するメソッドの例外型を入力しますメソッドダイアログの EJB モジュールで表示される EJB が関連するインタフェースです入力した内容は ejb-jar.xml ファイル中の return-type-mapping タグ内容と対応します ejbselect java.util.collection 空白空白 java.ejb.finderexception デフォルト状態では関連するインタフェースは選択された状態です Local 付録

20 EJB QL テキスト入力した内容は ejb-jar.xml ファイル中の ejb-ql タグ内容と対応します空白必要な情報を入力後に OK を押すと Select メソッドを追加するダイアログ画面が消えてメソッドダイアログ画面のメソッドリストに該当するメソッドを追加します関連する Local Home インタフェースを選択した場合 Local Home インタフェースのソースファイルにメソッドが追加されます関連する Home インタフェースを選択した場合 Home インタフェースのソースファイルにメソッドが追加されます該当する Bean クラスと ejb-jar.xml ファイルには該当する内容が追加されます Home メソッドを追加するダイアログ追加する Home メソッドの関連情報を設定しますメソッド名称返却タイプパラメータユーザ定義異常追加するメソッドの名前を入力しますメソッドの返却タイプを表示します追加するメソッドの引数を入力しますユーザが定義した追加するメソッドの例外型を入力します ejbhome java.lang.string 空白空白付録

21 メソッド異常関連するインタフェース追加するメソッドの例外型を入力しますメソッドダイアログの EJB モジュールで表示される EJB が関連するインタフェースです java.rmi.remoteexception デフォルト状態では関連するインタフェースは選択された状態です必要な情報を入力後に OK を押すと Home メソッドを追加するダイアログ画面が消えてメソッドダイアログ画面のメソッドリストに該当するメソッドを追加します関連する Local Home インタフェースを選択した場合 Local Home インタフェースのソースファイルにメソッドが追加されます関連する Home インタフェースを選択した場合 Home インタフェースのソースファイルにメソッドが追加されます該当する Bean クラスには該当する内容が追加されますパラメータダイアログ追加した引数リストを表示します異常ダイアログ名称追加した引数の名前を表示します空白タイプパラメータのタイプを表示します空白必要な情報を入力後に OK を押すとパラメータダイアログ画面が消えてメソッド追加画面のパラメータテキストでパラメータが表示されます複数なパラメータがある場合コンマで区切ります追加する異常の関連情報を設定します付録

パラメータタイプパラメータのタイプを表示します空白必要な情報を入力後に OK を押すとパラメータを追加するダイアログ画面が消えてパラメータダイアログ

22 異常タイプ追加した異常のタイプを表示します空白必要な情報を入力後に OK を押すと異常ダイアログ画面が消えてメソッド追加画面のユーザ定義異常テキストで異常が表示されます複数な異常がある場合コンマで区切りますパラメータを追加するダイアログ追加するパラメータの関連情報を設定しますパラメータ名称追加した引数の名前を表示します空白パラメータタイプパラメータのタイプを表示します空白必要な情報を入力後に OK を押すとパラメータを追加するダイアログ画面が消えてパラメータダイアログ画面のリストにはレコードを一件追加しますメッセージ表示ユーザが入力時にエラーあるいは注意事項があれば情報は以下のようにメッセージ表示エリアに表示されますメソッドを削除する時以下のメッセージダイアログが表示されます付録

23 付録

WebOTXマニュアル

WebOTXマニュアル WebOTX アプリケーション開発ガイド WebOTX アプリケーション開発ガイドバージョン : 7.1 版数 : 第 2 版リリース : 2010 年 1 月 Copyright (C) 1998-2010 NEC Corporation. All rights reserved. 3-1 目次 3. J2EE WebOTX...3 3.1. Webアプリケーション...3 3.1.1. WARファイルをインポートするとタスクにエラーが表示される...3