The Java Preferences adapter is provided as an implementation of the Preferences API that must be used as a wrapper to another existing implementation (such as the default file based system provided with the JRE). To enable the use of central configuration in a Java application that makes use of the Preferences API, a startup script for that application must be written, using the /usr/lib/apoc/apocjlaunch script as a helper. This script needs to define a few environment variables and then include the apocjlaunch script at its end (which starts the Java application with the necessary environment). The environment variables that must be set are:
JAVA: contains the path to the Java runtime executable
APPLICATION: contains the trailing part of the regular Java runtime invocation for that applications. For example,classname [arguments] for a single class startup, or -jar jarname [arguments] for a jar archive startup.
The optional additional environment variables that can be set are:
CLASSPATH: colon-separated list of jars or class files that need to be part of the application class path
DEFINES: string containing the define statements that need to be part of the application startup
PREFFACTORY: class name of the factory in the underlying Preferences API implementation that the application needs to use