Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

21.9.4. EJB 2.x のコンテナ管理による永続性の設定

EJB 2.x Container Managed Persistence(CMP)サブシステムを設定して、任意の数のキージェネレーターを指定できます。キージェネレーターは、CMP サービスが永続化する各エンティティーを識別する一意の鍵を生成するために使用されます。
UUID ベースのキージェネレーターと HiLo キージェネレーターの 2 つの種類のキージェネレーターを定義できます。
UUID ベースのキージェネレーター
UUID ベースのキージェネレーターは、Universally Unique Identifier を使用してキーを作成します。UUID キージェネレーターは、一意の名前のみを指定するだけで、他の設定はありません。
UUID ベースのキージェネレーターは、以下のコマンド構文を使用して CLI で追加できます。 
/subsystem=cmp/uuid-keygenerator=UNIQUE_NAME:add

例21.17 UUID キージェネレーターの追加

uuid_identities の名前で UUID ベースのキージェネレーターを追加するには、以下の CLI コマンドを使用します。 
/subsystem=cmp/uuid-keygenerator=uuid_identities:add
このコマンドで作成される XML 設定は以下のとおりです。 
<subsystem xmlns="urn:jboss:domain:cmp:1.0"> 
   <key-generators>
      <uuid name="uuid_identities" />
   </key-generators>
</subsystem>
HiLo キージェネレーター
HiLo キージェネレーターは、データベースを使用してエンティティー ID キーを作成および保存します。HiLo キージェネレーターは一意の名前を持ち、データの保存に使用するデータソースを指定するプロパティーと、キーを格納するテーブルおよび列の名前を設定する必要があります。
HiLo キージェネレーターは、以下のコマンド構文を使用して CLI で追加できます。 
/subsystem=cmp/hilo-keygenerator=UNIQUE_NAME/:add(property=value, property=value, ...)

例21.18 HiLo キージェネレーターの追加

/subsystem=cmp/hilo-keygenerator=HiLoKeyGeneratorFactory:add(create-table=true,create-table-ddl="create table HILOSEQUENCES (SEQUENCENAME varchar(50) not null, HIGHVALUES integer not null, constraint hilo_pk primary key (SEQUENCENAME))",data-source=java:jboss/datasources/ExampleDS, id-column=HIGHVALUES,sequence-column=SEQUENCENAME,table-name=HILOSEQUENCES,sequence-name=general,block-size=10)
このコマンドで作成される XML 設定は以下のとおりです。 
<subsystem xmlns="urn:jboss:domain:cmp:1.1">
     <key-generators>
         <hilo name="HiLoKeyGeneratorFactory">
             <block-size>10</block-size>
             <create-table>true</create-table>
             <create-table-ddl>create table HILOSEQUENCES (SEQUENCENAME varchar(50) not null, HIGHVALUES integer not null, constraint hilo_pk primary key (SEQUENCENAME))</create-table-ddl>
             <data-source>java:jboss/datasources/ExampleDS</data-source>
             <id-column>HIGHVALUES</id-column>
             <sequence-column>SEQUENCENAME</sequence-column>
             <sequence-name>general</sequence-name>
             <table-name>HILOSEQUENCES</table-name>
         </hilo>
     </key-generators>
 </subsystem>
注記
block-size を !=0 の値に設定しないと、生成された PKey がインクリメントされないため、DuplicateKeyException が発生し、エンティティーの作成に失敗します。
注記
一貫性を確保するために、クラスターの場合は select-hi-ddl を 'FOR UPDATE' として設定する必要があります。すべてのデータベースはロック機能をサポートしません。
バグの報告