Quarkus - Infinispan Embedded

Infinispan is an elastically scalable in-memory data store that you can embeddirectly in your application.

Check out the Infinispandocumentation to find out more about the Infinispan project.

Adding the Infinispan Embedded Extension

After you set up your Quarkus project, run the following command from the base directory:

./mvnw quarkus:add-extension -Dextensions="infinispan-embedded"

The command adds the following dependency to your pom.xml:

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-infinispan-embedded</artifactId>
</dependency>

Feature Support

The Infinispan embedded extension offers core caching functionality thatincludes clustered caches, off-heap memory, data persistence, and transactions.

Transactions

Configure Infinispan caches for transactional operations with a specificTransactionManagerLookup, as follows:

<local-cache name="quarkus-transaction">
   <transaction transaction-manager-lookup="org.infinispan.transaction.lookup.JBossStandaloneJTAManagerLookup"/>
</local-cache>

For more information, see the Quarkus Transaction Guide.

Native Limitations

When running Infinispan in native mode, some limitations apply:

• JMX management is not supported.+ GraalVM does not allow native VM interfaces.

• UDP/Multicast is not supported.+ You must use TCP transport and a non-UDP based membership protocol with JGroups.

Injection (CDI)

The Infinispan embedded extension provides injection capabilities so you do nothave to configure and start caches manually.

• EmbeddedCacheManager
• This is the main entry point to configure and obtain caches.

Configuration Reference

Configuration property fixed at build time - ️ Configuration property overridable at runtime