de.carne

Class ApplicationLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

de.carne.ApplicationLoader

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public final class ApplicationLoader
extends java.net.URLClassLoader

This class is the generic entry point for all kind of applications.

It provides the necessary services for setting up the execution environment and invoking the actual application code. Further more it acts as a ClassLoader and URLStreamHandlerFactory making 3rd party jars which are included in the application jar available to the application during runtime.

This class retrieves the actual application information from a file resource named ApplicationLoader which has be to be located in the application root resource folder. The first line of this resource defines the actual Main class to be loaded and executed. All remaining lines are considered as system properties that are set prior to loading and invoking the main class.

Method Summary

Modifier and Type	Method and Description
static java.util.jar.JarFile	getApplicationJarFile() Get the JarFile this application has been loaded from.
static java.net.URL	getDirectURL(java.net.URL u) Get the direct URL and remove a possibly existing resource re-direct.
java.lang.Class<?>	loadClass(java.lang.String name)
static void	main(java.lang.String[] args) Generic application main function.

Methods inherited from class java.net.URLClassLoader

addURL, close, definePackage, findClass, findResource, findResources, getPermissions, getResourceAsStream, getURLs, newInstance, newInstance

Methods inherited from class java.security.SecureClassLoader

defineClass, defineClass

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findLibrary, findLoadedClass, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getResource, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, registerAsParallelCapable, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Method Detail

getDirectURL

@Nullable
public static java.net.URL getDirectURL(java.net.URL u)

Get the direct URL and remove a possibly existing resource re-direct.

By using this function the application can provide resource access via one of the JDK's standard URLStreamHandler classes for code that cannot handle our custom URLStreamHandler.

Parameters:

u - The URL to get the direct URL.

Returns:

The native resource URL or null if the resource does not exist.

loadClass

public java.lang.Class<?> loadClass(@Nullable
                                    java.lang.String name)
                             throws java.lang.ClassNotFoundException

Overrides:

loadClass in class java.lang.ClassLoader

Throws:

java.lang.ClassNotFoundException

getApplicationJarFile

@Nullable
public static java.util.jar.JarFile getApplicationJarFile()
                                                             throws java.io.IOException

Get the JarFile this application has been loaded from.

Returns:

The JarFile, or null if the application was not loaded from a release Jar.

Throws:

java.io.IOException - if an I/O error occurs while opening the Jar.

main

public static void main(java.lang.String[] args)

Generic application main function.

Parameters:

args - The application's command line.