第4章 JBoss Data Grid をサポートされるコンテナーと使用

Red Hat JBoss Data Grid は以下のランタイムで使用できます。
  • アプリケーションによって起動された Java SE。
  • スタンドアロン JBoss Data Grid サーバーとして。
  • アプリケーションのライブラリーとしてバンドルされ、アプリケーションサーバーへデプロイされ、アプリケーションによって起動 (たとえば、JBoss Data Grid は Tomcat または Weblogic と使用できます)。
  • OSGi ランタイム環境内 (この場合、Apache Karaf)。
Red Hat JBoss Data Grid でサポートされるコンテナーの一覧は、『リリースノート』または https://access.redhat.com/knowledge/articles/115883 のサポート情報を参照してください。

4.1. JBoss EAP での JBoss Data Grid のデプロイ (ライブラリーモード)

Red Hat JBoss Data Grid は Red Hat JBoss Enterprise Application Platform 6.x 用のモジュールを提供します。これらのモジュールを使用する場合は、JBoss Data Grid ライブラリーをユーザーのデプロイメントに含める必要がありません。JBoss EAP にすでに含まれている Infinispan モジュールとの競合を防ぐため、JBoss Data Grid モジュールは別のスロット内に置かれ、JBoss Data Grid のバージョン (major.minor) によって識別されます。

注記

JBoss EAP モジュールは JBoss EAP には含まれていません。http://access.redhat.com のカスタマーポータルに移動し、これらのモジュールを Red Hat JBoss Data Grid のダウンロードページからダウンロードします。
JBoss EAP で JBoss Data Grid をデプロイするには、以下の方法の 1 つを用いて JBoss Data Grid モジュールの依存関係をアプリケーションのクラスパス (JBoss EAP デプロイヤー) に追加します。
  • 依存関係を jboss-deployment-structure.xml ファイルに追加します。
  • 依存関係を MANIFEST.MF ファイルに追加します。
  • Maven より MANIFEST.MF ファイルを生成します。
jboss-deployment-structure.xml ファイルへ依存関係を追加

以下の設定を jboss-deployment-structure.xml ファイルに追加します。

<jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.2">
    <deployment>
        <dependencies>
            <module name="org.infinispan" slot="jdg-6.4" services="export"/>
        </dependencies>
    </deployment>
</jboss-deployment-structure>

注記

jboss-deployment-structure.xml ファイルの詳細は、Red Hat JBoss Enterprise Application Platform のドキュメントを参照してください。
MANIFEST.MF ファイルへ依存関係を追加

次のように依存関係を MANIFEST.MF ファイルに追加します。

例4.1 MANIFEST.MF ファイルの例

Manifest-Version: 1.0
Dependencies: org.infinispan:jdg-6.4 services
最初の行はこの例と同じになります。必要な依存関係に応じて、以下のいずれかをファイルの 2 行目に追加します。
  • JBoss Data Grid コア
    Dependencies: org.infinispan:jdg-6.4 services
  • 埋め込みクエリー
    Dependencies: org.infinispan:jdg-6.4 services, org.infinispan.query:jdg-6.4 services
  • JDBC キャッシュストア
    Dependencies: org.infinispan:jdg-6.4 services, org.infinispan.persistence.jdbc:jdg-6.4 services
  • JPA キャッシュストア
    Dependencies: org.infinispan:jdg-6.4 services, org.infinispan.persistence.jpa:jdg-6.4 services
  • LevelDB キャッシュストア
    Dependencies: org.infinispan:jdg-6.4 services, org.infinispan.persistence.leveldb:jdg-6.4 services
  • CDI
    Dependencies: org.infinispan:jdg-6.4 services, org.infinispan.cdi:jdg-6.4 meta-inf
    
Maven より MANIFEST.MF ファイルを生成

MANIFEST.MF ファイルはビルド中 (JAR または WAR プロセス中) に生成されます。MANIFEST.MF ファイルに依存関係を追加する代わりに、以下を pom.xml ファイルに追加し、Maven で直接依存関係を設定します。

<plugin>
	<artifactId>maven-war-plugin</artifactId>
	<version>2.4</version>
	<configuration>
		<failOnMissingWebXml>false</failOnMissingWebXml>
		<archive>
			<manifestEntries>
				<Dependencies>org.infinispan:jdg-6.4 services</Dependencies>
			</manifestEntries>
		</archive>
	</configuration>
</plugin>