org.openmrs.web.filter.util

Class FilterUtil

java.lang.Object

org.openmrs.web.filter.util.FilterUtil

public class FilterUtil
extends Object

This class contains convenient methods for storing/retrieving locale parameters into/from DB as admin's user property and as default locale property for OpenMRS system

Field Summary

Fields

Modifier and Type	Field and Description
static String	ADMIN_USERNAME
static String	LOCALE_ATTRIBUTE
static String	REMEMBER_ATTRIBUTE

Method Summary

Modifier and Type	Method and Description
static String	getGlobalPropertyValue(String globalPropertyName) Gets the value of a global Property as a string from the database using sql, this method is useful when you want to get a value of a global property before the application context has been setup
static Integer	getUserIdByName(String userNameOrSystemId, Connection connection) This is a utility method that can be used for retrieving user id by given user name and sql connection
static String	readSystemDefaultLocale(Connection connection) This method uses passed in connection to load system default locale.
static String	restoreLocale(String username) Tries to retrieve location parameter.
static boolean	storeLocale(String locale) Stores selected by user locale into DB as admin's user property and as system default locale

Methods inherited from class java.lang.Object

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

Field Detail

LOCALE_ATTRIBUTE

public static final String LOCALE_ATTRIBUTE

See Also:

Constant Field Values

REMEMBER_ATTRIBUTE

public static final String REMEMBER_ATTRIBUTE

See Also:

Constant Field Values

ADMIN_USERNAME

public static final String ADMIN_USERNAME

See Also:

Constant Field Values

Method Detail

restoreLocale

public static String restoreLocale(String username)

Tries to retrieve location parameter. First this method makes an attempt to load locale parameter as user's property. And next, if user's property is empty it tries to retrieve default system locale (i.e system global property). If it also is empty it uses default value for system locale

Parameters:

username - the name of the administrative user whose default locale property will be restored

Returns:

string with stored location parameter or default OpenMRS locale property's value

readSystemDefaultLocale

public static String readSystemDefaultLocale(Connection connection)

This method uses passed in connection to load system default locale. If connection is passed as null it creates separate connection that should be closed before return from method

Parameters:

connection - (optional) the jdbc connection to be used for extracting default locale

Returns:

the string that contains system default locale or null

storeLocale

public static boolean storeLocale(String locale)

Stores selected by user locale into DB as admin's user property and as system default locale

Parameters:

locale - the selected by user language

Returns:

true if locale was stored successfully

getUserIdByName

public static Integer getUserIdByName(String userNameOrSystemId,
                                      Connection connection)
                               throws SQLException

This is a utility method that can be used for retrieving user id by given user name and sql connection

Parameters:

userNameOrSystemId - the name of user

connection - the java sql connection to use

Returns:

not null id of given user in case of success or null otherwise

Throws:

SQLException

getGlobalPropertyValue

public static String getGlobalPropertyValue(String globalPropertyName)

Gets the value of a global Property as a string from the database using sql, this method is useful when you want to get a value of a global property before the application context has been setup

Parameters:

globalPropertyName - the name of the global property

Returns:

the global property value