Building and Running

Building

If you've cloned the source, use the standard mvn package command to build the JAR.

By default the JavaDoc will also be generated. You can disable this to improve the build time using the following command:

mvn package -Dmaven.javadoc.skip=true

Running

In order to start the application, you must supply the configuration file you want the application to load.

In the source src/main/resources there is a sample properties file for each of the 3 BuaBook environments. You should take the appropriate configuration file, make the modifications you need and then reference it as part of the boot command:

java -Dapp-properties-file=file:/configuration/file/location/path -jar buabook-api-interface-2.0.0.jar

Note that the file: part of the command above is important to tell Spring to look for this file on disk and not within the JAR itself. The configuration file path is relative to where Java is run from.

Enabling JMX

The application supports JMX for some basic configuration (see the JMX wiki page). Our spring-common library describes how to start the JVM with JMX enabled.