Skip to content

Latest commit

 

History

History
152 lines (99 loc) · 6.11 KB

README.md

File metadata and controls

152 lines (99 loc) · 6.11 KB
Raw

helloworld-jdg: Basic Infinispan example

Author: Burr Sutter, Martin Gencur Level: Intermediate Technologies: Infinispan, CDI Summary: Shows how to use Infinispan in clustered mode, with expiration enabled. Target Product: JDG Product Versions: EAP 6.x, JDG 6.x Source: https://github.com/infinispan/jdg-quickstart

What is it?

HelloWorld-JDG is a basic example that shows how to store and retrieve data to/from the cache. Users can access the cache either from a servlet or from a JSF page through request scoped beans.

Infinispan is configured in clustered distributed mode with synchronous replication. Entries have their lifespan (expiration) and are removed from the cache after 60 seconds since last update.

HelloWorld-JDG example works in Library mode. In this mode, the application and the data grid are running in the same JVM. All libraries (JAR files) are bundled with the application and deployed to Red Hat JBoss Enterprise Application Platform. The library mode enables fastest (local) access to the entries stored on the same node as the application instance, but also enables access to data stored in remote nodes (JVMs) that comprise the embedded distributed cluster.

System requirements

All you need to build this project is Java 6.0 (Java SDK 1.6) or better, Maven 3.0 or better.

The application this project produces is designed to be run on Red Hat JBoss Enterprise Application Platform (EAP) 6.1 or later.

Configure Maven

If you have not yet done so, you must Configure Maven before testing the quickstarts.

Start first instance of EAP

  1. Open a command line and navigate to the root of the EAP directory.

  2. The following shows the command line to start the server with the web profile:

     For Linux:   $JBOSS_HOME/bin/standalone.sh
 For Windows: %JBOSS_HOME%\bin\standalone.bat

Start second instance of EAP

  1. Make a second copy of EAP

  2. Open a command line and navigate to the root of the second EAP directory.

  3. Start the server with pre-configured port offset so that the server can run on the same host

     For Linux:   $JBOSS_HOME2/bin/standalone.sh -Djboss.socket.binding.port-offset=100
 For Windows: %JBOSS_HOME2%\bin\standalone.bat -Djboss.socket.binding.port-offset=100

Build and Deploy the Quickstart

NOTE: The following build command assumes you have configured your Maven user settings. If you have not, you must include Maven setting arguments on the command line. See Build and Deploy the Quickstarts for complete instructions and additional options.

  1. Make sure you have started both instances of EAP as described above.

  2. Open a command line and navigate to the root directory of this quickstart.

  3. Type this command to build and deploy the archive to the first server:

     mvn clean package jboss-as:deploy

  4. This will deploy target/jboss-helloworld-jdg.war to the first running instance of the server.

  5. Type this command to build and deploy the archive to the second server (running on different ports):

     mvn clean package jboss-as:deploy -Djboss-as.port=10099

  6. This will deploy target/jboss-helloworld-jdg.war to the second running instance of the server.

Access the application

The application will be running at the following URLs:

http://localhost:8080/jboss-helloworld-jdg (first server instance) http://localhost:8180/jboss-helloworld-jdg (second server instance)

You can test replication of entries in the following way:

  1. Access first server at http://localhost:8080/jboss-helloworld-jdg and insert key "foo" with value "bar"
  2. Access second server at http://localhost:8180/jboss-helloworld-jdg and do the following:
    • Click on "Get Some"
    • Get the value for key "foo"
    • Click "Put Some More"
    • Insert key "mykey" with value "myvalue"
  3. Access the first server at http://localhost:8080/jboss-helloworld-jdg and do the following:
    • Click on "Get Some"
    • Get all mappings by clicking on "Get All"
  4. All data entered on each server was replicated to the other server

NOTE: Entries expire and simply disappear after 60 seconds from last update.

To access predefined servlets and directly store/retrieve a key in the cache, access the following URLs:

http://localhost:8080/jboss-helloworld-jdg/TestServletPut http://localhost:8180/jboss-helloworld-jdg/TestServletGet (note the different port 8180)

Undeploy the Archive

  1. Make sure you have started the EAP as described above.

  2. Open a command line and navigate to the root directory of this quickstart.

  3. When you are finished testing, type this command to undeploy the archive from both running servers:

     mvn jboss-as:undeploy
 mvn jboss-as:undeploy -Ddeploy.port=10099

Run the Quickstart in JBoss Developer Studio or Eclipse

You can also start the server and deploy the quickstarts from Eclipse using JBoss tools. For more information, see Use JBoss Developer Studio or Eclipse to Run the Quickstarts

Debug the Application

If you want to debug the source code or look at the Javadocs of any library in the project, run either of the following commands to pull them into your local repository. The IDE should then detect them.

    mvn dependency:sources
    mvn dependency:resolve -Dclassifier=javadoc

Test the Application

If you want to test the application, there are simple Arquillian Selenium tests prepared. To run these tests on EAP:

  1. Stop EAP (if you have some running)

  2. Open a command line and navigate to the root directory of this quickstart.

  3. Build the quickstart using:

     mvn clean package

  4. Type this command to run the tests (server paths can be the same):

     mvn test -Puitests-clustered -Das7home=/path/to/first/server -Das7home2=/path/to/second/server