org.intelligentsia.keystone.boot

Class BootStrap

java.lang.Object

org.intelligentsia.keystone.boot.BootStrap

public final class BootStrap
extends Object

BootStrap class.

DONT FORGET: LIMIT THIS CLASS TO BOOTSTRAP AND NOTHING MORE!! According on this first sentence, i have added a system for extracting inner resources, and option for restarting system... *_*

BASIC Structure: ${home}/lib all libraries contained in single jar file (under META-INF/lib and/or /lib folder of this single jar)

if ${home} is not writable, system will use jvm.temp.dir\{} as home folder. In this case, update is not supported yet.

Option that you could set on command line with a "--name=value" or in a properties files:

Delegated main class

• Main-Class=java main class, mandatory

Locale directory management:

• BootStrap.explodeDirectory=if specified use this directory to explode innerjar libraries. Use home per default.
• BootStrap.cleanUpLib=true|false (default true) clean up local 'lib' file system on startup
• BootStrap.cleanUpBeforeShutdown=true|false (default false) clean up all file when system shutdown.

Log information

• BootStrap.verbose=true|false (default false) activate 'verbose' mode
• BootStrap.info=true|false (default true) activate 'info' mode
• BootStrap.logFile=log file of bootstrap (default is none)

Class Path management

• BootStrap.extraLibrariesFolderPath = folder path of external libraries , in order to include them on classpath. Even if keystone is used to pack all dependencies in a single archive, many project needs adding extra dependencies on their classpath as specific database driver etc...
• BootStrap.includeJavaHomeLib=true|false (default false) include java home libraries
• BootStrap.includeSystemClassLoader=true|false (default true) include system class loader

JVM Specification Version can be checked with parameter: 'BootStrap.minimalJvmVersion'. If current JVM is not backward compatible, the system halt.

Configuration priority (high to less):

• from command line with --....
• from file:keystone.properties
• from classpath:keystone.properties
• from classpath:META-INF/keystone.properties

BootStrap set two system properties:

• BootStrap.location=full path of the booted jar
• BootStrap.home= home directory
• BootStrap.keystone.version=keystone version used/li>
• BootStrap.project.version=inner project version

Delegated main class can manage restart of system by throw a KeystonException with "restart" or "clean" operation string".

Main class should be in this case:

public static int main(final String[] args) { throw new KeystoneException(KeystoneException.Operation.RESTART); }

An update process can set system properties "BootStrap.location" with the new jar and restart on it

Author:

Jerome Guibert

Constructor Summary

Constructors

Constructor and Description
BootStrap()

Method Summary

Methods

Modifier and Type	Method and Description
static Throwable	findRootCause(Throwable throwable) Get Root Cause.
static void	main(String[] args) Main methods.
static void	processKeystoneException(File home, Throwable exception) Process Keystone Exception
static void	restart(Runnable runnable) Restart all system using value of system property "BootStrap.location".

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BootStrap

public BootStrap()

Method Detail

main

public static void main(String[] args)
                 throws IOException

Main methods.

Parameters:

args -

Throws:

IOException - if something is wrong when reading properties files.

processKeystoneException

public static void processKeystoneException(File home,
                            Throwable exception)

Process Keystone Exception

Parameters:

home -

throwable -

findRootCause

public static Throwable findRootCause(Throwable throwable)

Get Root Cause.

Parameters:

throwable -

Returns:

root cause.

restart

public static void restart(Runnable runnable)

Restart all system using value of system property "BootStrap.location". This property can be updated by delegated Main class, after an update for example.

Parameters:

runnable - runnable class before restarting.