org.openmrs.web.filter.initialization

Class InitializationFilter

java.lang.Object

org.openmrs.web.filter.StartupFilter

org.openmrs.web.filter.initialization.InitializationFilter

All Implemented Interfaces:

javax.servlet.Filter

public class InitializationFilter
extends StartupFilter

This is the first filter that is processed. It is only active when starting OpenMRS for the very first time. It will redirect all requests to the WebConstants.SETUP_PAGE_URL if the Listener wasn't able to find any runtime properties

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.commons.logging.Log	log

Fields inherited from class org.openmrs.web.filter.StartupFilter

errors, filterConfig, velocityEngine

Constructor Summary

Constructors

Constructor and Description
InitializationFilter()

Method Summary

Modifier and Type	Method and Description
protected void	doGet(javax.servlet.http.HttpServletRequest httpRequest, javax.servlet.http.HttpServletResponse httpResponse) Called by StartupFilter.doFilter(ServletRequest, ServletResponse, FilterChain) on GET requests
protected void	doPost(javax.servlet.http.HttpServletRequest httpRequest, javax.servlet.http.HttpServletResponse httpResponse) Called by StartupFilter.doFilter(ServletRequest, ServletResponse, FilterChain) on POST requests
protected Object	getModel() The model that is used as the backer for all pages in this startup wizard.
protected String	getTemplatePrefix() This string is prepended to all templateNames passed to StartupFilter.renderTemplate(String, Map, HttpServletResponse)
void	init(javax.servlet.FilterConfig filterConfig)
static boolean	initializationRequired() Public method that returns true if database+runtime properties initialization is required
protected void	setInitializationComplete(boolean initializationComplete)
boolean	skipFilter(javax.servlet.http.HttpServletRequest httpRequest) If this returns true, this filter fails early and quickly.

Methods inherited from class org.openmrs.web.filter.StartupFilter

destroy, doFilter, renderTemplate, toJSONString

Methods inherited from class java.lang.Object

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

Field Detail

log

protected final org.apache.commons.logging.Log log

Constructor Detail

InitializationFilter

public InitializationFilter()

Method Detail

setInitializationComplete

protected void setInitializationComplete(boolean initializationComplete)

doGet

protected void doGet(javax.servlet.http.HttpServletRequest httpRequest,
                     javax.servlet.http.HttpServletResponse httpResponse)
              throws IOException,
                     javax.servlet.ServletException

Called by StartupFilter.doFilter(ServletRequest, ServletResponse, FilterChain) on GET requests

Specified by:

doGet in class StartupFilter

Parameters:

httpRequest -

httpResponse -

Throws:

IOException

javax.servlet.ServletException

doPost

protected void doPost(javax.servlet.http.HttpServletRequest httpRequest,
                      javax.servlet.http.HttpServletResponse httpResponse)
               throws IOException,
                      javax.servlet.ServletException

Called by StartupFilter.doFilter(ServletRequest, ServletResponse, FilterChain) on POST requests

Specified by:

doPost in class StartupFilter

Parameters:

httpRequest -

httpResponse -

Throws:

IOException

javax.servlet.ServletException

getTemplatePrefix

protected String getTemplatePrefix()

Description copied from class: StartupFilter

This string is prepended to all templateNames passed to StartupFilter.renderTemplate(String, Map, HttpServletResponse)

Overrides:

getTemplatePrefix in class StartupFilter

Returns:

string to prepend as the path for the templates

See Also:

StartupFilter.getTemplatePrefix()

getModel

protected Object getModel()

Description copied from class: StartupFilter

The model that is used as the backer for all pages in this startup wizard. Should never return null.

Specified by:

getModel in class StartupFilter

Returns:

the stored formbacking/model object

See Also:

StartupFilter.getModel()

skipFilter

public boolean skipFilter(javax.servlet.http.HttpServletRequest httpRequest)

Description copied from class: StartupFilter

If this returns true, this filter fails early and quickly. All logic is skipped and startup and usage continue normally.

Specified by:

skipFilter in class StartupFilter

Returns:

true if this filter can be skipped

See Also:

org.openmrs.web.filter.StartupFilter#skipFilter()

initializationRequired

public static boolean initializationRequired()

Public method that returns true if database+runtime properties initialization is required

Returns:

true if this initialization wizard needs to run

init

public void init(javax.servlet.FilterConfig filterConfig)
          throws javax.servlet.ServletException

Specified by:

init in interface javax.servlet.Filter

Overrides:

init in class StartupFilter

Throws:

javax.servlet.ServletException

See Also:

Filter.init(javax.servlet.FilterConfig)