Data Grid Spring Boot Starter

Procedure

1. Add infinispan-spring-boot3-starter-embedded to your project’s classpath to enable Embedded mode.

2. Use the Spring @Autowired annotation to include an EmbeddedCacheManager bean in your Java configuration classes, as in the following example:

   private final EmbeddedCacheManager cacheManager;
   
   @Autowired
   public YourClassName(EmbeddedCacheManager cacheManager) {
       this.cacheManager = cacheManager;
   }

1. Provide the addresses where Data Grid Server listens for client connections so the starter can create the RemoteCacheManager bean.

2. Use the Spring @Autowired annotation to include your own custom Cache Manager class in your application:

   private final RemoteCacheManager cacheManager;
   
   @Autowired
   public YourClassName(RemoteCacheManager cacheManager) {
       this.cacheManager = cacheManager;
   }

Procedure

1. Open hotrod-client.properties or application.properties for editing.

2. Do one of the following:

   • Use ProtoStream as the marshaller.

     infinispan.client.hotrod.marshaller=org.infinispan.commons.marshall.ProtoStreamMarshaller

     infinispan.remote.marshaller=org.infinispan.commons.marshall.ProtoStreamMarshaller

   • Add your classes to the serialization allow list if you use Java Serialization. You can specify a comma-separated list of fully qualified class names or a regular expression to match classes.

     infinispan.client.hotrod.java_serial_allowlist=your_marshalled_beans_package.*

     infinispan.remote.java-serial-allowlist=your_marshalled_beans_package.*

3. Save and close your properties file.

Procedure

1. Add the following to your pom.xml file:

   <dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-actuator</artifactId>
     <version>${version.spring.boot}</version>
    </dependency>
   
   <dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-web</artifactId>
     <version>${version.spring.boot}</version>
   </dependency>

2. Activate statistics for the appropriate cache instances, either programmatically or declaratively.

   Programmatically

   @Bean
   public InfinispanCacheConfigurer cacheConfigurer() {
     return cacheManager -> {
        final org.infinispan.configuration.cache.Configuration config =
              new ConfigurationBuilder()
                    .jmxStatistics().enable()
                    .build();
   
        cacheManager.defineConfiguration("my-cache", config);
     };
   }

   Declaratively

   <local-cache statistics="true"/>

Procedure

1. Add this starter to your project.
2. Add Spring Session to the classpath.

3. Add the following annotations to your configuration:

   • @EnableCaching
   • @EnableInfinispanRemoteHttpSession
   • @EnableInfinispanEmbeddedHttpSession