ホーム
製品
Red Hat Data Grid
7.2
開発者ガイド
第32章 Infinispan CDI モジュール

第32章 Infinispan CDI モジュール

32.1. Infinispan CDI モジュール
リンクのコピー

Infinispan の infinispan-cdi モジュールには Context and Dependency Injection (CDI) が含まれています。 infinispan-cdi モジュールは以下を提供します。

Cache API を使用した設定およびインジェクション。
キャッシュリスナーと CDI イベントシステム間のブリッジ。
JCACHE をキャッシュするアノテーションの部分サポート。

32.2. Infinispan CDI の使用
リンクのコピー

32.2.1. Infinispan CDI の要件
リンクのコピー

以下は Infinispan CDI モジュールを Red Hat JBoss Data Grid と使用するための要件になります。

最新バージョンの infinispan-cdi モジュールを使用してください。
依存関係の情報を正しく設定してください。

32.2.2. CDI Maven 依存関係の設定
リンクのコピー

CDI モジュールは各デプロイメント型の Infinispan jar に含まれています。他に必要な依存関係はありません。

ライブラリーモード

ライブラリーモードでは、infinispan-embedded アーティファクトに CDI モジュールが含まれています。以下の例のように依存関係として追加する必要があります。

<dependency>
    <groupId>org.infinispan</groupId>
    <artifactId>infinispan-embedded</artifactId>
    <version>${infinispan.version}</version>
</dependency>

<dependency>
    <groupId>org.infinispan</groupId>
    <artifactId>infinispan-embedded</artifactId>
    <version>${infinispan.version}</version>
</dependency>

Copy to Clipboard

Toggle word wrap

リモートクライアントサーバーモード

リモートクライアントサーバーモードでは、infinispan-remote アーティファクトに CDI モジュールが含まれています。以下の例のように依存関係として追加する必要があります。

<dependency>
    <groupId>org.infinispan</groupId>
    <artifactId>infinispan-remote</artifactId>
    <version>${infinispan.version}</version>
</dependency>

<dependency>
    <groupId>org.infinispan</groupId>
    <artifactId>infinispan-remote</artifactId>
    <version>${infinispan.version}</version>
</dependency>

Copy to Clipboard

Toggle word wrap

32.3. Infinispan CDI モジュールの使用
リンクのコピー

32.3.1. Infinispan CDI モジュールの使用
リンクのコピー

Infinispan CDI モジュールは以下の目的に使用できます。

Infinispan キャッシュを CDI Bean および Java EE コンポーネントに設定およびインジェクトする。
キャッシュマネージャーの設定。
CDI アノテーションを使用した格納および取得の制御。

32.3.2. Infinispan キャッシュの設定およびインジェクション
リンクのコピー

32.3.2.1. Infinispan キャッシュのインジェクション
リンクのコピー

Infinispan キャッシュは、プロジェクトの CDI Bean にインジェクトできる複数のコンポーネントの 1 つです。

以下のコードスニペットはキャッシュインスタンスを CDI Bean にインジェクトする方法を示しています。

public class MyCDIBean {
    @Inject
    Cache<String, String> cache;
}

public class MyCDIBean {
    @Inject
    Cache<String, String> cache;
}

Copy to Clipboard

Toggle word wrap

32.3.2.2. リモート Infinispan キャッシュのインジェクション
リンクのコピー

リモート Infinispan キャッシュをインジェクトするには、普通のキャッシュをインジェクトするコードスニペットを次のように若干変更します。

public class MyCDIBean {
    @Inject
    RemoteCache<String, String> remoteCache;
}

public class MyCDIBean {
    @Inject
    RemoteCache<String, String> remoteCache;
}

Copy to Clipboard

Toggle word wrap

32.3.2.3. インジェクションのターゲットキャッシュの設定
リンクのコピー

32.3.2.3.1. インジェクションのターゲットキャッシュの設定
リンクのコピー

インジェクションのターゲットキャッシュを設定するには、次の 3 つのステップに従います。

修飾子アノテーションを作成します。
プロデューサークラスを追加します。
希望のクラスをインジェクトします。

32.3.2.3.2. 修飾子アノテーションの作成
リンクのコピー

CDI を使用して特定のキャッシュを返すには、次のようにカスタムのキャッシュ修飾子アノテーションを作成します。

カスタムキャッシュ修飾子

