org.openmrs.web.filter.update

Class UpdateFilter

java.lang.Object

org.openmrs.web.filter.StartupFilter

org.openmrs.web.filter.update.UpdateFilter

All Implemented Interfaces:

javax.servlet.Filter

public class UpdateFilter
extends StartupFilter

This is the second filter that is processed. It is only active when OpenMRS has some liquibase updates that need to be run. If updates are needed, this filter/wizard asks for a super user to authenticate and review the updates before continuing.

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
UpdateFilter()

Method Summary

Modifier and Type	Method and Description
protected boolean	authenticateAsSuperUser(String usernameOrSystemId, String password) Look in the users table for a user with this username and password and see if they have a role of OpenmrsConstants#SUPERUSER_ROLE.
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)
protected boolean	isSuperUser(Connection connection, Integer userId) Checks the given user to see if they have been given the OpenmrsConstants#SUPERUSER_ROLE role.
protected static void	setUpdatesRequired(boolean updatesRequired)
boolean	skipFilter(javax.servlet.http.HttpServletRequest httpRequest) If this returns true, this filter fails early and quickly.
static boolean	updatesRequired() Used by the Listener to know if this filter wants to do its magic

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

UpdateFilter

public UpdateFilter()

Method Detail

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

Throws:

IOException

javax.servlet.ServletException

See Also:

StartupFilter.doPost(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse)

authenticateAsSuperUser

protected boolean authenticateAsSuperUser(String usernameOrSystemId,
                                          String password)
                                   throws javax.servlet.ServletException

Look in the users table for a user with this username and password and see if they have a role of OpenmrsConstants#SUPERUSER_ROLE.

Parameters:

usernameOrSystemId - user entered username

password - user entered password

Returns:

true if this user has the super user role

Throws:

javax.servlet.ServletException

See Also:

isSuperUser(Connection, Integer)

Should:

return false if given invalid credentials, return false if given user is not superuser, return true if given user is superuser, not authorize retired superusers, authenticate with systemId

isSuperUser

protected boolean isSuperUser(Connection connection,
                              Integer userId)
                       throws Exception

Checks the given user to see if they have been given the OpenmrsConstants#SUPERUSER_ROLE role. This method does not look at child roles.

Parameters:

connection - the java sql connection to use

userId - the user id to look at

Returns:

true if the given user is a super user

Throws:

Exception

Should:

return true if given user has superuser role, return false if given user does not have the super user role

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)

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()

updatesRequired

public static boolean updatesRequired()

Used by the Listener to know if this filter wants to do its magic

Returns:

true if updates have been determined to be required

See Also:

init(FilterConfig), Listener.setupNeeded()

setUpdatesRequired

protected static void setUpdatesRequired(boolean updatesRequired)

Parameters:

updatesRequired - the updatesRequired to set

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()