org.openmrs.web

Class Listener

java.lang.Object

org.springframework.web.context.ContextLoader

org.springframework.web.context.ContextLoaderListener

org.openmrs.web.Listener

All Implemented Interfaces:

java.util.EventListener, javax.servlet.ServletContextListener

public final class Listener
extends org.springframework.web.context.ContextLoaderListener

Our Listener class performs the basic starting functions for our webapp. Basic needs for starting the API: 1) Get the runtime properties 2) Start Spring 3) Start the OpenMRS APi (via Context.startup) Basic startup needs specific to the web layer: 1) Do the web startup of the modules 2) Copy the custom look/images/messages over into the web layer

Field Summary

Fields inherited from class org.springframework.web.context.ContextLoader

CONFIG_LOCATION_PARAM, CONTEXT_CLASS_PARAM, CONTEXT_ID_PARAM, CONTEXT_INITIALIZER_CLASSES_PARAM, LOCATOR_FACTORY_KEY_PARAM, LOCATOR_FACTORY_SELECTOR_PARAM

Constructor Summary

Constructors

Constructor and Description
Listener()

Method Summary

Modifier and Type	Method and Description
void	contextDestroyed(javax.servlet.ServletContextEvent event) Called when the webapp is shut down properly Must call Context.shutdown() and then shutdown all the web layers of the modules
void	contextInitialized(javax.servlet.ServletContextEvent event) This method is called when the servlet context is initialized(when the Web Application is deployed).
static boolean	errorOccurredAtStartup() Boolean flag set by the contextInitialized(ServletContextEvent) method if an error occurred when trying to start up.
static java.lang.Throwable	getErrorAtStartup() Get the error thrown at startup
static java.util.Properties	getRuntimeProperties() Finds and loads the runtime properties
static void	loadBundledModules(javax.servlet.ServletContext servletContext) Load the pre-packaged modules from web/WEB-INF/bundledModules.
static void	performWebStartOfModules(java.util.Collection<Module> startedModules, javax.servlet.ServletContext servletContext)
static void	performWebStartOfModules(javax.servlet.ServletContext servletContext) Call WebModuleUtil.startModule on each started module
static boolean	runtimePropertiesFound() Boolean flag set on webapp startup marking whether there is a runtime properties file or not.
static void	startOpenmrs(javax.servlet.ServletContext servletContext) Do the work of starting openmrs.

Methods inherited from class org.springframework.web.context.ContextLoaderListener

createContextLoader, getContextLoader

Methods inherited from class org.springframework.web.context.ContextLoader

closeWebApplicationContext, configureAndRefreshWebApplicationContext, createWebApplicationContext, createWebApplicationContext, customizeContext, determineContextClass, determineContextInitializerClasses, getCurrentWebApplicationContext, initWebApplicationContext, loadParentContext

Methods inherited from class java.lang.Object

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

Constructor Detail

Listener

public Listener()

Method Detail

runtimePropertiesFound

public static boolean runtimePropertiesFound()

Boolean flag set on webapp startup marking whether there is a runtime properties file or not. If there is not, then the InitializationFilter takes over any openmrs url and redirects to the #SETUP_PAGE_URL

Returns:

true/false whether an openmrs runtime properties file is defined

errorOccurredAtStartup

public static boolean errorOccurredAtStartup()

Boolean flag set by the contextInitialized(ServletContextEvent) method if an error occurred when trying to start up. The StartupErrorFilter displays the error to the admin

Returns:

true/false if an error occurred when starting up

getErrorAtStartup

public static java.lang.Throwable getErrorAtStartup()

Get the error thrown at startup

Returns:

get the error thrown at startup

contextInitialized

public void contextInitialized(javax.servlet.ServletContextEvent event)

This method is called when the servlet context is initialized(when the Web Application is deployed). You can initialize servlet context related data here.

Specified by:

contextInitialized in interface javax.servlet.ServletContextListener

Overrides:

contextInitialized in class org.springframework.web.context.ContextLoaderListener

Parameters:

event -

startOpenmrs

public static void startOpenmrs(javax.servlet.ServletContext servletContext)
                         throws javax.servlet.ServletException

Do the work of starting openmrs.

Parameters:

servletContext -

Throws:

javax.servlet.ServletException

loadBundledModules

public static void loadBundledModules(javax.servlet.ServletContext servletContext)

Load the pre-packaged modules from web/WEB-INF/bundledModules.

This method assumes that the api startup() and WebModuleUtil.startup() will be called later for modules that loaded here

Parameters:

servletContext - the current servlet context for the webapp

contextDestroyed

public void contextDestroyed(javax.servlet.ServletContextEvent event)

Called when the webapp is shut down properly Must call Context.shutdown() and then shutdown all the web layers of the modules

Specified by:

contextDestroyed in interface javax.servlet.ServletContextListener

Overrides:

contextDestroyed in class org.springframework.web.context.ContextLoaderListener

See Also:

ContextLoaderListener.contextDestroyed(javax.servlet.ServletContextEvent)

getRuntimeProperties

public static java.util.Properties getRuntimeProperties()

Finds and loads the runtime properties

Returns:

Properties

See Also:

OpenmrsUtil.getRuntimeProperties(String)

performWebStartOfModules

public static void performWebStartOfModules(javax.servlet.ServletContext servletContext)
                                     throws ModuleMustStartException,
                                            java.lang.Exception

Call WebModuleUtil.startModule on each started module

Parameters:

servletContext -

Throws:

ModuleMustStartException - if the context cannot restart due to a MandatoryModuleException or OpenmrsCoreModuleException

java.lang.Exception

performWebStartOfModules

public static void performWebStartOfModules(java.util.Collection<Module> startedModules,
                                            javax.servlet.ServletContext servletContext)
                                     throws ModuleMustStartException,
                                            java.lang.Exception

Throws:

ModuleMustStartException

java.lang.Exception