2.2.3　Session Bean属性の詳細

Session Beanについて定義します。

なし。

なし。

省略できます。

省略できません。

ejbの名称を指定します。

なお，このキーはSession Beanを特定するためのキーとなります。

ejb-jar.xmlの<ejb-jar>-<enterprise-beans>-<session>-<ejb-name>の設定値を指定します。

ejb-jar.xmlを含まないアプリケーションの場合，@Stateless，@Stateful，または@Singletonのnameの設定値を指定します。

nameが指定されていない場合は，EJB実装クラス名のパッケージ名を取り除いたクラス名を指定します。

なし。

なし。

省略できません。

省略できません。

Session Beanのセキュリティアイデンティティを定義します。

なし。

なし。

省略できます。

省略できません。

実行時アイデンティティを定義します。

なし。

なし。

省略できません。

省略できません。

ユーザ名を指定します。

なし。

なし。

省略できません。

省略できません。

Session Beanから参照するリソースを定義します。

なし。

なし。

省略できます。

省略できません。

リソース参照の名称を指定します。

なし。

なし。

省略できません。

省略できません。

対応するリソースアダプタ表示名，メール表示名を指定します。

クラスタコネクションプール（互換機能）のメンバリソースアダプタは指定できません。

• Connector 1.0以前

  <リソースアダプタの表示名>

• Connector 1.5以降のアウトバウンドリソースアダプタ

  <リソースアダプタ表示名>!<コネクション定義識別子>

入力は制限されません。

なし。

省略できません。

省略できます。

Session Beanから参照するリソース環境変数を定義します。

なし。

なし。

省略できます。

省略できません。

リソース環境変数参照の名称を指定します。

なし。

なし。

省略できません。

省略できません。

キュー名称を指定します。

DDの<resource-env-ref-type>タグに「javax.jms.Queue」が指定された場合だけ有効です。

なお，<linked-to>タグ，<linked-queue>タグ，<linked-adminobject>タグのうちどれか一つを指定します。

なし。

DDの<resource-env-ref-type>タグと依存関係があります。

省略できません。

省略できます。

リソースアダプタの表示名を指定します。

Connector 1.5以降のリソースアダプタは指定できません。

入力は制限されません。

なし。

省略できません。

省略できません。

キュー名称を指定します。

入力は制限されません。

なし。

省略できません。

省略できません。

管理対象オブジェクトを指定します。

なお，<linked-to>タグ，<linked-queue>タグ，<linked-adminobject>タグのうちどれか一つを指定します。

なし。

なし。

省略できます。

省略できません。

リソースアダプタの表示名を指定します。

Connector1.0以前のリソースアダプタは指定できません。

入力は制限されません。

なし。

省略できません。

省略できません。

管理対象オブジェクト名を指定します。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

スペース（ ），エクスクラメーションマーク（!），ダブルクォーテーション（"），シャープ（#），ドル記号（$），パーセント（%），アンパサンド（&），シングルクォーテーション（'），バーレン（(）（)），アスタリスク（*），プラス（+），コンマ（,），ハイフン（-），ピリオド（.），コロン（:），セミコロン（;），レスザン（<），イコール（=），グレーターザン（>），クエスチョン（?），単価記号（@），ブラケット（[）（]），円マーク（\），キャレット（^），アンダースコア（_），バッククォート（`），ブレイス（{）（}），ストローク（|），チルダ（~）

ただし，次に示す名前は指定できません。

• 先頭または末尾にピリオド（.）を付けた名前

• ピリオド（.）だけの名前

• アンダースコア（_）が連続している名前

なし。

省略できません。

省略できません。

JavaBeansリソースの表示名を指定します。

DDの<resource-env-ref-type>タグに「JavaBeansリソースのクラス名」が指定された場合だけ有効です。

なお，<linked-to>タグ，<linked-queue>タグ，<linked-adminobject>タグのうちどれか一つを指定します。

なし。

DDの<resource-env-ref-type>タグと依存関係があります。

省略できます。

省略できます。

クライアントからEJBをルックアップする時に使う名前を指定します。HITACHI_EJB/SERVERS/<サーバ名>/EJB/<アプリケーションのルックアップ名>/<EJBのルックアップ名>の<EJBのルックアップ名>に相当します。

このタグを省略した場合，デフォルト値としてリソース名が使用されますが，デフォルト値に含まれる英数字とアンダースコア（_）以外の文字はすべてアンダースコアに変換されます。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

