Reference App

The reference app (previously called the 'demo app') provides an introduction to the Apache Causeway programming model, allowing you to learn the basics with a minimum of hassle. It’s also a useful reference to help you develop your own Apache Causeway applications.

teaser light

The application is packaged up as a Docker image (apache/causeway-app-demo-jpa) on Docker Hub, so you can easily run it yourself (as described below).

Prereqs

Head over to Docker to install the community edition.

Running the Docker Image

  • Pull and run the Docker Image

    docker pull apache/causeway-app-demo-jpa:latest
docker run --name demo -d -p8080:8080 apache/causeway-app-demo-jpa:latest

    The app can then be accessed at http://localhost:8080/wicket/. Login with sven:pass.

  • Stop and remove the container named demo

    docker stop demo && docker rm demo

Customization

The way in which the app is run by Docker be customised in a couple of ways.

  • Prototyping mode

    docker run --name demo -d -p8080:8080 -ePROTOTYPING=true apache/causeway-app-demo-jpa:latest

  • Specify a different context Path

    docker run -d -p8080:8080 -eContextPath=/myPath apache/causeway-app-demo-jpa:latest

    then access at http://localhost:8080/myPath/wicket/.

Building from Source

The source code for the reference app is on github, at apache/causeway-app-referenceapp.

Credits