cache.coordination.protocol

eclipselink.cache.coordination.protocolを使用して、使用するキャッシュ・コーディネーション・プロトコルを指定します。各ディスクリプタのキャッシュ構成に応じて、クラスタに対するキャッシュの更新または挿入がブロードキャストされ、各セッションのキャッシュが更新または無効化されます。

値

表5-12は、この永続性プロパティの値を説明しています。

表5-12 cache.coordination.protocolの有効値

Value	説明
`jms`	Java Message Service (JMS)を使用して、変更をブロードキャストします。
`jms-publishing`	使用予定のEJB MessageDrivenBeanを使用して、変更をブロードキャストします。MessageDrivenBeanを個別に構成する必要があります。
`rmi`	Java Remote Method Invocation (RMI)を使用して、変更をブロードキャストします。
`rmi-iiop`	RMI over Internet Inter-ORB Protocol (IIOP)を使用して、変更をブロードキャストします。
ClassName	`TransportManager`抽象クラスのサブクラス実装の名前。

使用方法

クラスタ内のすべての永続性ユニットおよびセッションについて、cache.coordination.protocolを指定する必要があります。

例

例5-6に、persistence.xmlファイルでJMSキャッシュ・コーディネーションを構成する方法を示します。

例5-6 persistence.xmlでのJMSキャッシュ・コーディネーションの構成

<property name="eclipselink.cache.coordination.protocol" value="jms" />
<property name="eclipselink.cache.coordination.jms.topic" value="jms/EmployeeTopic" />
<property name="eclipselink.cache.coordination.jms.factory" value="jms/EmployeeTopicConnectionFactory" />

アプリケーションをクラスタで実行中ではない場合、次のようにURLを指定する必要があります。

<property name="eclipselink.cache.coordination.jms.host" value="t3://myserver:7001/" />

また、必要に応じて、サーバーにアクセスするために(別のドメインを使用している場合など)、ユーザー名とパスワードを含めることもできます。

<property name="eclipselink.cache.coordination.jndi.user" value="weblogic" />
<property name="eclipselink.cache.coordination.jndi.password" value="welcome1" />

例5-7 persistence.xmlでのRMIキャッシュ・コーディネーションの構成

<property name="eclipselink.cache.coordination.protocol" value="rmi" />

アプリケーションをクラスタで実行中ではない場合、次のようにURLを指定する必要があります。

<property name="eclipselink.cache.coordination.rmi.url" value="t3://myserver:7001/" />

また、必要に応じて、サーバーにアクセスするために(別のドメインを使用している場合など)、ユーザー名とパスワードを含めることもできます。

<property name="eclipselink.cache.coordination.jndi.user" value="weblogic" />
<property name="eclipselink.cache.coordination.jndi.password" value="welcome1" />

デフォルトでは、RMIキャッシュ・コーディネーション・ブロードキャストは非同期です。このことは、必要に応じてオーバーライドできます。

<property name="eclipselink.cache.coordination.propagate-asynchronously" value="false" />

同じサーバーまたはネットワーク上に複数のアプリケーションがある場合、アプリケーションごとに個別のキャッシュ・コーディネーション・チャネルを指定できます。

<property name="eclipselink.cache.coordination.channel" value="EmployeeChannel" />

RMIキャッシュ・コーディネーションでは、サーバーが相互に検索できるようにマルチキャスト・ソケットを使用します。必要に応じて、次のようにマルチキャスト設定を構成できます。

<property name="eclipselink.cache.coordination.rmi.announcement-delay" value="1000" />
<property name="eclipselink.cache.coordination.rmi.multicast-group" value="239.192.0.0" />
<property name="eclipselink.cache.coordination.rmi.multicast-group.port" value="3121" />
<property name="eclipselink.cache.coordination.packet-time-to-live" value="2" />