スペース（ ），ダブルクォーテーション（"），ドル記号（$），パーセント（%），アンパサンド（&），シングルクォーテーション（'），バーレン（(）（)），アスタリスク（*），プラス（+），コンマ（,），ハイフン（-），ピリオド（.），コロン（:），セミコロン（;），レスザン（<），イコール（=），グレーターザン（>），クエスチョン（?），単価記号（@），ブラケット（[）（]），円マーク（\），キャレット（^），アンダースコア（_），バッククォート（`），ブレイス（{）（}），ストローク（|），チルダ（~）

ただし，次に示す名前は指定できません。

• 先頭または末尾にピリオド（.）を付けた名前

• ピリオド（.）だけの名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。また，文字列の途中に改行がある場合はエラーとなります。

指定できる文字数は1〜255文字です。

なし。

省略できます。

省略できません。

リモートインタフェースの別名を指定します。

英数字（0〜9，A〜Z，a〜z），および次の特殊文字を使用できます。

スペース（ ），エクスクラメーションマーク（!），ダブルクォーテーション（"），シャープ（#），ドル記号（$），パーセント（%），アンパサンド（&），シングルクォーテーション（'），バーレン（(）（)），アスタリスク（*），プラス（+），コンマ（,），ハイフン（-），ピリオド（.），スラッシュ（/），コロン（:），セミコロン（;），レスザン（<），イコール（=），グレーターザン（>），クエスチョン（?），単価記号（@），ブラケット（[）（]），円マーク（\），キャレット（^），アンダースコア（_），バッククォート（`），ブレイス（{）（}），ストローク（|），チルダ（~）

ただし，次の名前は指定できません。

• 予約語のHITACHI_EJB（大文字・小文字を区別します）で始まる名前

• 先頭または末尾に，スラッシュ（/）またはピリオド（.）を指定した名前

• スラッシュ（/）が連続している名前

文字列の先頭または末尾に，半角スペースや改行がある場合，取り除かれて設定されます。また，文字列の途中に改行がある場合はエラーとなります。

指定できる文字数は1〜255文字です。

なし。

省略できます。

省略できません。

ローカルインタフェースの別名を指定します。

指定できる文字に制限はありません。

指定できる文字数は1〜255文字です。

なし。

省略できます。

省略できません。

セッションの最大数またはBeanインスタンスの最大数を指定します。

Stateless Session BeanまたはSingleton Session Beanの場合，この設定値は無効になります。

0（無制限）または1≦maximum-sessions≦2147483647の整数値。

なし。

省略できます。

省略できません。

Session Beanの種別がStatelessの場合に指定します。

<stateless>または<stateful>のどちらかを指定するか，またはどちらも指定しません。

なし。

DDの<session-type>タグと依存関係があります。

省略できます。

省略できます。

プール内のインスタンスについて定義します。

なし。

なし。

省略できます。

省略できません。

プール内のインスタンスの最小数を指定します。

0または1≦minimum≦maximumの整数値。

<maximum>タグと依存関係があります。

省略できます。

省略できません。

プール内のインスタンスの最大数を指定します。

0（無制限）または1≦maximum≦2147483647の整数値。

また，<enable-scheduling>タグの値がtrue，かつアプリケーション属性<managed-by-ctm>タグの値がtrueの場合は，指定可能範囲が異なります。

• アプリケーション属性の<scheduling-unit>タグの指定値がBeanの場合

  0または<scheduling>-<parallel-count>以上の整数値。

• アプリケーション属性の<scheduling-unit>タグの指定値がApplicationの場合

  0またはアプリケーション属性<scheduling>-<parallel-count>タグ以上の整数値。

<enable-scheduling>タグ，アプリケーション属性の<managed-by-ctm>タグ，アプリケーション属性の<scheduling-unit>タグ，<scheduling>-<parallel-count>タグ，およびアプリケーション属性の<scheduling>-<parallel-count>タグと依存関係があります。

省略できます。

省略できません。

インスタンス取得タイムアウト時間（秒）を指定します。

0を指定した場合，タイムアウトしません。

0〜86400の整数値。

なし。

省略できます。

省略できません。

Session Beanの種別がStatefulの場合に指定します。

<stateless>もしくは<stateful>のどちらかを指定するか，またはどちらも指定しません。

なし。

DDの<session-type>タグと依存関係があります。

省略できます。

省略できます。

アクティブセッションの最大数を指定します。

maximum-sessionsが0（無制限）の場合

0（無制限）≦maximum-active-sessions≦2147483647の整数値。

maximum-sessionsが0（無制限）以外の場合

1≦maximum-active-sessions≦maximum-sessionsの整数値。

