Data Grid Spring Boot スターター

組み込みキャッシュを使用するようにアプリケーションを設定します。

これで、次の例のように、アプリケーション内でデータグリッドキャッシュを直接使用する準備が整いました。

cacheManager.getCache("testCache").put("testKey", "testValue");
System.out.println("Received value from cache: " + cacheManager.getCache("testCache").get("testKey"));

Spring 6.1 以降では、リアクティブアプリケーション内でキャッシュを利用するためにリアクティブモードがサポートされています。spring-boot-starter-webflux を使用すると、アプリケーションがブロックされる可能性があります。

Data Grid リアクティブドライバーを有効にするには、application.properties で次のプロパティーを指定します。

infinispan.embedded.reactive=true

次の設定 Bean を使用して Cache Manager をカスタマイズできます。

@Bean
public InfinispanCacheConfigurer cacheConfigurer() {
	return manager -> {
		final Configuration ispnConfig = new ConfigurationBuilder()
                        .clustering()
                        .cacheMode(CacheMode.LOCAL)
                        .build();

		manager.defineConfiguration("local-sync-config", ispnConfig);
	};
}

@Bean(name = "small-cache")
public org.infinispan.configuration.cache.Configuration smallCache() {
    return new ConfigurationBuilder()
        .read(baseCache)
        .memory().size(1000L)
        .memory().evictionType(EvictionType.COUNT)
        .build();
}

@Bean(name = "large-cache")
public org.infinispan.configuration.cache.Configuration largeCache() {
    return new ConfigurationBuilder()
        .read(baseCache)
        .memory().size(2000L)
        .build();
}

@Bean
public InfinispanGlobalConfigurationCustomizer globalCustomizer() {
   return builder -> builder.transport().clusterName(CLUSTER_NAME);
}

@Bean
public InfinispanConfigurationCustomizer configurationCustomizer() {
   return builder -> builder.memory().evictionType(EvictionType.COUNT);
}

Data Grid は、組み込みキャッシュとリモートキャッシュの両方を使用して、有効にできる Spring Cache の実装を提供します。

Data Grid スターターが以下を検出した場合:

Data Grid クラスターでリモートキャッシュを使用するようにアプリケーションを設定します。

Spring 6.1 以降では、リアクティブアプリケーション内でキャッシュを利用するためにリアクティブモードがサポートされています。spring-boot-starter-webflux を使用すると、アプリケーションがブロックされる可能性があります。

Data Grid リアクティブドライバーを有効にするには、application.properties で次のプロパティーを指定します。

infinispan.remote.reactive=true

# List Data Grid servers by IP address or hostname at port localhost:11222.
infinispan.client.hotrod.server_list=127.0.0.1:11222

# List Data Grid servers by IP address or hostname at port localhost:11222.
infinispan.remote.server-list=127.0.0.1:11222

Java オブジェクトをバイナリー形式にマーシャリングするように Data Grid を設定して、ネットワーク経由で転送したり、ディスクに保存したりできるようにします。

デフォルトでは、Data Grid は Java シリアル化マーシャラーを使用するため、クラスを許可リストに追加する必要があります。別の方法として、ProtoStream を使用できます。これには、クラスにアノテーションを付けて、カスタム Java オブジェクトの SerializationContextInitializer を生成する必要があります。

次の設定 Bean を使用して Cache Manager をカスタマイズします。

@Bean
public InfinispanRemoteConfigurer infinispanRemoteConfigurer() {
    return () -> new ConfigurationBuilder()
        .addServer()
        .host("127.0.0.1")
        .port(12345)
        .build();
}

@Bean
public org.infinispan.client.hotrod.configuration.Configuration customConfiguration() {
    new ConfigurationBuilder()
        .addServer()
        .host("127.0.0.1")
        .port(12345)
        .build();
}

@Bean
public InfinispanRemoteCacheCustomizer customizer() {
    return b -> b.tcpKeepAlive(false);
}

Data Grid は、組み込みキャッシュとリモートキャッシュの両方を使用して、有効にできる Spring Cache の実装を提供します。

Data Grid スターターが以下を検出した場合:

Data Grid は、Spring Boot Actuator をサポートして、キャッシュ統計をメトリックとして公開します。

Spring Boot Actuator レジストリーは、アプリケーションの起動時にキャッシュインスタンスをバインドします。

キャッシュを動的に作成する場合は、次のように、CacheMetricsRegistrar Bean を使用してキャッシュを Actuator レジストリーにバインドする必要があります。

@Autowire
CacheMetricsRegistrar cacheMetricsRegistrar;

@Autowire
CacheManager cacheManager;
...

cacheMetricsRegistrar.bindCacheToRegistry(cacheManager.getCache("my-cache"));

Data Grid Spring Session サポートは SpringRemoteCacheManager と SpringEmbeddedCacheManager をもとに構築されます。Data Grid スターターは、デフォルトでこれらの Bean を生成します。