rycaon/isis-app-helloworld

App to get you up and running quickly with Apache Isis

HelloWorld

Table of Contents

• Quick start
• Development

This is a minimal Apache Isis application, intended as a starting point to learn what the framework is all about.

Tip	For real-world development, we recommend you instead start with the SimpleApp starter app. It provides more structure and includes examples of fixtures, unit tests, integration tests, and BDD (Cucumber) specs.

Quick start

• install prereqs:

  • Java 8 LTS (eg Adopt OpenJDK distribution)

  • Maven 3.6 or later (download)

• download and unzip

  APP=helloworld
  BRANCH=master
  
  REPO=isis-app-$APP
  curl "https://codeload.github.com/apache/$REPO/zip/$BRANCH" | jar xv
  mv $REPO-$BRANCH $REPO
  cd $REPO

• Build using Maven:

  mvn clean install

• Run from Maven:

  mvn spring-boot:run

• Browse to http://localhost:8080.

• Login using:

  • username: sven

  • password: pass

The app runs with H2 running in-memory.

Development

Apache Isis uses DataNucleus as its ORM, which requires that any entities are "enhanced", a post-compile process.

Normally this is done as part of a "mvn clean install", but the entities can also be enhanced explicity using:

mvn datanucleus:enhance -o

This is useful to know if the application fails to bootstrap, complaining of "unenhanced entities".

Tip	You can also use enhance-all.sh