C weblogic-cmp-jar.xmlデプロイメント記述子のリファレンス
weblogic-cmp-jar.xml
ファイルのEJB 2.1の要素について学習します。これらの定義を使用して、EJBデプロイメントを構成するWebLogic固有のweblogic-cmp-jar.xml
ファイルを作成します。このデプロイメント記述子ファイルを使用して、コンテナ管理による永続性(CMP)の動作を指定します。 ノート:
EJB 3.x実装でメタデータ・アノテーションを使用している場合は、Oracle WebLogic Server Enterprise JavaBeansの開発のEJBメタデータ・アノテーション・リファレンスを参照してください。WebLogic Serverのweblogic-cmp-jar.xml
ファイルは、XMLスキーマ(XSD)に基づいています。9.0より前のリリースのWebLogic Serverでは、weblogic-cmp-jar.xml
は文書型定義(DTD)に基づいていました。後方互換性を保持するために、WebLogic ServerではXSDベースとDTDベースのEJB記述子が引き続きサポートされています。そのため、WebLogic ServerのDTDベースの記述子を使用するアプリケーションも記述子を変更せずにデプロイできます。
EJB 1.1デプロイメント記述子の要素については、「EJB 1.1ユーザーへの重要な情報」を参照してください。
詳細情報:
-
weblogic-cmp-jar.xml
に必要なXMLスキーマ定義とネームスペース宣言、および文書型定義とDOCTYPEヘッダーについては、「デプロイメント記述子スキーマおよび文書型定義リファレンス」を参照してください。 -
weblogic-ejb-jar.xml
ファイルについては、「weblogic-ejb-jar.xmlデプロイメント記述子のリファレンス」を参照してください。
EJB 1.1デプロイメント記述子の要素については、「EJB 1.1ユーザーへの重要な情報」を参照してください。
この付録の内容は次のとおりです。
- 2.1のweblogic-cmp-jar.xmlデプロイメント記述子ファイルの構造
- 2.1のweblogic-cmp-jar.xmlデプロイメント記述子の要素
- allow-readonly-create-and-remove
- automatic-key-generation
- caching-element
- caching-name
- check-exists-on-method
- cluster-invalidation-disabled
- cmp-field
- cmr-field
- column-map
- compatibility
- create-default-dbms-table
- database-specific-sql
- database-type
- data-source-jndi-name
- db-cascade-delete
- dbms-column
- dbms-column-type
- dbms-default-value
- default-dbms-tables-ddl
- delay-database-insert-until
- description
- disable-string-trimming
- ejb-name
- ejb-ql-query
- enable-batch-operations
- enable-query-caching
- field-group
- field-map
- finders-return-nulls
- foreign-key-column
- foreign-key-table
- generator-name
- generator-type
- group-name
- include-updates
- instance-lock-order
- key-cache-size
- key-column
- lock-order
- max-elements
- method-name
- method-param
- method-params
- optimistic-column
- order-database-operations
- pass-through-columns
- primary-key-table
- query-method
- relation-name
- relationship-caching
- relationship-role-map
- relationship-role-name
- serialize-byte-array-to-oracle-blob
- serialize-char-array-to-bytes
- sql
- sql-query
- sql-select-distinct
- sql-shape
- sql-shape-name
- table-map
- table-name
- trigger-updates-optimistic-column
- unknown-primary-key-field
- use-select-for-update
- validate-db-schema-with
- verify-columns
- verify-rows
- version-column-initial-value
- weblogic-ql
- weblogic-query
- weblogic-rdbms-bean
- weblogic-rdbms-jar
- weblogic-rdbms-relation
- weblogic-relationship-role
2.1のweblogic-cmp-jar.xmlデプロイメント記述子ファイルの構造
weblogic-cmp-jar.xml
ファイルは、WebLogic ServerのRDBMSベースの永続性サービスを使用するエンティティEJBのデプロイメント記述子を定義します。EJBコンテナでは、9.0より前のバージョンのWebLogic Serverで提供されていたXMLとは異なるバージョンのweblogic-cmp-jar.xml
を使用します。
旧バージョンのweblogic-cmp-jar.xml
DTD Beanも引続きこのリリースのWebLogic Serverにデプロイできます。同様に、WebLogic Server 8.1でサポートされていたweblogic-cmp-jar.xml
DTDも引続き使用できます。WebLogic Server 9.0から、デプロイメント記述子はXSDベースになりましたが、後方互換性を保持するためにWebLogic ServerはDTDベースの記述子も引続きサポートしています。ただし、CMP 2.1の機能を使用する場合は、下記のXSDを使用する必要があります。
このリリースのWebLogic Serverに対応させるため、DDConverterを実行して9.0より前のリリースのEJBデプロイメント記述子を変換することをお薦めします。DDConverterでは、9.0より前のリリースのWebLogic ServerのDTDベースのEJBデプロイメント記述子を、このリリースでサポートされているXSDベースの記述子に変換します。
ノート:
アプリケーションを新しいWebLogic Serverリリースに移行するときには、必ず記述子を変換することをお薦めします。
WebLogic Serverのweblogic-cmp-jar.xml
の最上位要素は、weblogic-rdbms-jar
要素で構成されます。
weblogic-rdbms-jar weblogic-rdbms-bean ejb-name data-source-jndi-name table-map field-group relationship-caching sql-shape weblogic-query delay-database-insert-until use-select-for-update lock-order instance-lock-order automatic-key-generation check-exists-on-method cluster-invalidation-disabled weblogic-rdbms-relation relation-name table-name weblogic-relationship-role order-database-operations enable-batch-operations create-default-dbms-tables validate-db-schema-with database-type default-dbms-tables-ddl compatibility serialize-byte-array-to-oracle-blob serialize-char-array-to-bytes allow-readonly-create-and-remove disable-string-trimming
2.1のweblogic-cmp-jar.xmlデプロイメント記述子の要素
以下のweblogic-cmp-jar.xml
要素のリストには、このリリースのWebLogic Serverでサポートされているすべての要素が含まれています。
allow-readonly-create-and-remove
値の範囲: true | false
デフォルト値: false
親要素:
weblogic-rdbms-jar compatibility
機能
WebLogic Server 8.1 SP02で導入されたこの要素は、後方互換性のフラグです。ReadOnly
同時実行性を使用するEJBで作成と削除を有効にするために使用します。
WebLogic Server 8.1 SP2より前は、それらの処理は許可されていました(ただしトランザクション的な意味はありませんでした)。ReadOnly
Beanでより効率的なコードを生成できるように、また、それらを使用するのがプラクティスとして良くないという理由から、作成と削除は許可されなくなっています。
automatic-key-generation
値の範囲:なし
デフォルト値:なし
親要素:
weblogic-rdbms-bean
機能
automatic-key-generation
要素は、主キーが自動的に生成される方法を指定します。この機能の詳細については、「主キーの自動生成」を参照してください
親トピック: automatic-key-generation
例
以下のサンプル・コードは、さまざまな主キー生成方法のautomatic-key-generation
要素を示しています。サポートされている生成方法については、「generator-type」を参照してください
例C-1 generator-type=Oracleのautomatic-key-generation
<automatic-key-generation> <generator-type>Oracle</generator-type> <generator-name>test_sequence</generator-name> <key-cache-size>10</key-cache-size> </automatic-key-generation>
例C-2 generator-type=SQL-SERVERのautomatic-key-generation
<automatic-key-generation> <generator-type>SQL-SERVER</generator-type> </automatic-key-generation>
例C-3 generator-type=NamedSequenceTableのautomatic-key-generation
<automatic-key-generation> <generator-type>NamedSequenceTable</generator-type> <generator-name>MY_SEQUENCE_TABLE_NAME</generator-name> <key-cache-size>100</key-cache-size> </automatic-key-generation>
親トピック: automatic-key-generation
caching-element
値の範囲:なし
デフォルト値:なし
親要素:
weblogic-rdbms-jar weblogic-rdbms-bean relationship-caching
機能
関連するBeanでcmr-field
とgroup-name
を指定します。group-name
を指定しなかった場合、デフォルトのgroup-name
(全フィールドをロード)が使用されます。詳細については、「group-name」を参照してください
caching-element
では、relationship-cachingの例のようにネストされたキャッシュ要素を格納できます
リレーションシップ・キャッシングについては、「リレーションシップ・キャッシング」を参照してください
親トピック: caching-element
caching-name
値の範囲:なし
デフォルト値:なし
親要素:
weblogic-rdbms-jar weblogic-rdbms-bean relationship-caching
機能
caching-name
要素は、リレーションシップ・キャッシュの名前を指定します。リレーションシップ・キャッシングについては、「リレーションシップ・キャッシング」を参照してください
親トピック: caching-name
check-exists-on-method
値の範囲: True | False
デフォルト値: True
親要素:
weblogic-rdbms-bean
機能
デフォルトでは、EJBコンテナはコンテナ管理による永続性(CMP)エンティティBeanの有無を、Bean上で呼び出されたビジネス・メソッドが完了する前にチェックします。これは、削除されたコンテナ管理のエンティティBean上で何らかのビジネス・メソッドが呼び出されると、直ちにコンテナがアプリケーションに対して通知を行うことを意味します。
EJBコンテナが、存在するかどうかのチェックをする前にトランザクションの完了を待機するように指定するには、check-exists-on-method
をFalse
に設定します。これにより、大半のアプリケーションで高いパフォーマンスを実現しつつ、十分なレベルのチェックが提供されます。
親トピック: check-exists-on-method
例
次の例では、削除されたCMPエンティティBean上でビジネス・メソッドが呼び出されたことをWebLogic Serverがアプリケーションに通知するように指定しています。
<check-exists-on-method>True</check-exists-on-method>
親トピック: check-exists-on-method
cluster-invalidation-disabled
値の範囲: true | false
デフォルト値: false
親要素:
weblogic-rdbms-bean
機能
WebLogic Server 9.0で採用されたこのフラグは、Optimistic
またはReadOnly
同時実行性を使用するEJBがデプロイ先のクラスタのメンバーによって更新されたときにそのEJBを無効化するかどうかを指定するために使用します。詳細については、「クラスタ内のオプティミスティック同時実行性の無効化オプション」を参照してください
cmp-field
値の範囲: Beanのフィールドの有効な名前。フィールドは、ejb-jar.xml
内に対応するcmp-entry
エントリを持つ必要があります。フィールド名は大文字と小文字が区別されます。
デフォルト値:なし
親要素:
weblogic-rdbms-bean field-map
および
weblogic-rdbms-relation field-group
機能
この名前は、Beanインスタンスのマップされたフィールドを指定します。Beanインスタンスのフィールドには、データベースから取得した情報が指定されている必要があります。
親トピック: cmp-field
cmr-field
値の範囲: Beanのフィールドの有効な名前。フィールドは、ejb-jar.xml
に対応するcmr-field
エントリを持つ必要があります。
デフォルト値:なし
親要素:
weblogic-rdbms-relation field-group
および
relationship-caching caching-element
column-map
値の範囲:なし
デフォルト値:なし
親要素:
<weblogic-rdbms-relation> <weblogic-relationship-role> <relationship-role-map>
機能
この要素は、データベース内の表の外部キー列と対応する主キーのマッピングを表します。2つの列は同じ表にある場合も別の表にある場合もあります。列が属している表は、column-map
要素がデプロイメント記述子に表示されるコンテキストに対しては暗黙的です。
親トピック: column-map
例
column-map
要素の例は以下のとおりです。
ノート:
foreign-key-column
がリモートBeanを参照する場合は、key-column
要素を指定する必要はありません。
<column-map> <foreign-key-column>account-id</foreign-key-column> <key-column>id</key-column> </column-map>
親トピック: column-map
compatibility
値の範囲:なし
デフォルト値:なし
親要素:
weblogic-rdbms-jar
機能
WebLogic Server 8.1 SP02で導入された<compatibility>
要素では、記述子ファイルで記述されているすべてのcmp Beanの互換性フラグを指定する要素を設定します。
親トピック: compatibility
例
<compatibility> <serialize-byte-array-to-oracle-blob>...</serialize-byte-array-to-oracle-blob> <serialize-char-array-to-bytes>...</serialize-char-array-to-bytes> <allow-readonly-create-and-remove>...</allow-readonly-create-and-remove> <disable-string-trimming>...</disable-string-trimming> </compatibility>
親トピック: compatibility
create-default-dbms-table
値の範囲: Disabled | CreateOnly | DropAndCreate | DropAndCreateAlways | AlterOrCreate
デフォルト値: Disabled
親要素:
weblogic-rdbms-jar
機能
create-default-dbms-table
要素は、以下の2つの機能を実行します。
-
基底の表スキーマが変更されたときに、WebLogic Serverがデプロイメント・ファイルおよびBeanクラスの記述に基づいて自動的にデフォルト表を作成するかどうか、またはどのように作成するのかを決める
-
WebLogic ServerがOracleデータベースのSEQUENCEを自動的に作成するかどうか、またはどのように作成するのかを決める
この要素は、開発段階で役立つ場合にのみ使用します。使用するDBMS CREATE
文の表スキーマがコンテナの最適な定義になります。プロダクション環境では通常、より正確なスキーマ定義が必要です。
親トピック: create-default-dbms-table
自動表作成
次の表は、WebLogic Serverがcreate-default-dbms-tables
の値に基づいてどのように自動表作成を処理するのかを説明しています。
表C-1 自動表作成
<create-default-dbms-tables>の設定値 | 自動表作成に関連する動作 |
---|---|
|
EJBコンテナは自動表作成に関して何も行いません。これがデフォルト値です。 |
|
EJBコンテナは、スキーマの変更を検出すると自動的に表を生成します。 コンテナは、デプロイメント・ファイルおよびBeanクラス内の情報に基づいて表を作成しようとします。表作成が失敗した場合は、 |
|
EJBコンテナは、スキーマの変更を検出すると自動的に表を生成します。 コンテナは、列が変更されている場合はデプロイメント時に表を削除してから再作成します。コンテナはデータを保存しません。 列タイプとcmpフィールド・タイプの間に互換性があることを確認する必要があります。EJBコンテナは、列タイプとcmpフィールド・タイプの間に互換性があることを確認しません。 |
|
EJBコンテナは、スキーマの変更を検出すると自動的に表を生成します。 コンテナは、列が変更されているかどうかに関係なくデプロイメント時に表を削除してから作成します。コンテナはデータを保存しません。 |
|
EJBコンテナは、スキーマの変更を検出すると自動的に表を生成します。 コンテナは、まだ存在していない場合は表を作成します。表が存在する場合、コンテナは表スキーマを変更します。データは保存されます。 ノート: 新しい列が主キーとして指定されているか、値がnullの列が新しい主キー列として指定されている場合には、この設定を選択しないでください。 |
TABLE CREATION
が失敗した場合、サーバーはTable Not Found
エラーを送出するので、表を手動で作成しなければなりません。
「自動表作成(開発のみ)」を参照してください。
親トピック: create-default-dbms-table
OracleデータベースのSEQUENCEの自動生成
ノート:
OracleデータベースのSEQUENCEの自動生成は、開発モードで動作しているサーバーでのみ機能します。
次の表は、WebLogic Serverがcreate-default-dbms-tables
の値に基づいてどのように自動SEQUENCE生成を処理するのかを説明しています。
表C-2 OracleデータベースのSEQUENCEの自動生成
<create-default-dbms-tables>の設定値 | 得られる動作 |
---|---|
|
EJBコンテナはSEQUENCE生成に関して何も行いません。これがデフォルト値です。 |
|
EJBコンテナは |
|
EJBコンテナは
|
|
EJBコンテナはSEQUENCEを作成し、
|
|
EJBコンテナは
|
OracleデータベースのSEQUENCEの自動生成の詳細については、「OracleデータベースのSEQUENCEのサポート」を参照してください
親トピック: create-default-dbms-table
例
次の例では、create-default-dbms-tables
要素を指定します。
<create-default-dbms-tables>CreateOnly</create-default-dbms-tables>
親トピック: create-default-dbms-table
database-specific-sql
値の範囲:なし
デフォルト値:なし
要件: database-type
の指定が必要
親要素:
weblogic-rdbms-jar weblogic-rdbms-bean weblogic-query sql-query
例
<database-specific-sql> <database-type>SQLServer</database-type> <sql>SELECT name, phone, location, testid FROM medrecappPharmacyBeanTable WHERE testid = ?1 AND SUBSTRING(testid, 1,5) = 'local' ORDER BY name </sql> </database-specific-sql>
親トピック: database-specific-sql
database-type
値の範囲: DB2 | Informix | MySQL | Oracle | SQLServer | SQLServer2000 | Sybase
デフォルト値:なし
親要素:
weblogic-rdbms-jar
および
weblogic-rdbms-jar weblogic-rdbms-bean weblogic-quer sql-query database-specific-sql
機能
database-type
要素では、基底WebLogic Server DBMSまたはベンダー固有のSQL文の実行対象となるDBMSとして使用するデータベースを指定します。weblogic-rdbms-jar
要素でdatabase-type
を指定した場合、指定したデータベースは、database-specific-sql
要素の別のdatabase-type
要素によってオーバーライドされない限り、weblogic-rdbms-jar
デプロイメント記述子ファイル全体に適用されます。
親トピック: database-type
data-source-jndi-name
値の範囲:有効なWebLogic Server JDBCデータ・ソース名
デフォルト値:なし
親要素:
weblogic-rdbms-bean
機能
このBeanのデータベース接続で使用するJDBCデータ・ソース名を指定します。データソースの詳細は、『Oracle WebLogic Server JDBCアプリケーションの開発』を参照してください。
ノート:
WebLogic Server 9.0より前では、この要素はdata-source-nameでした。
親トピック: data-source-jndi-name
db-cascade-delete
値の範囲:なし
デフォルト値:デフォルトでは、データベースのカスケード削除は使用されません。EJBコンテナは、個別にSQL DELETE
を発行してカスケード削除を実行します。
親要素:
weblogic-rdbms-bean weblogic-relationship-role
機能
アプリケーションが、データベースに組み込まれているカスケード削除のサポートを利用し、パフォーマンスが向上するようにします。この機能は、以下の場合にのみサポートされます。
-
Oracleデータベース
-
1対1または1対多の関係
weblogic-cmp-rdbms-jar.xml
でdb-cascade-delete
が有効になっている場合は、以下のようにする必要があります。
-
ejb-jar.xml
でcascade-delete
を有効にする -
データベースの表定義でカスケード削除を有効にする
ノート:
db-cascade-delete
を指定しない場合は、データベースのカスケード削除機能を有効にしないようにしてください(結果が不正確になります)。
親トピック: db-cascade-delete
Oracleデータベースでのカスケード削除の設定
次のOracleデータベースの表定義では、データベースで親のdept
が削除されるとemp
行がすべて削除されます。
CREATE TABLE dept (deptno NUMBER(2) CONSTRAINT pk_dept PRIMARY KEY, dname VARCHAR2(9) ); CREATE TABLE emp (empno NUMBER(4) PRIMARY KEY, ename VARCHAR2(10), deptno NUMBER(2) CONSTRAINT fk_deptno REFERENCES dept(deptno) ON DELETE CASCADE );
親トピック: db-cascade-delete
例
<weblogic-relationship-role> <db-cascade-delete/> </weblogic-relationship-role>
親トピック: db-cascade-delete
dbms-column
値の範囲:有効なデータベース列
デフォルト値:なし
親要素:
weblogic-rdbms-bean field-map
機能
フィールドがマップされるデータベース列の名前です。
ノート:
大文字/小文字を区別しないデータベースの場合でも、dbms-column
では大文字/小文字を区別します。
親トピック: dbms-column
dbms-column-type
値の範囲: Blob | Clob | LongString | SybaseBinary
デフォルト値:なし
要件: Blob
またはClob
を指定するには、dbms-default-value
をOracle
またはDB2
データベースに設定する必要がある
親要素:
weblogic-rdbms-bean field-map
機能
cmp-field
の型を指定します。現在のフィールドをOracleまたはDB2データベース内のBlob
またはClob
、またはSybaseデータベース内のLongString
またはSybaseBinary
にマップします。
-
Blob
- フィールドをOracleまたはDB2データベースのBlobにマップします。 -
Clob
- フィールドをOracleまたはDB2データベースのClobにマップします。 -
LongString
-setCharacterStream
を使用して文字列データをデータベースに書き込むようにコンテナに通知します。一部のJDBCドライバでは、4KBを超えるデータをsetString
で書き込むことに問題があります。 -
SybaseBinary
-setBytes
を使用してバイトをバイナリ列に書き込むようにコンテナに通知します(setBinaryStream
がSybaseXADriver
では機能しないため)。
親トピック: dbms-column-type
例
<field-map> <cmp-field>photo</cmp-field> <dbms-column>PICTURE</dbms-column> <dbms_column-type>OracleBlob</dbms-column-type> </field-map>
親トピック: dbms-column-type
dbms-default-value
値の範囲: DB2 | Informix| MySQL | Oracle | SQLServer | SQLServer2000 | Sybase
デフォルト値:
親要素:
weblogic-rdbms-bean field-map
delay-database-insert-until
値の範囲: ejbCreate | ejbPostCreate
デフォルト値: ejbPostCreate
要件:
親要素:
weblogic-rdbms-bean
機能
新しいCMP Beanがいつデータベースに挿入されるのかを指定します。指定可能な値で、以下の動作が行われます。
-
ejbCreate
-ejbCreate
の直後にデータベースの挿入を実行します。この設定の場合は、不要な格納操作を避けることでejbCreate
よりもパフォーマンスが良くなります。 -
ejbPostCreate
-ejbPostCreate
の直後に挿入を実行します。
この要素は、order-database-operations
がFalse
の場合のみ有効です。デフォルトでは、order-database-operations
はtrue
です。デフォルトの場合は、トランザクションがコミットされたときに新しいBeanが挿入されます。
cmr-field
がnull値を許可しないforeign-key
列にマップされている場合、データベースの挿入はejbPostCreate
の後まで遅延する必要があります。この場合、cmr-field
をejbPostCreate
でnull以外の値に設定してからBeanをデータベースに挿入しなければなりません。
最大限の柔軟性を実現するため、関連BeanをejbPostCreate
メソッドで作成することは避けてください。ejbPostCreate
で関連Beanが作成され、データベースの制約によって関連Beanが未作成のBeanを参照できない場合は、メソッドが完了するまでデータベースの挿入は実行できません。
ノート:
cmr-field
は、Beanの主キーが不明な段階でejbCreate
の中で設定することはできません。
親トピック: delay-database-insert-until
例
<delay-database-insert-until>ejbPostCreate</delay-database-insert-until>
親トピック: delay-database-insert-until
description
値の範囲:なし
デフォルト値:なし
親要素:
weblogic-rdbms-jar weblogic-rdbms-bean weblogic-query
または
weblogic-rdbms-jar weblogic-rdbms-bean sql-shape
disable-string-trimming
値の範囲: True | False
デフォルト値: False
親要素:
compatibility
機能
この要素は、WebLogic Server 9.0で導入された互換性フラグです。この要素では、String[]
型のcmp-field
を削除するかどうかを指定します。True
に設定すると、文字列の削除が無効になります。文字列の削除の詳細については、「文字列値CMPフィールドの削除」および「文字列の削除を無効にする」を参照してください
親トピック: disable-string-trimming
例
<compatibility> <disable-string-trimming>True</disable-string-trimming> </compatibility>
親トピック: disable-string-trimming
ejb-name
値の範囲: ejb-jar.xml
で定義したCMPエンティティBeanのejb-name
に一致する必要があります。
デフォルト値:なし
親要素:
weblogic-rdbms-bean
機能
ejb-cmp-rdbms.xml
で定義したEJBを指定する名前です。この名前は、ejb-jar.xml
で定義したCMPエンティティBeanのejb-name
に一致している必要があります。
親トピック: ejb-name
ejb-ql-query
値の範囲:
デフォルト値:
親要素:
weblogic-rdbms-jar weblogic-rdbms-bean weblogic-query
機能
ejb-ql-query
要素では、EJB-QL問合せを指定します。weblogic-cmp-jar.xml
デプロイメント記述子では、EJBファインダを実装しているか、またはWebLogic固有の拡張を備えているEJB-QLのみを指定します。標準EJB-QL機能のみを使用する問合せはejb-jar.xml
デプロイメント記述子で指定します。
親トピック: ejb-ql-query
enable-batch-operations
値の範囲: True | False
デフォルト値: True
親要素:
weblogic-rdbms-jar
機能
WebLogic Server 8.1で導入されたこの要素は、EJBコンテナがデータベースのバッチ処理を許可するのかどうかを管理します(バッチ挿入、バッチ更新、およびバッチ削除を含む)。
この要素をTrue
に設定すると、EJBはトランザクション中のデータベース処理をコミット時間まで遅延させます。
親トピック: enable-batch-operations
例
次のXMLサンプルでは、enable-batch-operations
要素の使い方を示します。
<enable-batch-operations>True</enable-batch-operations>
親トピック: enable-batch-operations
enable-query-caching
値の範囲: True | False
デフォルト値: True
親要素:
weblogic-rdbms-jar weblogic-rdbms-bean weblogic-query
または
weblogic-rdbms-jar weblogic-rdbms-relation
機能
WebLogic Server 9.0で導入された要素で、読取り専用エンティティEJBを問合せレベルでキャッシュするかどうかを指定します。読取り専用エンティティEJBを問合せレベルでキャッシュすると、パフォーマンスが向上します。これは、ファインダがキャッシュ内のEJBにアクセスできるようになり、データベースへのアクセスを回避できるからです。この値をTrue
に設定した場合、アプリケーションまたはBeanレベルでキャッシュされる問合せの最大数を指定できます。キャッシュされる問合せの最大数を指定するには、weblogic-ejb-jar.xml
デプロイメント記述子のmax-queries-in-cache
を設定します。詳細については、「max-queries-in-cache」を参照してください
親トピック: enable-query-caching
例
次のXMLサンプルでは、enable-query-caching
要素の使い方を示します。
<enable-query-caching>True</enable-query-caching>
親トピック: enable-query-caching
field-group
値の範囲:なし
デフォルト値: field-group
が指定されていないファインダと関係に対して、default
という特殊なグループを使用します。デフォルト・グループには、Beanのcmp-fieldがすべて含まれますが、cmr-fieldは含まれません。
親要素:
weblogic-rdbms-relation
機能
field-group
要素は、Beanのcmp-field
とcmr-field
のサブセットを表します。Bean内の関連フィールドを、フォルトのあったグループに1つのユニットとしてまとめることができます。グループをファインダまたは関係に関連付けることができます。それによって、ファインダを実行するか、または関係に従った結果としてBeanがロードされたときに、グループ内の指定フィールドのみがロードされます。
フィールドは複数のグループに関連付けられている場合があります。この場合、フィールドに対してgetXXX
メソッドを実行すると、そのフィールドを含む最初のグループで障害が発生します。
親トピック: field-group
例
field-group
要素には、以下の要素を指定できます。
<weblogic-rdbms-bean> <ejb-name>XXXBean</ejb-name> <field-group> <group-name>medical-data</group-name> <cmp-field>insurance</cmp-field> <cmr-field>doctors</cmr-fields> </field-group> </weblogic-rdbms-bean>
親トピック: field-group
field-map
値の範囲:なし
デフォルト値:なし
親要素:
weblogic-rdbms-bean
機能
field-map
要素は、データベースの特定の列とBeanインスタンスのcmp-field
の間のマッピングを表します。
任意指定のgroup-name
要素は、cmp-field
のgetXXX
メソッドが呼び出され、値がメモリーにないために、EJBコンテナがDBMSから値を読み込む必要がある場合にロードされるフィールド・グループを指定します。group-name
を省略すると、cmp-field
がどのフィールド・グループでも明示的にリストされていない場合はデフォルト・グループ(すべてのcmp-field
が含まれている)が使用されます。明示的にリストされている場合には、cmp-field
のあるフィールド・グループが選択されます。したがって、cmp-field
が複数のフィールド・グループでリストされている場合、またはコンテナがグループのいずれかを任意に選択する場合、開発者はgroup-name
を指定する必要があります。
dbms-column-type
要素は任意で指定します。
親トピック: field-map
例
field-map
要素には、以下の要素を指定できます。
<field-map> <cmp-field>....</cmp-field> <dbms-column>...</dbms-column> <dbms-column-type>...</dbms-column-type> <group-name>...</group name> </field-map>
親トピック: field-map
finders-return-nulls
値の範囲: True | False
デフォルト値:なし
親要素:
weblogic-rdbms-jar compatibility weblogic-query
機能
この要素は、WebLogic Server 9.0で導入された互換性フラグです。ファインダが結果としてNULLを返すことができるかどうかを指定します。
デフォルト
親トピック: finders-return-nulls
例
<compatibility>
<finders-return-nulls>True</finders-return-value>
</compatibility>
親トピック: finders-return-nulls
foreign-key-table
値の範囲:有効なデータベース表名
デフォルト値:なし
親要素:
weblogic-rdbms-jar weblogic-rdbms-relation weblogic-relationship-role relationship-role-map
generator-name
値の範囲:
デフォルト値:
親要素:
weblogic-rdbms-bean automatic-key-generation
機能
generator-name
要素は、主キー・ジェネレータの名前を指定する場合に使用します。
-
generator-type
要素がOracle
で、WebLogic Serverが開発モードで動作している場合、EJBコンテナは自動SEQUENCE生成機能の過程でgenerator-name
に「_WL」を追加してそのOracleデータベースのSEQUENCEの名前を作成します。OracleデータベースのSEQUENCEの自動生成の詳細については、「OracleデータベースのSEQUENCEのサポート」を参照してください
-
generator-type
要素がOracle
で、WebLogic Serverがプロダクション・モードで動作している場合、EJBコンテナはOracleデータベースのSEQUENCEの名前をgenerator-name
の値に設定します。 -
generator-type
要素がNamedSequenceTable
の場合、generator-name
要素は使用されるSEQUENCE_TABLE
の名前になります。
親トピック: generator-name
generator-type
値の範囲: Identity | Sequence | SequenceTable
デフォルト値:
親要素:
weblogic-rdbms-bean automatic-key-generation
機能
generator-type
要素は、使用する主キー生成方法を指定します。
ノート:
automatic-key-generationを使用する際は、database-type要素を設定する必要があります。
また、generator-type
はOracleデータベースのSEQUENCEの自動生成でも使用します。「OracleデータベースのSEQUENCEのサポート」を参照してください
各generator-type
に対しては、次のデータベースがサポートされています。
-
Identity
: Oracleデータベースはサポートされません。 -
Sequence
: Oracle、DB2、およびInformix (バージョン9.2以降)データベースがサポートされます。 -
SequenceTable
: すべてのデータベースがサポートされます。
親トピック: generator-type
group-name
値の範囲:なし
デフォルト値:
field-group
および
caching-element
および
weblogic-query
および
field-map
および
weblogic-relationship-role
親要素:
weblogic-rdbms-relation field-group
include-updates
値の範囲: True | False
デフォルト値: オプティミスティック同時実行性を使用するBeanではFalse
他の同時実行性を使用するBeanではTrue
親要素:
weblogic-rdbms-bean weblogic-query
機能
現在のトランザクション中の更新を必ず問合せの結果に反映するかどうかを指定します。この要素をTrue
に設定した場合、コンテナは現在のトランザクションによる変更をすべてディスクにフラッシュしてから問合せを実行します。値をFalse
にすると、最高のパフォーマンスが得られます。
親トピック: include-updates
例
<weblogic-query> <query-method> <method-name>findBigAccounts</method-name> <method-params> <method-param>double</method-param> </method-params> </query-method> <ejb-ql-query> <weblogic-ql>WHERE BALANCE>10000 ORDER BY NAME</weblogic-ql> </ejb-ql-query> <include-updates>True</include-updates> </weblogic-query>
親トピック: include-updates
instance-lock-order
値の範囲: AccessOrder | ValueOrder
デフォルト値: AccessOrder
親要素:
weblogic-rdbms-bean
機能
特定EJBのインスタンスのロックまたは処理順序を指定します。この要素は、この要素を使用しなければデッドロックが起こるアプリケーションでデッドロックを防止するために使用できます。instance-lock-order
は、同じEJBの複数のインスタンスに適用されるデータベース操作(更新など)がコンテナによって実行される場合に常に使用します。この要素は、Beanインスタンスでデータベース・ロックを取得させる操作の順序を指定します。
たとえば、instance-lock-order
を使用すると、データベース同時実行性を使用する特定のEJBインスタンスでEJBコンテナがejbStore
を呼び出す順序を指定できます。ejbStore
は、データベースが更新されるときに排他的ロックを取得できます。instance-lock-order
は、オプティミスティック同時実行性を使用するBeanがオプティミスティック・チェックの実行時にロックされる順序も制御します。
-
AccessOrder
- コンテナは、トランザクションの過程でアプリケーションがBeanにアクセスした順序でロックが取得(またはアップグレード)されるようにBeanを処理します。これは、システムのすべてのトランザクションがBeanのインスタンス(最終的にはデータベース表の行)に同じ順序でアクセスする場合の推奨値です。 -
ValueOrder
- Beanは、主キーの値に基づく順序で処理されます。複数の同時トランザクションが異なる順序で同じEJBのインスタンスにアクセスする場合のデッドロックを防止するために、ValueOrder
を指定する必要があります。ノート:
ValueOrder
が指定されている場合、EJBの主キー・クラスはjava.lang.Comparable
インタフェースを実装する必要がありません(ただし、全体的な順序付けになります)。主キーがjava.lang.Comparable
を実装しない場合、Beanは主キーのハッシュ・コード値を使用して部分的に順序付けされます。
親トピック: instance-lock-order
key-cache-size
値の範囲:
デフォルト値: 1
親要素:
weblogic-rdbms-bean automatic-key-generation
機能
自動主キー生成機能で利用可能な主キー・キャッシュのサイズをオプションとして指定します。また、EJBコンテナは自動SEQUENCE生成が有効なときにはこの値を使用してOracleデータベースのSEQUENCEのインクリメント値を計算します。「OracleデータベースのSEQUENCEのサポート」を参照してください
generator-type
の値が、
-
Oracle
である場合、key-cache-size
はOracleデータベースのSEQUENCE INCREMENT値と一致していなければなりません。この値とOracleデータベースのSEQUENCE INCREMENT値が一致していない場合は、キー重複の問題が起こります。 -
NamedSequenceTable
である場合、key-cache-size
は1回のDBMS呼出しでコンテナが取得するキーの数を指定します。 -
SQLServerである場合、
key-cache-size
は無視されます。
親トピック: key-cache-size
lock-order
値の範囲:すべての正の整数
デフォルト値: 0
親要素:
weblogic-rdbms-bean
機能
このフラグを使用すると、トランザクションに複数のBeanおよび排他的同時実行性が関与する場合に、エンティティBeanのデータベース・ロックの順番を指定できます。最も小さい数値を付けられたBeanが最初にロックされます。
このフラグは、デッドロック状況を回避するためのみに使用します。現時点では、トランザクションがカスケード削除を実行する場合にのみ適用されます。
親トピック: lock-order
例
lock-order
要素の例は次のとおりです。
<lock-order>1</lock-order> <!ELEMENT lock-order (PCDATA)>
親トピック: lock-order
max-elements
値の範囲:なし
デフォルト値:なし
親要素:
weblogic-rdbms-bean weblogic-query
例
max-elements
要素の例は次のとおりです。
<max-elements>100</max-elements> <!ELEMENT max-element (PCDATA)>
親トピック: max-elements
method-name
値の範囲:なし
デフォルト値:なし
親要素:
weblogic-rdbms-bean query-method
機能
method-name
要素は、ファインダ・メソッドまたはejbSelect
メソッドの名前を指定します。
ノート:
「*」文字はワイルドカードとして使用できません。
親トピック: method-name
optimistic-column
値の範囲:有効なデータベース列名
デフォルト値:なし
親要素:
weblogic-rdbms-bean table-map
機能
optimistic-column
要素は、オプティミスティック同時実行性を実装するためのバージョン値またはタイムスタンプ値を格納するデータベース列を示します。オプティミスティック同時実行性の詳細については、「同時実行性ストラテジの選択」を参照してください
ノート:
すべてのデータベースで大文字と小文字が区別されるわけではありませんが、この要素では、大文字と小文字を区別します。
親トピック: optimistic-column
例
次のXML例では、optimistic-column
要素の使い方を示します。
<optimistic-column>ROW_VERSION</optimistic-column>
ROW_VERSION
は、同時実行性のチェックに使用する値が格納されるデータベース列の名前です。
親トピック: optimistic-column
order-database-operations
値の範囲: True | False
デフォルト値: True
親要素:
weblogic-rdbms-jar
機能
WebLogic Server 8.1で導入されたこの要素は、EJBコンテナが、トランザクション内のすべてのデータベース処理をコミット時間まで遅延し、処理間でのデータベースの依存関係を自動的にソートし、これらの処理を、一切のデータベース制約エラーが生じない方式でデータベースに送るかどうかを決定します。
enable-batch-operations
がTrue
の場合、コンテナは自動的にorder-database-operations
をTrue
に設定します。order-database-operations
を無効にするには、order-database-operations
とenable-batch-operations
の両方をFalse
に設定します。
「ejb-ql-query」
と「delay-database-insert-until」
も参照してください。
親トピック: order-database-operations
primary-key-table
値の範囲:有効なデータベース表名
デフォルト値:なし
親要素:
weblogic-rdbms-jar weblogic-rdbms-relation weblogic-relationship-role relationship-role-map
機能
primary-key-table
要素は、主キーを格納するDBMS表名を指定します。主キーの詳細については、「主キーの使用」を参照してください
ノート:
すべてのデータベースで大文字と小文字が区別されるわけではありませんが、この要素では、大文字と小文字を区別します。
親トピック: primary-key-table
relation-name
値の範囲:関連するejb-jar.xml
デプロイメント記述子ファイルで定義したejb-relation
のejb-relation-name
に一致する必要があります。ejb-relation-name
は省略可能ですが、関連するejb-jar.xml
デプロイメント記述子ファイルで定義したejb-relationごとに必要になります。
デフォルト値:なし
親要素:
weblogic-rdbms-relation
機能
relation-name
要素は関係の名前を指定します。
コンテナ管理による関係の詳細は、「コンテナ管理による関係(CMR)の使用」を参照してください。
親トピック: relation-name
例
relationship-name
要素の例は次のとおりです。
<weblogic-rdbms-jar> <weblogic-rdbms-relation> <relation-name>stocks-holders</relation-name> <table-name>stocks</table-name> </weblogic-rdbms-relation> </weblogic-rdbms-jar>
親トピック: relation-name
relationship-caching
値の範囲:なし
デフォルト値:なし
親要素:
weblogic-rdbms-jar weblogic-rdbms-bean
機能
relationship-caching
要素では、リレーションシップ・キャッシングを指定します。リレーションシップ・キャッシングについては、「リレーションシップ・キャッシング」を参照してください
親トピック: relationship-caching
例
relationship-caching
要素には、以下の要素を指定できます。
<relationship-caching> <caching-name>cacheMoreBeans</caching-name> <caching-element> <cmr-field>accounts<</cmr-field> <group-name>acct_group</group-name> <caching-element> <cmr-field>address</cmr-field> <group-name>addr_group</group-name> </caching-element> </caching-element> <caching-element> <cmr-field>phone</cmr-field> <group-name>phone_group</group-name> </caching-element> </relationship-caching>
親トピック: relationship-caching
relationship-role-map
値の範囲:なし
デフォルト値:なし
親要素:
weblogic-rdbms-relation weblogic-relationship-role
機能
relationship-role-map
要素は、ある関係に加わっているBeanのキー列マッピングに対する外部キー列を指定します。
関係の中で呼び出されるCMP Beanは、複数のDBMS表にマップできます(詳細については、table-map
要素を参照)。1対1または1対多の関係の外部キー側のBeanが複数の表にマップされている場合は、外部キー列が含まれる表の名前をforeign-key-table
要素で指定する必要があります。
逆に、1対1または1対多の関係の主キー側のBeanまたは多対多の関係に参加しているBeanが複数の表にマップされている場合は、主キーが含まれる表の名前をprimary-key-table
要素で指定する必要があります。
関係のどちら側のBeanも複数の表にマップされていない場合、foreign-key-table
要素とprimary-key-table
要素は省略可能です(使用される表が暗黙的であるため)。
コンテナ管理による関係の詳細は、「コンテナ管理による関係(CMR)の使用」を参照してください。
親トピック: relationship-role-map
関係の外部キー側のBeanの複数表へのマッピング
1対1の関係の外部キー側のBean (Fk_Bean
)は、複数の表にマップされます。外部キー列を持つ表は、foreign-key-table
要素で指定する必要があります。
Fk_Bean
は、2つの表Fk_BeanTable_1
とFk_BeanTable_2
にマップされます。関係の外部キー列は、表Fk_BeanTable_2
にあります。外部キー列の名前は、Fk_column_1
とFk_column_2
です。主キー側のBean (Pk_Bean
)は、主キー列Pk_table_pkColumn_1
とPk_table_pkColumn_2
を持つ1つの表にマップされています。
<relationship-role-map <foreign-key-table>Fk_BeanTable_2</foreign-key-table> <column-map> <foreign-key-column>Fk_column_1</foreign-key-column> <key-column>Pk_table_pkColumn_1</key-column> </column-map> <column-map> <foreign-key-column>Fk_column_2</foreign-key-column> <key-column>Pk_table_pkColumn_2</key-column> </column-map> </relationship-role-map>
外部キー列のある表をコンテナが確認できるように、foreign-key-table
要素は必ず指定します。
親トピック: relationship-role-map
関係の主キー側のBeanの複数表へのマッピング
1対1の関係の主キー側のBean (Pk_bean
)は複数の表にマップされますが、その関係の外部キー側のBean (Fk_Bean
)は1つの表Fk_BeanTable
にマップされます。外部キー列の名前は、Fk_column_1
とFk_column_2
です。
Pk_bean
は、以下の表にマップされます。
-
Pk_BeanTable_1
。主キー列は、Pk_table1_pkColumn_1
とPk_table1_pkColumn_2
。 -
Pk_BeanTable_2
。主キー列は、Pk_table2_pkColumn_1
とPk_table2_pkColumn_2
。
<relationship-role-map> <primary-key-table>Pk_BeanTable_1</primary-key-table> <column-map> <foreign-key-column>Fk_column_1</foreign-key-column> <key-column>Pk_table1_pkColumn_1</key-column> </column-map> <column-map> <foreign-key-column>Fk_column_2</foreign-key-column> <key-column>Pk_table1_pkColumn_2</key-column> </column-map> </relationship-role-map>
親トピック: relationship-role-map
relationship-role-name
値の範囲:関連するejb-jar.xml
で定義したejb-relationship-role
のejb-relationship-role-name
に一致する必要があります。
デフォルト値:なし
親要素:
weblogic-rdbms-relation weblogic-relationship-role
機能
relationship-role-name
要素は関係のロール名を指定します。
コンテナ管理による関係の詳細は、「コンテナ管理による関係(CMR)の使用」を参照してください。
親トピック: relationship-role-name
serialize-byte-array-to-oracle-blob
値の範囲: True | False
デフォルト値: False
親要素:
weblogic-rdbms-jar compatibility
機能
WebLogic Server 8.1 SP02で導入されたこの要素は、互換性フラグです。この要素では、Oracleデータベース内のBlobにマップされたbyte[]
型のcmp-field
をシリアライズするかどうかを指定します。デフォルトでは、このフラグの値はfalse
です。つまり、コンテナはbyte[]
を直接保持し、シリアライズしません。
WebLogic Server 8.1 SP02より前のバージョンでは、デフォルトによって、Oracleデータベース内のBlobにマップされたbyte[]
型のcmp-field
はシリアライズされました。旧式の動作に戻るには、erialize-byte-array-to-oracle-blob
の値をtrueに設定します。
serialize-char-array-to-bytes
値の範囲:True
| False
デフォルト値: False
親要素:
weblogic-rdbms-jar compatibility
機能
この要素は、WebLogic Server 9.0で導入された互換性フラグです。この要素では、char[]
型のcmp-field
をシリアライズするかどうかを指定します。デフォルトでは、このフラグの値はFalse
です。つまり、EJBコンテナはchar[]
を直接保持し、シリアライズしません。char[]
をシリアライズするには、この値をTrue
に設定します。
sql
値の範囲:有効なSQL
デフォルト値:なし
要件: データベース固有のSQLを使用するには、その対象となるデータベースをdatabase-type要素で指定する必要がある
親要素:
weblogic-rdbms-bean weblogic-query sql-query
および
weblogic-rdbms-bean weblogic-query sql-query database-specific-query
機能
sql
要素には、標準またはデータベース固有のSQL問合せを指定します。EJB-QL言語の標準機能だけを使用する問合せは、ejb-jar.xml
デプロイメント記述子に指定しなければなりません。標準SQL、データベース固有のSQL、またはEJB-QLのWebLogic拡張を使用する問合せは、weblogic-cmp-jar.xml
デプロイメント記述子に指定します。
親トピック: sql
例
... <weblogic-rdbms-bean> <weblogic-query> <sql-query> <sql>SELECT date_prescribed, dosage, drug, id, frequency, instructions, pat_id, issuing_phys_id, record_id, refills_remaining FROM medrecappPrescription WHERE testid = ?1</sql> </sql-query> </weblogic-query> ... </weblogic-rdbms-bean>
親トピック: sql
sql-query
値の範囲:
デフォルト値:なし
要件:データベース固有のSQLを使用するには、その対象となるデータベースをdatabase-type
で指定する必要がある
親要素:
weblogic-rdbms-bean weblogic-query
機能
sql-query
要素では、標準およびデータベース固有のSQL問合せを指定できます。EJB-QLのWebLogicの拡張機能を使用しないEJB-QL問合せは、ejb-jar.xml
デプロイメント記述子に指定する必要があります。
WebLogic Server 9.0より前のリリースではEJB-QL問合せ(WebLogic拡張あり、なし)だけがサポートされていましたが、このリリースではSQL問合せ、EJB-QL問合せ(WebLogic拡張あり、なし)、またはこの2つの組み合わせがサポートされています。
親トピック: sql-query
例
<sql-query> <sql-shape-name>...</sql-shape-name> <sql>...</sql> <database-specific-sql>...</database-specific-sql> <database-type>...</database-type> <sql>...</sql> <unknown-primary-key-field>...</unknown-primary-key-field> <cmp-field>...</cmp-field> </sql-query>
親トピック: sql-query
sql-select-distinct
値の範囲: True | False
デフォルト値: False
親要素:
weblogic-query
ノート:
このリリースのWebLogic Serverでは、この要素は非推奨です。同じ機能を得るには、ファインダ問合せでSELECT DISTINCT
句を直接使用してください。
機能
sql-select-distinct
要素は、生成されるSQL SELECT文にDISTINCT修飾子が含まれるかどうかを指定します。DISTINCT修飾子を使用すると、データベースからユニークな行が返されます。
Oracleデータベースでは、FOR UPDATE
句をSELECT DISTINCT
と一緒に使用することはできません。したがって、呼出しチェーンのBeanにisolation-level
がTransactionReadCommittedForUpdate
のメソッドがある場合は、sql-select-distinct
要素を使用できません。transaction-isolation
要素はweblogic-ejb-jar.xml
で指定します。
親トピック: sql-select-distinct
sql-shape
値の範囲:
デフォルト値:
親要素:
weblogic-rdbms-jar weblogic-rdbms-bean sql-query
機能
sql-shape
要素では、SQL問合せによって返されるデータを指定します。この情報は常にデータベース側で提供されるわけではないので、sql-shapeの指定が必要になります。通常、sql-shape要素では返されるデータベースの表と列を指定します。より複雑な問合せの場合、sql-shapeでは、データベースによって返されるデータに存在する関係と、渡される必要がある(マップされてはならない)集合列が存在するかどうかも指定します。
親トピック: sql-shape
例
sql-shape description sql-shape-name table pass-through-columns ejb-relation-name
親トピック: sql-shape
sql-shape-name
値の範囲:なし
デフォルト値:なし
親要素:
weblogic-rdbms-jar weblogic-rdbms-bean weblogic-query sql-query sql-shape
機能
sql-shape-name
要素を使用すると、sql-shape
を複数の問合せに関連付けることができます。同じsql-shape
を使用する問合せが複数存在する場合、その形式をいったん定義すれば、sql-shape-name
を参照することによって何度でも使用できます。
親トピック: sql-shape-name
table-map
値の範囲:なし
デフォルト値:なし
要件:各table-map
要素に、そのBeanの主キー・フィールドのマッピングが含まれる必要があります。
親要素:
weblogic-rdbms-bean
機能
CMP Beanは、1つまたは複数のDBMS表にマップできます。table-map
要素は、Beanのcmp-field
と、表にマップされたすべてのcmp-field
の表列の間のマッピングを指定します。CMP Beanを複数のDBMS表にマップする場合は、表ごとにtable-map
要素を指定する必要があります。
1つのCMP Beanを複数の表にマップする場合、各表には、1つの特定のBeanインスタンスにマップする1行が含まれます。そのため、すべての表にはどの時点でも同数の行が含まれます。また、各表には均一の主キーの値の並びが含まれます。したがって、各表には均一の主キー列が含まれ、別々の表の対応している主キー列どうしは名前は違うとしても同じタイプでなければなりません。
table-map
要素は、特定表の主キー列から、Beanの主キー列フィールドへのマッピングを指定しなければなりません。主キー以外のフィールドは1つの表にマップできるのみです。
verify-rows
、verify-columns
、およびoptimistic-column
要素の使い方については、「オプティミスティック同時実行性でのデータ有効性のチェック」を参照してください
親トピック: table-map
例
table-map
要素には、以下の要素を指定できます。
<table-map> <table-name>DeptTable</table-name> <field-map> <cmp-field>deptId1</cmp-field> <dbms-column>t1_deptId1_column</dbms-column> </field-map> <field-map> <cmp-field>deptId2</cmp-field> <dbms-column>t1_deptId2_column</dbms-column> </field-map> <field-map> <cmp-field>location</cmp-field> <dbms-column>location_column</dbms-column> </field-map> <cmp-field>budget</cmp-field> <dbms-column>budget</dbms-column> </field-map> <verify-rows>Read</verify-rows> <verify-columns>Version</verify-columns> <optimistic-column>ROW_VERSION</optimistic-column> <trigger-updates-optimistic-column>False </trigger-updates-optimistic-column> <version-column-initial-value>0</version-column-initial-value> </table-map>
親トピック: table-map
table-name
値の範囲:データベース内にあるソース表の有効な完全修飾SQL名
デフォルト値:
要件: table-name
を必ず設定する必要があります。
親要素:
weblogic-rdbms-bean weblogic-rdbms-relation
機能
表の完全修飾SQL名です。このBeanのdata-source
用に定義したユーザーには、指定した表の読取りおよび書込み権限が必要ですが、スキーマ変更権限は必要ありません。
親トピック: table-name
例
<weblogic-rdbms-jar> <weblogic-rdbms-bean> <ejb-name>containerManaged</ejb-name> <data-source-jndi-name>examples-dataSource-demoPool</data-source-jndi-name> <table-name>ejbAccounts</table-name> </weblogic-rdbms-bean> </weblogic-rdbms-jar>
親トピック: table-name
trigger-updates-optimistic-column
値の範囲:True
| False
デフォルト値: False
親要素:
weblogic-rdbms-bean table-map
機能
WebLogic Server 9.0で導入されたtrigger-updates-optimistic-column
要素は、同時実行性のチェックに使用されるoptimistic-column
で指定されたデータベース列値をEJBコンテナが自動更新するかどうかを指定します。trigger-updates-optimistic-column
のデフォルト値はFalse
で、EJBコンテナはJDBCにSQL UPDATE
文を送信するときにoptimistic-column
で指定されたデータベース列を自動更新します。データベース行の更新時にデータベース・トリガーを使用してバージョン値を更新する従来のアプリケーションが存在し、EJBコンテナによってバージョン値が自動更新されないようにする場合、この要素の値をTrue
に設定します。
ノート:
trigger-updates-optimistic-columnをTrueに設定した場合、Beanの作成時にデータベース・トリガーによってデータベース内のバージョン列が初期化されるようにしておく必要があります。
unknown-primary-key-field
値の範囲:有効なデータ型
デフォルト値:なし
親要素:
weblogic-rdbms-bean
機能
unknown-primary-key-field
要素では、主キーがejb-jar.xml
記述子で指定されていない場合に主キーとして使用されるcmpフィールドを指定できます。指定した主キー・フィールドは、field-map
要素でデータベース列にマップしなければなりません。指定した主キー・フィールドがejb-jar.xml
記述子でcmpフィールドとして宣言されなかった場合、自動キー生成を有効にしなければならず、主キー・タイプはjava.lang.Long
になります。
親トピック: unknown-primary-key-field
use-select-for-update
値の範囲: True | False
デフォルト値: False
親要素:
weblogic-rdbms-bean
機能
Bean単位でペシミスティック同時実行性を強制します。True
を指定すると、Beanがデータベースからロードされるときは常にSELECT ... FOR UPDATE
が使用されます。TransactionReadCommittedForUpdate
のトランザクション・アイソレーション・レベルとの相違点は、これがトランザクション・レベルではなく、Beanレベルで設定されるということです。
ノート:
Sybase JConnectドライバでペシミスティックなロック方式(HOLDLOCK
など)を使用している場合、問合せにFOR UPDATE
句が含まれている場合にカーソルが生成されるように、SELECT_OPENS_CURSOR=true
を指定する必要があります。
親トピック: use-select-for-update
例
<weblogic-rdbms.jar> <weblogic-rdbms-bean> <ejb-name>containerManaged</ejb-name> <use-select-for-update>True</use-select-for-update> /weblogic-rdbms-bean> </weblogic-rdbms-jar>
親トピック: use-select-for-update
validate-db-schema-with
値の範囲: MetaData | TableQuery
デフォルト値: TableQuery
親要素:
weblogic-rdbms-jar
機能
validate-db-schema-with
要素を指定すると、デプロイメント時にBeanが有効なデータベース・スキーマにマップされているかどうかをコンテナ管理による永続性でチェックします。
MetaData
を指定すると、WebLogic Serverは、JDBCメタデータを使用してスキーマを検証します。
TableQuery
(デフォルト設定)を指定すると、WebLogic Serverは、表を直接問合せし、CMP実行時によって予期されているスキーマが表にあるかどうかを確認します。
親トピック: validate-db-schema-with
例
validate-db-schema-with
要素の例は次のとおりです。
<validate-db-schema-with>TableQuery</validate-db-schema-with>
親トピック: validate-db-schema-with
verify-columns
値の範囲: Read | Modified | Version | Timestamp
デフォルト値: none
要件: table-name
を必ず設定する必要があります。
親要素:
weblogic-rdbms-bean table-map
機能
verify-columns
要素は、Optimistic
同時実行性ストラテジを使用したときに、WebLogic Serverに有効性をチェックさせたい表列を指定します。WebLogic Serverは、トランザクションの終了時、データベースにコミットする前に列をチェックし、他のどのトランザクションもそのデータを変更していないことを確かめます。
詳細については、「同時実行性ストラテジの選択」を参照してください。
親トピック: verify-columns
verify-rows
値の範囲: Read | Modified
デフォルト値: Modified
要件: table-name
を必ず設定する必要があります。
親要素:
weblogic-rdbms-bean table-map
機能
verify-rows
要素は、オプティミスティック同時実行性の使用時にEJBコンテナがチェックすべきである、表内の行を指定します。
-
Modified
— トランザクションで更新または削除された行のみがチェックされます。この値にすると、2つのトランザクションが同時に同じ行を更新することがなく、更新が損失することはありませんが、異なるトランザクションで読込みと更新を交互に行うことは可能です。その結果、得られる一貫性のレベルは、ANSIのREAD_COMMITTED
レベルとREPEATABLE_READ
レベルの間になります。 -
Read
- トランザクションが読み取るすべての行がチェックされるべきであることを指定します。これには、単に読み込まれるだけの行と、読み込まれた後でトランザクションによって更新または削除される行の両方が含まれます。Read
オプションを指定すると、一般に、EJBコンテナが実行しなくてはならないオプティミスティック・チェックの回数が増えるため、付加的なオーバーヘッドが生じます。Read
オプションを指定すると、コミットされたトランザクションは、トランザクションのコミット後まで別のトランザクションによって修正されないことが確認されている一連の行を読み込みます。この結果、SERIALIZABLE
の一貫性のANSI定義と非常に近い、高度な一貫性が得られます。ノート:
verify-rows
がRead
に設定されていると、verify-columns
要素ではModified
の値を指定できません。この組み合わせでは、修正された行だけがEJBコンテナによってチェックされることになるためです。
詳細については、「同時実行性ストラテジの選択」を参照してください。
親トピック: verify-rows
version-column-initial-value
値の範囲: 0
または任意の正の整数
デフォルト値:なし
親要素:
weblogic-rdbms-bean table-map
機能
WebLogic Server 9.0で導入されたversion-column-initial-value
要素では、オプティミスティック同時実行性を実装するために使用されるバージョン列の初期値を指定します。バージョン列は、optimistic-column
要素で指定するデータベース列です。詳細については、「optimistic-column」を参照してください
親トピック: version-column-initial-value
weblogic-ql
値の範囲:
デフォルト値:
親要素:
weblogic-rdbms-bean weblogic-query
機能
weblogic-ql
要素は、EJB-QLに対するWebLogic固有の拡張機能を含む問合せを指定します。ejb-jar.xml
デプロイメント記述子では、EJB-QL言語の標準機能だけを使用する問合せを指定しなければなりません。
親トピック: weblogic-ql
weblogic-query
値の範囲:なし
デフォルト値:なし
親要素:
weblogic-rdbms-bean
機能
weblogic-query
要素では、標準またはデータベース固有のSQL問合せ、またはEJB-QLのWebLogic固有の拡張機能を使用する問合せを指定できます。SQLまたはEJB-QLのWebLogic拡張機能を使用しない問合せは、ejb-jar.xml
デプロイメント記述子で指定する必要があります。
問合せによってあらかじめキャッシュにロードしておく必要があるエンティティBeanを問合せで取得する場合は、weblogic-query
要素を使用して、field-group
を問合せに関連付けます。
親トピック: weblogic-query
例
weblogic-query
要素には、以下の要素を指定できます。
<weblogic-query> <description>...</description> <query-method> <method-name>findBigAccounts</method-name> <method-params> <method-param>double</method-param> </method-params> </query-method> <ejb-ql-query> <weblogic-ql>WHERE BALANCE>10000 ORDER BY NAME </weblogic-ql> <group-name>...</group-name> <caching-name>...</caching-name> </ejb-ql-query> <sql-query> <sql-shape>...</sql-shape> <sql>SELECT date_prescribed, dosage, drug, id, frequency, instructions, pat_id, issuing_phys_id, record_id, refills_remaining FROM medrecappPrescription WHERE testid = ?1</sql> <database-specific-sql> <database-type>SQLServer</database-type> <sql>SELECT name, phone, location, testid FROM medrecappPharmacyBeanTable WHERE testid = ?1 AND SUBSTRING(testid, 1,5) = 'local' ORDER BY name</sql> </database-specific-sql> </sql-query> <max-elements>...</max-elements> <include-updates>...</include-updates> <sql-select-distinct>...</sql-select-distinct> </weblogic-query>
親トピック: weblogic-query
weblogic-rdbms-bean
値の範囲:なし
デフォルト値:なし
親要素:
weblogic-rdbms-jar
機能
weblogic-rdbms-bean
は、WebLogic RDBMS CMP永続性タイプによって管理されるエンティティBeanを指定します。
親トピック: weblogic-rdbms-bean
例
weblogic-rdbms-bean ejb-name data-source-jndi-name unkonown-primary-key-field table-map field-group relationship-caching weblogic-query dalay-database-insert-until automatic-key-generation check-exists-on-method
親トピック: weblogic-rdbms-bean
weblogic-rdbms-jar
ここでは、weblogic-rdbms-jar
要素について説明し、その例を示します。
機能
weblogic-rdbms-jar
要素は、WebLogic RDBMS CMPデプロイメント記述子の最上位の要素です。この要素には、1つまたは複数のエンティティBeanと、一連の関係(これについては省略可能)についてのデプロイメント情報が含まれます。
親トピック: weblogic-rdbms-jar
例
weblogic-rdbms-jar
のXML
構造を示します。
weblogic-rdbms-jar weblogic-rdbms-bean weblogic-rdbms-relation create-default-dbms-tables validate-db-schema-with database-type
親トピック: weblogic-rdbms-jar
weblogic-rdbms-relation
値の範囲:なし
デフォルト値:なし
親要素:
weblogic-rdbms-jar
機能
weblogic-rdbms-relation
要素は、WebLogic CMP永続性タイプによって管理されている1つの関係を表します。WebLogic Serverでは、以下の3種類の関係のマッピングをサポートしています。
-
1対1の関係では、一方のBeanの外部キーがもう一方のBeanの主キーにマップされます。
-
1対多の関係では、あるBeanの外部キーが別のBeanの主キーにマップされます。
-
多対多の関係には、結合表のマッピングが伴います。結合表の各行には、関係に関与するエンティティの主キーに対応する2つの外部キーが格納されます。
コンテナ管理による関係の詳細は、「コンテナ管理による関係(CMR)の使用」を参照してください。
親トピック: weblogic-rdbms-relation
1対1の関係の定義
例C-4と例C-5
に定義されているエンティティ間の1対1の関係を定義するweblogic-rdbms-bean要素を例C-6に示します。weblogic-rdbms-relation
要素は、weblogic-cmp-jar.xml
ファイルのweblogic-rdbms-bean
要素の後に存在します。
ノート:
NAME
は、Capital表の主キーの列名です。
<relationship-role-name>には、ejb-jar.xml
の<ejb-relationship-role
>要素の<cmr-field
>で指定された関連フィールドが入ります。
例C-4 Bean 1
<weblogic-rdbms-bean> <ejb-name>CountryEJB</ejb-name> <data-source-jndi-name>wlsd21-datasource</data-source-jndi-name> <table-map> <table-name>EXAMPLE07_COUNTRY</table-name> <field-map> <cmp-field>name</cmp-field> <dbms-column>NAME</dbms-column> </field-map> <field-map> <cmp-field>continent</cmp-field> <dbms-column>CONTINENT</dbms-column> </field-map> </table-map> </weblogic-rdbms-bean>
例C-5 Bean 2
<weblogic-rdbms-bean> <ejb-name>CapitalEJB</ejb-name> <data-source-jndi-name>wlsd21-datasource</data-source-jndi-name> <table-map> <table-name>EXAMPLE07_CAPITAL</table-name> <field-map> <cmp-field>CAPITAL_NAME</cmp-field> <dbms-column>NAME</dbms-column> </field-map> <field-map> <cmp-field>continent</cmp-field> <dbms-column>CONTINENT</dbms-column> </field-map> </table-map> </weblogic-rdbms-bean>
例C-6 1対1の関係の<weblogic-rdbms-relation>要素
<weblogic-rdbms-relation> <relation-name>CountryCapitalRel</relation-name> <weblogic-relationship-role> <relationship-role-name>CountryRole</relationship-role-name> <relationship-role-map> <column-map> <foreign-key-column>CAPITAL_NAME</foreign-key-column> <key-column>NAME</key-column> </column-map> </relationship-role-map> </weblogic-relationship-role> </weblogic-rdbms-relation>
親トピック: weblogic-rdbms-relation
1対多の関係の定義
例C-7は、1対多の関係を定義するサンプルの<weblogic-rdbms-relation>
要素を示しています。
ノート:
<relationship-role-name>には、ejb-jar.xml
の<ejb-relationship-role
>要素の<cmr-field
>で指定された関連フィールドが入ります。
<foreign-key-column>は、関係の「多」側の表の列を指定する必要があります。
例C-7 1対多の関係の<weblogic-rdbms-relation>要素
<weblogic-rdbms-relation> <relation-name>OwnerDogRel</relation-name> <weblogic-relationship-role> <relationship-role-name>DogRole</relationship-role-name> <relationship-role-map> <column-map> <foreign-key-column>OWNER_NAME</foreign-<key-column> <key-column>NAME</key-column> </column-map> <relationship-role-map> </weblogic-relationship-role> </weblogic-rdbms-relation>
親トピック: weblogic-rdbms-relation
多対多の関係の定義
WebLogic Serverの多対多の関係には、結合表の物理的なマッピングが伴います。結合表の各行には、関係に関与するエンティティの主キーに対応する2つの外部キーが格納されます。
次の例は、FRIENDS
BeanとEMPLOYEES
Beanの間の多対多の関係を示しています。
例C-8 多対多の関係の<weblogic-rdbms-relation>要素
<weblogic-rdbms-relation> <relation-name>friends</relation-name> <table-name>FRIENDS</table-name> <weblogic-relationship-role> <relationship-role-name>friend</relationship-role-name> <relationship-role-map> <column-map> <foreign-key-column>first-friend-id</foreign-key-column> <key-column>id</key-column> </column-map </relationship-role-map> </weblogic-relationship-role> <weblogic-relationship-role> <relationship-role-name>second-friend</relationship-role-name> <relationship-role-map> <column-map> <foreign-key-column>second-friend-id</foreign-key-column> <key-column>id</key-column> </column-map> </relationship-role-map> </weblogic-relationship-role> </weblogic-rdbms-relation>
例C-7で、FRIENDS
結合表にはfirst-friend-id
およびsecond-friend-id
という2つの列があります。各列には、別の従業員の友人である特定の従業員を示す外部キーが格納されます。EMPLOYEES
表の主キー列(key-column
)はid
です。この例では、EMPLOYEES
Beanが1つの表にマップされています。EMPLOYEES
Beanが複数の表にマップされている場合、主キー列(key-column
)を格納する表をrelationship-role-map
で指定する必要があります。詳細については、「relationship-role-map」を参照してください
親トピック: weblogic-rdbms-relation
weblogic-relationship-role
値の範囲:なし
デフォルト値:なし
親要素:
weblogic-rdbms-jar weblogic-rdbms-relation
機能
weblogic-relationship-role
要素は、ejb-jar.xml
で指定されたejb-relationship-role
の以下のDBMSスキーマ情報を指定します。
-
relationship-role-map
サブ要素は、関係の片側の外部キーと主キーのマッピングを指定します。1対1または1対多の関係の場合、関係の外部キー側のロールのみがマッピングを指定します。多対多の関係では、両方のロールがマッピングを指定します。詳細と例については、「relationship-role-map」を参照してください -
group-name
を使用すると、ロールに対応するBeanが関係を移動した(つまりcmrgetXXX
メソッドを呼び出した)結果としてロードされたときにロードされるfield-group
を示すことができます。 -
db-cascade-delete
タグを使用すると、カスケード削除が、基底DBMSの組込みカスケード削除機能を使用するように指定できます。詳細については、「db-cascade-delete」を参照してください
コンテナ管理による関係の詳細は、「コンテナ管理による関係(CMR)の使用」を参照してください。
親トピック: weblogic-relationship-role
例
<weblogic-relationship-role> <relationship-role-name>...</relationship-role-name> <group-name> ....</group-name> <relationship-role-map>... .... </relationship-role-map> <db-cascade-delete/> </weblogic-relationship-role>
親トピック: weblogic-relationship-role