It’s easy to get started with Infinispan. All you need is Java, dependency management tooling, and either the Infinispan server or core libraries.
To run Infinispan, you’ll need:
Java 1.8 JDK at a minimum. Infinispan recommends JDK 11 but also works with JDK 14.
Maven 3.2 or later. Infinispan also works with Gradle and Ivy.
Choose your Java runtime and follow their installation instructions. For example, you could choose:
mvn --version to check your current Maven version. If you have Maven 3.2
or later, you are ready to go.
If you need to install Maven, visit https://maven.apache.org/install.html.
To start using Infinispan, you can:
Infinispan provides a set of Maven archetypes that you can use to generate
skeleton projects with sample code and
pom.xml files. You can then import
these projects into your IDE and start building and running applications with
Maven 3.2 or later.
Ensure the JBoss GA repository,
jboss-ga-repository, is included in your Maven settings.
Open a terminal window in the directory where you want to create project files.
Generate projects from Infinispan archetypes with the following command:
$ mvn archetype:generate -DarchetypeGroupId=org.infinispan.archetypes \ -DarchetypeArtifactId=<archetype-name> \ (1) -DarchetypeVersion=<infinispan-version> (2)
1 Creates projects from one of the following archetypes:
clientCreates a sample Hot Rod Java client application.
embeddedCreates a sample application that embeds Infinispan.
storeCreates a sample implementation of a custom cache store.
server-taskCreates a sample implementation of a ServerTask.
2 Specifies the Infinispan version to use, for example:
When prompted, define artifactId, groupId, and version values for your project.
Import your new Infinispan project into your IDE.
Run your project application from the directory where the
pom.xmlfile resides as follows:
$ mvn package exec:java
server-taskarchetype does not include a project application,
Application.java, that you can run.