Copyright (c) 2004-2010 Oracle Corporation.
All rights reserved. This program and the accompanying materials
are made available under the terms of the Eclipse Public License v1.0
which accompanies this distribution, and is available at
Entry point for web applications.
Applications that use stapler can use this as the base class,
and then register that as the servlet context listener.
The type of the root object instance
- Kohsuke Kawaguchi
Once the home directory is determined, this value is set to that directory.
Returns the application name, like "Hudson" or "Torricelli".
The method should always return the same value. The name
should only contain alpha-numeric character.
If the root application object is loaded asynchronously,
override this method to return the place holder object
to serve the request in the mean time.
- null to synchronously load the application object.
Creates the root application object.
Sets the root application object.
Performs pre start-up environment check.
- false if a check fails. Webapp will fail to boot in this case.
Determines the home directory for the application.
People makes configuration mistakes, so we are trying to be nice
with those by doing
If no home directory is configured, this method is called
to determine the default location, which is "~/.appname".
Override this method to change that behavior.
Called during the destructino of the web app to perform
any clean up act on the application object.