@javax.inject.Qualifier
@Target({ElementType.FIELD, ElementType.PARAMETER, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface SmallCache {}

@javax.inject.Qualifier
@Target({ElementType.FIELD, ElementType.PARAMETER, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface SmallCache {}

Copy to Clipboard

Toggle word wrap

作成した @SmallCache 修飾子を使用して、特定のキャッシュの作成方法を指定します。

32.3.2.3.3. プロデューサークラスの追加
リンクのコピー

以下のコードスニペットは、@SmallCache 修飾子 (前のステップで作成) がどのようにキャッシュの作成方法を指定するかを示しています。

@SmallCache 修飾子の使用

import org.infinispan.configuration.cache.Configuration;
import org.infinispan.configuration.cache.ConfigurationBuilder;
import org.infinispan.cdi.ConfigureCache;
import javax.enterprise.inject.Produces;

public class CacheCreator {
    @ConfigureCache("smallcache")
    @SmallCache
    @Produces
    public Configuration specialCacheCfg() {
        return new ConfigurationBuilder()
                   .memory()
                       .size(10)
                   .build();
    }
}

import org.infinispan.configuration.cache.Configuration;
import org.infinispan.configuration.cache.ConfigurationBuilder;
import org.infinispan.cdi.ConfigureCache;
import javax.enterprise.inject.Produces;

public class CacheCreator {
    @ConfigureCache("smallcache")
    @SmallCache
    @Produces
    public Configuration specialCacheCfg() {
        return new ConfigurationBuilder()
                   .memory()
                       .size(10)
                   .build();
    }
}

Copy to Clipboard

Toggle word wrap

コードスニペットの要素は次のとおりです。

@ConfigureCache はキャッシュの名前を指定します。
@SmallCache はキャッシュ修飾子です。

32.3.2.3.4. 希望のクラスのインジェクト
リンクのコピー

以下のように @SmallCache 修飾子と新しいプロデューサークラスを使用して、特定のキャッシュを CDI Bean にインジェクトします。

public class MyCDIBean {
    @Inject @SmallCache
    Cache<String, String> mySmallCache;
}

public class MyCDIBean {
    @Inject @SmallCache
    Cache<String, String> mySmallCache;
}

Copy to Clipboard

Toggle word wrap

32.3.3. CDI を用いたキャッシュマネージャーの設定
リンクのコピー

32.3.3.1. CDI を用いたキャッシュマネージャーの設定
リンクのコピー

Red Hat JBoss Data Grid のキャッシュマネージャー (組み込みとリモートの両方) は CDI を使用して設定できます。設定するキャッシュマネージャーが組み込みかリモートであるかに関わらず、最初の手順として、アノテーションを付けてプロデューサーとして動作するデフォルト設定を指定します。

32.3.3.2. デフォルト設定の指定
リンクのコピー

Red Hat JBoss Data Grid 設定に対してプロデューサーとしてアノテーション付けされたメソッドを指定し、デフォルトの Infinispan 設定を置き換えます。以下の設定例はこの手順を示しています。

デフォルト設定の指定

public class Config {
    @Produces
    public Configuration defaultEmbeddedConfiguration () {
        return new ConfigurationBuilder()
                         .memory()
                             size(100)
                         .build();
    }
}

public class Config {
    @Produces
    public Configuration defaultEmbeddedConfiguration () {
        return new ConfigurationBuilder()
                         .memory()
                             size(100)
                         .build();
    }
}

Copy to Clipboard

Toggle word wrap

注記

他の修飾子が提供されない場合、CDI は @Default 修飾子を追加します。

@Produces アノテーションが設定インスタンスを返すメソッドに配置された場合、Configuration オブジェクトが必要なときにメソッドが呼び出されます。

この設定例では、作成後に設定され返される新しい Configuration オブジェクトが作成されます。

32.3.3.3. 組み込みキャッシュマネージャーの作成のオーバーライド
リンクのコピー

前提条件

「デフォルト設定の指定」参照してください。

非クラスターキャッシュの作成

プロデューサーメソッドにアノテーションが付けられた後、以下のように EmbeddedCacheManager の作成時にこのメソッドが呼び出されます。

public class Config {

    @Produces
    @ApplicationScoped
    public EmbeddedCacheManager defaultEmbeddedCacheManager() {
        Configuration cfg = new ConfigurationBuilder()
                                    .memory()
                                        .size(150)
                                    .build();
        return new DefaultCacheManager(cfg);
    }
}

public class Config {

    @Produces
    @ApplicationScoped
    public EmbeddedCacheManager defaultEmbeddedCacheManager() {
        Configuration cfg = new ConfigurationBuilder()
                                    .memory()
                                        .size(150)
                                    .build();
        return new DefaultCacheManager(cfg);
    }
}

Copy to Clipboard

Toggle word wrap

@ApplicationScoped アノテーションはメソッドが 1 度だけ呼び出されることを指定します。

クラスターキャッシュの作成

以下の設定は、クラスターキャッシュの作成が可能な EmbeddedCacheManager の作成に使用できます。

public class Config {

	@Produces
	@ApplicationScoped
	public EmbeddedCacheManager defaultClusteredCacheManager() {
		GlobalConfiguration g = new GlobalConfigurationBuilder()
				.clusteredDefault()
				.transport()
				.clusterName("InfinispanCluster")
				.build();
		Configuration cfg = new ConfigurationBuilder()
				.memory()
				.size(150)
				.build();
		return new DefaultCacheManager(g, cfg);
	}
}

public class Config {

	@Produces
	@ApplicationScoped
	public EmbeddedCacheManager defaultClusteredCacheManager() {
		GlobalConfiguration g = new GlobalConfigurationBuilder()
				.clusteredDefault()
				.transport()
				.clusterName("InfinispanCluster")
				.build();
		Configuration cfg = new ConfigurationBuilder()
				.memory()
				.size(150)
				.build();
		return new DefaultCacheManager(g, cfg);
	}
}

Copy to Clipboard

Toggle word wrap

EmbeddedCacheManager を生成するメソッドの呼び出し

非クラスターメソッドの @Produces アノテーションが付けられたメソッドは Configuration オブジェクトを生成します。クラスターキャッシュの例で @Produces アノテーションが付けられたメソッドは EmbeddedCacheManager オブジェクトを生成します。

以下のように CDI Bean にインジェクションを追加し、適切にアノテーションが付けられたメソッドを呼び出します。これにより EmbeddedCacheManager が生成され、起動時にコードにインジェクトされます。

EmbeddedCacheManager の生成

...
@Inject
EmbeddedCacheManager cacheManager;
...

...
@Inject
EmbeddedCacheManager cacheManager;
...

Copy to Clipboard

Toggle word wrap

32.3.3.4. リモートキャッシュマネージャーの設定
リンクのコピー

RemoteCacheManager は、以下のように EmbeddedCacheManagers と似た方法で設定されます。

リモートキャッシュマネージャーの設定

public class Config {
	@Produces
	@ApplicationScoped
	public RemoteCacheManager defaultRemoteCacheManager() {
           Configuration conf = new ConfigurationBuilder().addServer().host(ADDRESS).port(PORT).build();
            return new RemoteCacheManager(conf);
	}
}}

public class Config {
	@Produces
	@ApplicationScoped
	public RemoteCacheManager defaultRemoteCacheManager() {
           Configuration conf = new ConfigurationBuilder().addServer().host(ADDRESS).port(PORT).build();
            return new RemoteCacheManager(conf);
	}
}}

Copy to Clipboard

Toggle word wrap

32.3.3.5. 単一クラスでの複数のキャッシュマネージャーの設定
リンクのコピー

単一のクラスを使用して、作成された修飾子を基に複数のキャッシュマネージャーおよびリモートキャッシュマネージャーを設定できます。以下に例を示します。

複数のキャッシュマネージャーの設定

public class Config {
    @Produces
    @ApplicationScoped
    public org.infinispan.manager.EmbeddedCacheManager
    defaultEmbeddedCacheManager() {
        Configuration cfg = new ConfigurationBuilder()
                .memory()
                .size(150)
                .build();
        return new DefaultCacheManager(cfg);
    }

    @Produces
    @ApplicationScoped
    @DefaultClustered
    public org.infinispan.manager.EmbeddedCacheManager
    defaultClusteredCacheManager() {
        GlobalConfiguration g = new GlobalConfigurationBuilder()
                .clusteredDefault()
                .transport()
                .clusterName("InfinispanCluster")
                .build();
        Configuration cfg = new ConfigurationBuilder()
                .memory()
                .size(150)
                .build();
        return new DefaultCacheManager(g, cfg);
    }

    @Produces
    @ApplicationScoped
    @DefaultRemote
    public RemoteCacheManager
    defaultRemoteCacheManager() {
        org.infinispan.client.hotrod.configuration.Configuration conf = new org.infinispan.client.hotrod.configuration.ConfigurationBuilder().addServer().host(ADDRESS).port(PORT).build();
        return new RemoteCacheManager(conf);
    }

    @Produces
    @ApplicationScoped
    @RemoteCacheInDifferentDataCentre
    public RemoteCacheManager newRemoteCacheManager() {
        org.infinispan.client.hotrod.configuration.Configuration confid = new org.infinispan.client.hotrod.configuration.ConfigurationBuilder().addServer().host(ADDRESS_FAR_AWAY).port(PORT).build();
        return new RemoteCacheManager(confid);
    }
}

public class Config {
    @Produces
    @ApplicationScoped
    public org.infinispan.manager.EmbeddedCacheManager
    defaultEmbeddedCacheManager() {
        Configuration cfg = new ConfigurationBuilder()
                .memory()
                .size(150)
                .build();
        return new DefaultCacheManager(cfg);
    }

    @Produces
    @ApplicationScoped
    @DefaultClustered
    public org.infinispan.manager.EmbeddedCacheManager
    defaultClusteredCacheManager() {
        GlobalConfiguration g = new GlobalConfigurationBuilder()
                .clusteredDefault()
                .transport()
                .clusterName("InfinispanCluster")
                .build();
        Configuration cfg = new ConfigurationBuilder()
                .memory()
                .size(150)
                .build();
        return new DefaultCacheManager(g, cfg);
    }

    @Produces
    @ApplicationScoped
    @DefaultRemote
    public RemoteCacheManager
    defaultRemoteCacheManager() {
        org.infinispan.client.hotrod.configuration.Configuration conf = new org.infinispan.client.hotrod.configuration.ConfigurationBuilder().addServer().host(ADDRESS).port(PORT).build();
        return new RemoteCacheManager(conf);
    }

    @Produces
    @ApplicationScoped
    @RemoteCacheInDifferentDataCentre
    public RemoteCacheManager newRemoteCacheManager() {
        org.infinispan.client.hotrod.configuration.Configuration confid = new org.infinispan.client.hotrod.configuration.ConfigurationBuilder().addServer().host(ADDRESS_FAR_AWAY).port(PORT).build();
        return new RemoteCacheManager(confid);
    }
}

Copy to Clipboard

Toggle word wrap

32.4. CDI アノテーションを使用した格納および取得
リンクのコピー

32.4.1. キャッシュアノテーションの設定
リンクのコピー

特定の CDI アノテーションは JCache (JSR-107) 仕様で受け入れられます。含まれるアノテーションはすべて javax.cache パッケージにあります。

アノテーションインターセプトメソッドは CDI Bean を呼び出し、インターセプトの結果として格納および取得タスクを実行します。

重要

CDI はリモートクライアントサーバーモードとライブラリーモードの両方でサポートされますが、@CachePut、@CacheRemove、@CacheRemoveAll、@CacheResult などのアノテーションはリモードクライアントサーバーモードでは使用できません。

32.4.2. キャッシュアノテーションの有効化
リンクのコピー

JBoss Data Grid には、使用方法に応じてインターセプターが 2 セット含まれています。beans.xml ファイルを使用するとインターセプターを CDI Bean アーカイブに追加できます。

オプション 1: CDI インターセプター

以下のコードを追加すると、InjectedCacheResultInterceptor、InjectedCachePutInterceptor、InjectedCacheRemoveEntryInterceptor、および InjectedCacheRemoveAllInterceptor などのインターセプターが追加されます。

CDI インターセプターの追加

<beans xmlns="http://java.sun.som/xml/ns/javaee"
       xmlns:xsi="http://www/w3/org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/beans_1_0.xsd" >
	<interceptors>
		<class>org.infinispan.jcache.annotation.InjectedCacheResultInterceptor</class>
		<class>org.infinispan.jcache.annotation.InjectedCachePutInterceptor</class>
		<class>org.infinispan.jcache.annotation.InjectedCacheRemoveEntryInterceptor</class>
		<class>org.infinispan.jcache.annotation.InjectedCacheRemoveAllInterceptor</class>
	</interceptors>
</beans>

<beans xmlns="http://java.sun.som/xml/ns/javaee"
       xmlns:xsi="http://www/w3/org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/beans_1_0.xsd" >
	<interceptors>
		<class>org.infinispan.jcache.annotation.InjectedCacheResultInterceptor</class>
		<class>org.infinispan.jcache.annotation.InjectedCachePutInterceptor</class>
		<class>org.infinispan.jcache.annotation.InjectedCacheRemoveEntryInterceptor</class>
		<class>org.infinispan.jcache.annotation.InjectedCacheRemoveAllInterceptor</class>
	</interceptors>
</beans>

Copy to Clipboard

Toggle word wrap

オプション 2: JCache インターセプター

以下のコードを追加すると CacheResultInterceptor、CachePutInterceptor、CacheRemoveEntryInterceptor、および CacheRemoveAllInterceptor などのインターセプターが追加されます。

JCache インターセプターの追加

<beans xmlns="http://java.sun.com/xml/ns/javaee"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/beans_1_0.xsd">

   <interceptors>
      <class>org.infinispan.jcache.annotation.CacheResultInterceptor</class>
      <class>org.infinispan.jcache.annotation.CachePutInterceptor</class>
      <class>org.infinispan.jcache.annotation.CacheRemoveEntryInterceptor</class>
      <class>org.infinispan.jcache.annotation.CacheRemoveAllInterceptor</class>
   </interceptors>

</beans>

<beans xmlns="http://java.sun.com/xml/ns/javaee"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/beans_1_0.xsd">

   <interceptors>
      <class>org.infinispan.jcache.annotation.CacheResultInterceptor</class>
      <class>org.infinispan.jcache.annotation.CachePutInterceptor</class>
      <class>org.infinispan.jcache.annotation.CacheRemoveEntryInterceptor</class>
      <class>org.infinispan.jcache.annotation.CacheRemoveAllInterceptor</class>
   </interceptors>

</beans>

Copy to Clipboard

Toggle word wrap

注記

Red Hat JBoss Data Grid が javax.cache アノテーションを使用するには、記載されているインターセプターが beans.xml ファイルに存在する必要があります。

32.4.3. メソッド呼び出しの結果をキャッシュ
リンクのコピー

32.4.3.1. メソッド呼び出しの結果をキャッシュ
リンクのコピー

今後のアクセスのために結果をキャッシュに保存することは、時間またはリソース集約型の操作で一般的に行われます。以下のコードはこのような操作の例になります。

public String toCelsiusFormatted(float fahrenheit) {
	return
		NumberFormat.getInstance()
		.format((fahrenheit * 5 / 9) - 32)
		+ " degrees Celsius";
}

public String toCelsiusFormatted(float fahrenheit) {
	return
		NumberFormat.getInstance()
		.format((fahrenheit * 5 / 9) - 32)
		+ " degrees Celsius";
}

Copy to Clipboard

Toggle word wrap

一般的には、メソッド呼び出しの結果をキャッシュし、次に結果が必要になるときにキャッシュをチェックします。以下は、このような操作の結果をキャッシュで検索するコードスニペットの例になります。結果が見つからない場合、コードスニペットは toCelsiusFormatted を再実行し、結果をキャッシュに格納します。

float f = getTemperatureInFahrenheit();
Cache<Float, String>
	fahrenheitToCelsiusCache = getCache();
String celsius =
	fahrenheitToCelsiusCache = get(f);
     if (celsius == null) {
	     celsius = toCelsiusFormatted(f);
	     fahrenheitToCelsiusCache.put(f, celsius);
     }

float f = getTemperatureInFahrenheit();
Cache<Float, String>
	fahrenheitToCelsiusCache = getCache();
String celsius =
	fahrenheitToCelsiusCache = get(f);
     if (celsius == null) {
	     celsius = toCelsiusFormatted(f);
	     fahrenheitToCelsiusCache.put(f, celsius);
     }

Copy to Clipboard

Toggle word wrap

このような場合、Infinispan CDI モジュールを使用すると、関連する例で余分なコードを削除できます。以下のように、メソッドに @CacheResult アノテーションを付けます。

@javax.cache.annotation.CacheResult
public String toCelsiusFormatted(float fahrenheit) {
	return NumberFormat.getInstance()
	.format((fahrenheit * 5 / 9) - 32)
	+ " degrees Celsius";
}

@javax.cache.annotation.CacheResult
public String toCelsiusFormatted(float fahrenheit) {
	return NumberFormat.getInstance()
	.format((fahrenheit * 5 / 9) - 32)
	+ " degrees Celsius";
}

Copy to Clipboard

Toggle word wrap

アノテーションにより、Infinispan はキャッシュをチェックし、結果が見つからなかった場合は toCelsiusFormatted() メソッドを呼び出します。

注記

Infinispan CDI モジュールでは、保存した結果のキャッシュをチェックできますが、これは適用前に注意して考慮する必要があります。呼び出しの結果が常に最新のデータである必要がある場合やキャッシュの読み取りにリモートネットワークの検索やキャッシュローダーからのデシリアライズが必要である場合、コールメソッド呼び出し前のキャッシュのチェックは逆効果になる可能性があります。

32.4.3.2. 使用するキャッシュの指定
リンクのコピー

以下のオプションの属性 (cacheName) を @CacheResult アノテーションに追加し、メソッドコールの結果をチェックするキャッシュを指定します。

@CacheResult(cacheName = "mySpecialCache")
public String doSomething(String parameter) {
<!-- Additional configuration information here -->
}

@CacheResult(cacheName = "mySpecialCache")
public String doSomething(String parameter) {
<!-- Additional configuration information here -->
}

Copy to Clipboard

Toggle word wrap

32.4.3.3. キャッシュされた結果のキャッシュキー
リンクのコピー

デフォルトでは、@CacheResult アノテーションはキャッシュから取得された結果のキーを作成します。このキーは、関連するメソッドのすべてのパラメーターの組み合わせで構成されます。

次のように @CacheKey アノテーションを使用してカスタムキーを作成します。

カスタムキーの作成

@CacheResult
public String doSomething
	(@CacheKey String p1,
	@CacheKey String p2,
	String dontCare) {
<!-- Additional configuration information here -->
}

@CacheResult
public String doSomething
	(@CacheKey String p1,
	@CacheKey String p2,
	String dontCare) {
<!-- Additional configuration information here -->
}

Copy to Clipboard

Toggle word wrap

この例では、キャッシュキーの作成に p1 と p2 のみが値として使用されます。キャッシュキーの判断には dontCare の値は使用されません。

32.4.3.4. カスタムキーの生成
リンクのコピー

次のようにカスタムキーを生成します。

import javax.cache.annotation.CacheKey;
import javax.cache.annotation.CacheKeyGenerator;
import javax.cache.annotation.CacheKeyInvocationContext;
import java.lang.annotation.Annotation;

public class MyCacheKeyGenerator implements CacheKeyGenerator {

   @Override
   public CacheKey generateCacheKey(CacheKeyInvocationContext<? extends Annotation> ctx) {

      return new MyCacheKey(
            ctx.getAllParameters()[0].getValue()
      );
   }
}

import javax.cache.annotation.CacheKey;
import javax.cache.annotation.CacheKeyGenerator;
import javax.cache.annotation.CacheKeyInvocationContext;
import java.lang.annotation.Annotation;

public class MyCacheKeyGenerator implements CacheKeyGenerator {

   @Override
   public CacheKey generateCacheKey(CacheKeyInvocationContext<? extends Annotation> ctx) {

      return new MyCacheKey(
            ctx.getAllParameters()[0].getValue()
      );
   }
}

Copy to Clipboard

Toggle word wrap

このメソッドはカスタムキーを構築します。このキーは呼び出しコンテキストの最初のパラメーターによって生成された値の一部として渡されます。

カスタムのキー生成スキームを指定するには、以下のように任意のパラメーター cacheKeyGenerator を @CacheResult アノテーションに追加します。

@CacheResult(cacheKeyGenerator = MyCacheKeyGenerator.class)
public void doSomething(String p1, String p2) {
<!-- Additional configuration information here -->
}

@CacheResult(cacheKeyGenerator = MyCacheKeyGenerator.class)
public void doSomething(String p1, String p2) {
<!-- Additional configuration information here -->
}

Copy to Clipboard

Toggle word wrap

提供されたメソッドを使用し、p1 にカスタムキーが含まれます。

32.4.4. キャッシュ操作
リンクのコピー

32.4.4.1. キャッシュエントリーの更新
リンクのコピー

@CachePut アノテーションが含まれるメソッドが呼び出されると、パラメーター (通常は @CacheValue アノテーションが付けられたメソッドに渡されます) はキャッシュに格納されます。

@CachePut アノテーションが付けられたメソッドの例

import javax.cache.annotation.CachePut;
import javax.cache.annotation.CacheKey;
import javax.cache.annotation.CacheValue;

@CachePut (cacheName = "personCache")
public void updatePerson
	(@CacheKey long personId,
	@CacheValue Person newPerson) {
<!-- Additional configuration information here -->
	}

import javax.cache.annotation.CachePut;
import javax.cache.annotation.CacheKey;
import javax.cache.annotation.CacheValue;

@CachePut (cacheName = "personCache")
public void updatePerson
	(@CacheKey long personId,
	@CacheValue Person newPerson) {
<!-- Additional configuration information here -->
	}

Copy to Clipboard

Toggle word wrap

@CachePut メソッドの cacheName および cacheKeyGenerator を使用するとさらにカスタマイズすることができます。また、呼び出されたメソッドの一部のパラメーターに @CacheKey アノテーションを付けるとキーの生成を制御できます。

「キャッシュされた結果のキャッシュキー」も参照してください。

32.4.4.2. キャッシュからのエントリーの削除
リンクのコピー

以下は、キャッシュからエントリーを削除するために使用される @CacheRemoveEntry アノテーションが付けられたメソッドの例になります。

キャッシュからエントリーを削除

import javax.cache.annotation.CacheRemoveEntry;
import javax.cache.annotation.CacheKey;

@CacheRemoveEntry (cacheName = "cacheOfPeople")
public void changePersonName
	(@CacheKey long personId,
	string newName) {
<!-- Additional configuration information here -->
	}

import javax.cache.annotation.CacheRemoveEntry;
import javax.cache.annotation.CacheKey;

@CacheRemoveEntry (cacheName = "cacheOfPeople")
public void changePersonName
	(@CacheKey long personId,
	string newName) {
<!-- Additional configuration information here -->
	}

Copy to Clipboard

Toggle word wrap

このアノテーションは、任意の cacheName および cacheKeyGenerator 属性を受け入れます。

32.4.4.3. キャッシュの消去
リンクのコピー

@CacheRemoveAll メソッドを呼び出して、キャッシュからすべてのエントリーを消去します。

@CacheRemoveAll を使用してキャッシュからすべてのエントリーを消去

import javax.cache.annotation.CacheRemoveAll;

@CacheRemoveAll (cacheName = "statisticsCache")
public void resetStatistics() {
<!-- Additional configuration information here -->
}

import javax.cache.annotation.CacheRemoveAll;

@CacheRemoveAll (cacheName = "statisticsCache")
public void resetStatistics() {
<!-- Additional configuration information here -->
}

Copy to Clipboard

Toggle word wrap

例のとおり、このアノテーションは任意の cacheName 属性を受け入れます。

トップに戻る

第32章 Infinispan CDI モジュール

32.1. Infinispan CDI モジュールリンクのコピーリンクがクリップボードにコピーされました!

32.2. Infinispan CDI の使用リンクのコピーリンクがクリップボードにコピーされました!

32.2.1. Infinispan CDI の要件リンクのコピーリンクがクリップボードにコピーされました!

32.2.2. CDI Maven 依存関係の設定リンクのコピーリンクがクリップボードにコピーされました!

32.3. Infinispan CDI モジュールの使用リンクのコピーリンクがクリップボードにコピーされました!

32.3.1. Infinispan CDI モジュールの使用リンクのコピーリンクがクリップボードにコピーされました!

32.3.2. Infinispan キャッシュの設定およびインジェクションリンクのコピーリンクがクリップボードにコピーされました!

32.3.2.1. Infinispan キャッシュのインジェクションリンクのコピーリンクがクリップボードにコピーされました!

32.3.2.2. リモート Infinispan キャッシュのインジェクションリンクのコピーリンクがクリップボードにコピーされました!

32.3.2.3. インジェクションのターゲットキャッシュの設定リンクのコピーリンクがクリップボードにコピーされました!

32.3.2.3.1. インジェクションのターゲットキャッシュの設定リンクのコピーリンクがクリップボードにコピーされました!

32.3.2.3.2. 修飾子アノテーションの作成リンクのコピーリンクがクリップボードにコピーされました!

32.3.2.3.3. プロデューサークラスの追加リンクのコピーリンクがクリップボードにコピーされました!

32.3.2.3.4. 希望のクラスのインジェクトリンクのコピーリンクがクリップボードにコピーされました!

32.3.3. CDI を用いたキャッシュマネージャーの設定リンクのコピーリンクがクリップボードにコピーされました!

32.3.3.1. CDI を用いたキャッシュマネージャーの設定リンクのコピーリンクがクリップボードにコピーされました!

32.3.3.2. デフォルト設定の指定リンクのコピーリンクがクリップボードにコピーされました!

32.3.3.3. 組み込みキャッシュマネージャーの作成のオーバーライドリンクのコピーリンクがクリップボードにコピーされました!

32.3.3.4. リモートキャッシュマネージャーの設定リンクのコピーリンクがクリップボードにコピーされました!

32.3.3.5. 単一クラスでの複数のキャッシュマネージャーの設定リンクのコピーリンクがクリップボードにコピーされました!

32.4. CDI アノテーションを使用した格納および取得リンクのコピーリンクがクリップボードにコピーされました!

32.4.1. キャッシュアノテーションの設定リンクのコピーリンクがクリップボードにコピーされました!

32.4.2. キャッシュアノテーションの有効化リンクのコピーリンクがクリップボードにコピーされました!

32.4.3. メソッド呼び出しの結果をキャッシュリンクのコピーリンクがクリップボードにコピーされました!

32.4.3.1. メソッド呼び出しの結果をキャッシュリンクのコピーリンクがクリップボードにコピーされました!

32.4.3.2. 使用するキャッシュの指定リンクのコピーリンクがクリップボードにコピーされました!

32.4.3.3. キャッシュされた結果のキャッシュキーリンクのコピーリンクがクリップボードにコピーされました!

32.4.3.4. カスタムキーの生成リンクのコピーリンクがクリップボードにコピーされました!

32.4.4. キャッシュ操作リンクのコピーリンクがクリップボードにコピーされました!

32.4.4.1. キャッシュエントリーの更新リンクのコピーリンクがクリップボードにコピーされました!

32.4.4.2. キャッシュからのエントリーの削除リンクのコピーリンクがクリップボードにコピーされました!

32.4.4.3. キャッシュの消去リンクのコピーリンクがクリップボードにコピーされました!

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

32.1. Infinispan CDI モジュール
リンクのコピー

32.2. Infinispan CDI の使用
リンクのコピー

32.2.1. Infinispan CDI の要件
リンクのコピー

32.2.2. CDI Maven 依存関係の設定
リンクのコピー

32.3. Infinispan CDI モジュールの使用
リンクのコピー

32.3.1. Infinispan CDI モジュールの使用
リンクのコピー

32.3.2. Infinispan キャッシュの設定およびインジェクション
リンクのコピー

32.3.2.1. Infinispan キャッシュのインジェクション
リンクのコピー

32.3.2.2. リモート Infinispan キャッシュのインジェクション
リンクのコピー

32.3.2.3. インジェクションのターゲットキャッシュの設定
リンクのコピー

32.3.2.3.1. インジェクションのターゲットキャッシュの設定
リンクのコピー

32.3.2.3.2. 修飾子アノテーションの作成
リンクのコピー

32.3.2.3.3. プロデューサークラスの追加
リンクのコピー

32.3.2.3.4. 希望のクラスのインジェクト
リンクのコピー

32.3.3. CDI を用いたキャッシュマネージャーの設定
リンクのコピー

32.3.3.1. CDI を用いたキャッシュマネージャーの設定
リンクのコピー

32.3.3.2. デフォルト設定の指定
リンクのコピー

32.3.3.3. 組み込みキャッシュマネージャーの作成のオーバーライド
リンクのコピー

32.3.3.4. リモートキャッシュマネージャーの設定
リンクのコピー

32.3.3.5. 単一クラスでの複数のキャッシュマネージャーの設定
リンクのコピー

32.4. CDI アノテーションを使用した格納および取得
リンクのコピー

32.4.1. キャッシュアノテーションの設定
リンクのコピー

32.4.2. キャッシュアノテーションの有効化
リンクのコピー

32.4.3. メソッド呼び出しの結果をキャッシュ
リンクのコピー

32.4.3.1. メソッド呼び出しの結果をキャッシュ
リンクのコピー

32.4.3.2. 使用するキャッシュの指定
リンクのコピー

32.4.3.3. キャッシュされた結果のキャッシュキー
リンクのコピー

32.4.3.4. カスタムキーの生成
リンクのコピー

32.4.4. キャッシュ操作
リンクのコピー

32.4.4.1. キャッシュエントリーの更新
リンクのコピー

32.4.4.2. キャッシュからのエントリーの削除
リンクのコピー

32.4.4.3. キャッシュの消去
リンクのコピー