DDの<maximum-sessions>タグと依存関係があります。

省略できます。

省略できません。

再びアクティブ化するまでに非アクティブ状態に保持しておく時間（分）を指定します。

0（無制限）または1≦inactivity-timeout≦2147483647の整数値。

なし。

省略できます。

省略できません。

セッションが削除されるまでに非アクティブ状態に保持しておく時間（分）を指定します。

0（無制限）または1≦removal-timeout≦2147483647の整数値。

なし。

省略できます。

省略できません。

該当するBeanをスケジューラのGateとして使用するかどうかを指定します。

• true

  使用する。

• false

  使用しない。

なし。

省略できます。

省略できません。

pass-by-referenceでEJBを呼び出すかどうかを指定します。

• true

  EJBを呼び出す。

• false

  EJBを呼び出さない。

なし。

省略できます。

省略できません。

CTM連携関連の情報を設定します。

なし。

DDの<session-type>タグ，<scheduling-unit>タグ，および<enable-scheduling>タグと依存関係があります。

省略できます。

省略できません。

スケジューリングを実行するキュー名を指定します。

英数字，アンダースコア「_」を使用できます。

指定できる文字数は1〜63文字です。

なし。

省略できます。

省略できません。

CTMスケジューラがアプリケーションを呼ぶために用意するスレッド数を指定します。

1〜127の整数値。

なし。

省略できます。

省略できません。

キューの長さを指定します。

1〜32767の整数値。

なし。

省略できます。

省略できません。

フロントEJB（クライアントが直接呼び出すEJB）かどうかを指定します。

• true

  フロントEJBである。

• false

  フロントEJBでない。

なし。

省略できます。

省略できません。

J2EEアプリケーション開始時・停止時の順番を指定します。開始時は昇順で開始処理が行われ，終了時は降順に停止処理が行われます。

0〜2147483647の整数値。

なし。

省略できます。

省略できません。

EJBメソッドにJ2EEアプリケーションの実行時間の監視機能のメソッドタイムアウト時間を設定する場合に指定します。<ejb-method-observation-timeout>の指定が複数あり，<method>タグ以下の設定値（<description>タグを除く）が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE42377-W）が出力され，先に定義された<ejb-method-observation-timeout>タグの<method-observation-timeout>タグの値が有効となります。

なし。

なし。

省略できます。

省略できません。

メソッドについて定義します。

なし。

なし。

省略できません。

省略できません。

メソッドが属するインタフェース種別を特定する場合に指定します。

• Home

• Remote

• LocalHome

• Local

なし。

省略できます。

省略できません。

対象となるメソッド名を指定します。

アスタリスク「*」を指定した場合，すべてのメソッドを意味します。

なし。

DDの<method-params>タグと依存関係があります。

省略できません。

省略できません。

メソッドが多重定義されている場合，メソッドを特定するために指定します。

なし。

なし。

省略できます。

省略できます。

引数のデータ型を指定します。

空白区切り文字，行区切り文字，および段落区切り文字以外を指定します。

なし。

省略できます。

省略できません。

J2EEアプリケーションの実行時間の監視機能のメソッドタイムアウト時間（秒）を指定します。0を指定した場合，タイムアウトしません。

0〜86400の整数値。

なし。

省略できません。

省略できません。

EJB（CMT）のメソッドにトランザクションタイムアウト時間を設定する場合に指定します。

<ejb-transaction-timeout>タグの指定が複数あり，<method>タグ以下の設定値が同じ場合，一つにマージされます。その場合，ワーニングメッセージ（KDJE42377-W）が出力され，先に定義された<ejb-transaction-timeout>タグの<transaction-timeout>タグの値が有効となります。

なし。

なし。

省略できます。

省略できません。

メソッドについて定義します。

なし。

なし。

省略できません。

省略できません。

メソッドが属するインタフェース種別を特定する場合に指定します。

• Home

• Remote

• LocalHome

• Local

なし。

省略できます。

省略できません。

対象となるメソッド名を指定します。

アスタリスク「*」を指定した場合はすべてのメソッドを意味します。

なし。

DDの<method-params>タグと依存関係があります。

省略できません。

省略できません。

メソッドが多重定義されている場合，メソッドを特定するために指定します。

なし。

なし。

省略できます。

省略できます。

引数のデータ型を指定します。

なし。

なし。

省略できます。

省略できません。

トランザクションタイムアウト時間（秒）を指定します。

0を指定した場合は，J2EEサーバに設定されたデフォルトのタイムアウト値で動作します。

0〜2147483647の整数値。

なし。

省略できません。

省略できません。