2.2.4　Entity Bean属性の詳細

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

なし。

なし。

省略できます。

省略できません。

ejbの名称を指定します。

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

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

入力は制限されません。

なし。

省略できません。

省略できません。

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

なし。

なし。

省略できます。

省略できません。

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

なし。

なし。

省略できません。

省略できません。

ユーザ名を指定します。

入力は制限されません。

なし。

省略できません。

省略できません。

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

なし。

なし。

省略できます。

省略できません。

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

入力は制限されません。

なし。

省略できません。

省略できません。

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

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

• Connector 1.0以前

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

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

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

入力は制限されません。

なし。

省略できません。

省略できます。

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

なし。

なし。

省略できます。

省略できません。

resource-env-refの名称を指定します。

入力は制限されません。

なし。

省略できません。

省略できません。

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

このタグは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>タグのうちどれか一つを指定します。

なし。

なし。

省略できます。

省略できません。

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

Connector 1.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文字です。

なし。

省略できます。

省略できません。

Enterprise Beanインスタンスの最大数を指定します。

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

なし。

省略できます。

省略できません。

インスタンスプールのプロパティを指定します。

なし。

なし。

省略できます。

省略できません。

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

0（無制限）または1≦minimum≦maximum。

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

省略できます。

省略できません。

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

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

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

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

1≦maximum≦maximum-instancesの整数値。

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

省略できます。

省略できません。

キャッシングモデルを指定します。

• full-caching

  メソッド起動間のすべての状態情報をキャッシュします。

• caching

  メソッド起動間で最も頻繁に使用された状態情報をキャッシュします。

• no-caching

  状態情報をキャッシュしません。

なし。

省略できます。

省略できません。

EJBオブジェクトの存在時間（秒）を指定します。

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

0〜2147483647の整数値。

なし。

省略できます。

省略できません。

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

• true

  EJB呼び出しをする。

• false

  EJB呼び出しをしない。

なし。

省略できます。

省略できません。

インスタンス取得タイムアウト時間（秒）を指定します。0を指定した場合，タイムアウトしません。

0〜86400の整数値。

なし。

省略できます。

省略できません。

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

• true

  フロントEJBの場合。

• false

  フロントEJBでない場合。

なし。

省略できます。

省略できません。

Entity Beanのフィールドをデータベース上にマッピングします。

なし。

なし。

省略できます。

省略できません。

Enterprise Beanフィールドのマッピング先として開始されたリソースアダプタの表示名を指定します。

• Connector 1.0以前

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

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

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

入力は制限されません。

なし。

省略できません。

省略できません。

Enterprise Beanフィールドのマッピング先としてデータベースのカタログ名を指定します。

入力は制限されません。

なし。

省略できます。

省略できません。

Enterprise Beanフィールドのマッピング先としてデータベースのスキーマ名を指定します。

入力は制限されません。

なし。

省略できます。

省略できません。

Enterprise Beanフィールドのマッピング先としてデータベースのテーブル名を指定します。

入力は制限されません。

なし。

省略できません。

省略できません。

アプリケーションからデータベースへの書き込みを禁止するかどうかを指定します。ただし，アプリケーションサーバでは指定しても無効になります。

• true

  書き込みを禁止する。

• false

  書き込みを許可する。

なし。

省略できません。

省略できません。

トランザクション遮断レベルを指定します。

省略した場合，デフォルトのトランザクション遮断レベルが使われます（使用するデータベースおよびJDBCドライバによって異なります）。

• none

  トランザクションがサポートされていません。

• read_committed

  ダーティー読み取りが抑制されます。

• read_uncommitted

  ダーティー読み取り，繰り返し不可の読み取り，およびファントム読み取りが起こります。

• repeatable_read

  ダーティー読み取りおよび繰り返し不可の読み取りが抑制されます。

• serializable

  ダーティー読み取り，繰り返し不可の読み取り，およびファントム読み取りが抑制されます。

なし。

省略できます。

省略できません。

データベースに書き込むデータとレコードとの照合方法を指定します。

• primary-key

  プライマリキーと照合することによってデータを更新します。

• modified-data

  プライマリキーと照合して変更対象のデータの値が最後の読み出し操作以降に変更されているかどうかをチェックします。

• whole-row

  プライマリキーと照合して変更対象の値を含む行内のすべての値が最後の読み出し操作以降に変更されているかどうかをチェックします。

なし。

省略できます。

省略できません。

Entity Beanのフィールドとテーブルのカラムとのマッピングを指定します。

なし。

なし。

省略できます。

省略できません。

Entity Beanのフィールド名を指定します。

入力は制限されません。

なし。

省略できません。

省略できません。

テーブルのカラム名を指定します。

入力は制限されません。

なし。

省略できません。

省略できません。

ejbFindByPrimaryKey以外のFinderメソッドの検索条件を指定します。

なし。

なし。

省略できます。

省略できません。

Finderメソッドのメソッド名を指定します。

入力は制限されません。

なし。

省略できません。

省略できません。

テーブルの検索条件を指定します。

検索条件に指定可能な演算子を次に示します。

なお，山括弧<>は，XMLの構文上値には指定できません。テキストエディタで属性ファイルを編集する場合は，表内の丸括弧()のようにエンティティを使用してください。

検索条件の構文を次に示します。

• IS NULL，IS NOT NULL演算子を使用する場合

  フィールド名 演算子

• BETWEEN，NOT BETWEEN演算子を使用する場合

  フィールド名 演算子 ?番号 AND ?番号

• そのほかの演算子を使用する場合

  フィールド名 演算子 ?番号

検索条件に関する規則を次に示します。

• 検索条件は，ANDまたはORで接続できます。

• 検索条件，AND，OR，フィールド名は大文字小文字を区別します。

• ?番号には，Finderメソッドの引数の場所（左から1,2,...）を指定します。

  例　id &lt;= ?1 AND value IS NOT NULL OR name BETWEEN ?3 AND ?4

• 検索条件，AND，OR，フィールド名，?番号の間は1文字以上の空白を入れてください。

• 空文字列の場合は，テーブルのすべての行が検索パターンに一致するものと見なします。

• DISABLEが指定されている場合はアプリケーションからこのメソッドを使用できません。

指定できる値はシャープ「#」以外です。

なし。

省略できません。

省略できます。

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

0〜2147483647の整数値。

なし。

省略できます。

省略できません。

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

なし。

なし。

省略できます。

省略できません。

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

なし。

なし。

省略できません。

省略できません。

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

• Home

• Remote

• LocalHome

• Local

なし。

省略できます。

省略できません。

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

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

入力は制限されません。

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

省略できません。

省略できません。

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

なし。

なし。

省略できます。

省略できます。

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

入力は制限されません。

なし。

省略できます。

省略できません。

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

0〜86400の整数値。

なし。

省略できません。

省略できません。

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

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

なし。

なし。

省略できます。

省略できません。

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

なし。

なし。

省略できません。

省略できません。

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

• Home

• Remote

• LocalHome

• Local

なし。

省略できます。

省略できません。

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

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

入力は制限されません。

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

省略できません。

省略できません。

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

なし。

なし。

省略できます。

省略できます。

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

入力は制限されません。

なし。

省略できます。

省略できません。

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

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

0〜2147483647の整数値。

なし。

省略できません。

省略できません。