com.github.dandelion.datatables.core.config

Class ConfigLoader

java.lang.Object

com.github.dandelion.datatables.core.config.ConfigLoader

public class ConfigLoader
extends Object

Dandelion-Datatables configuration loader.

Since:

0.9.0

Author:

Thibault Duchateau

See Also:

DatatableConfigurator

Field Summary

Fields

Modifier and Type	Field and Description
static String	DANDELION_DT_CONFIGURATION
static String	DEFAULT_GROUP_NAME
static String	DT_DEFAULT_PROPERTIES
static String	DT_USER_PROPERTIES
static String	DT_USER_PROPERTIES_LOCATION
static String	I18N_LOCALE_RESOLVER
static String	I18N_MESSAGE_RESOLVER
static String	STANDALONE_BUNDLES_TO_EXCLUDE

Constructor Summary

Constructors

Constructor and Description
ConfigLoader()

Method Summary

Methods

Modifier and Type	Method and Description
Properties	getUserProperties() TODO
Properties	loadDefaultConfiguration() Load the default configuration from the internal properties file and both: stores the properties inside a class field returns the properties if they need to be used outside of the class
Properties	loadUserConfiguration(Locale locale) Load the user configuration which can be localized thanks to the given locale.
void	resolveConfigurations(Map<String,Map<com.github.dandelion.core.option.Option<?>,Object>> map, Locale locale, javax.servlet.http.HttpServletRequest request) Resolve configuration groups for the given locale.
Set<String>	resolveGroups(Locale locale) Return a set containing all configuration groups.

Methods inherited from class java.lang.Object

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

Field Detail

DANDELION_DT_CONFIGURATION

public static final String DANDELION_DT_CONFIGURATION

See Also:

Constant Field Values

DT_DEFAULT_PROPERTIES

public static final String DT_DEFAULT_PROPERTIES

See Also:

Constant Field Values

DT_USER_PROPERTIES_LOCATION

public static final String DT_USER_PROPERTIES_LOCATION

See Also:

Constant Field Values

DT_USER_PROPERTIES

public static final String DT_USER_PROPERTIES

See Also:

Constant Field Values

DEFAULT_GROUP_NAME

public static final String DEFAULT_GROUP_NAME

See Also:

Constant Field Values

STANDALONE_BUNDLES_TO_EXCLUDE

public static final String STANDALONE_BUNDLES_TO_EXCLUDE

See Also:

Constant Field Values

I18N_LOCALE_RESOLVER

public static final String I18N_LOCALE_RESOLVER

See Also:

Constant Field Values

I18N_MESSAGE_RESOLVER

public static final String I18N_MESSAGE_RESOLVER

See Also:

Constant Field Values

Constructor Detail

ConfigLoader

public ConfigLoader()

Method Detail

loadDefaultConfiguration

public Properties loadDefaultConfiguration()

Load the default configuration from the internal properties file and both:

• stores the properties inside a class field
• returns the properties if they need to be used outside of the class

Returns:

the default properties

loadUserConfiguration

public Properties loadUserConfiguration(Locale locale)

Load the user configuration which can be localized thanks to the given locale.

Once the bundle loaded, it is converted into Properties.

Parameters:

locale - The current locale used to load the right properties file.

Returns:

the ResourceBundle containing the user configuration.

resolveGroups

public Set<String> resolveGroups(Locale locale)

Return a set containing all configuration groups.

Note that the i18n.locale.resolver is a special property that must not be taken into account because it is group-independent.

Parameters:

locale - The current locale.

Returns:

the resolved groups.

resolveConfigurations

public void resolveConfigurations(Map<String,Map<com.github.dandelion.core.option.Option<?>,Object>> map,
                         Locale locale,
                         javax.servlet.http.HttpServletRequest request)

Resolve configuration groups for the given locale.

The default properties file (datatables-default.properties) already contains the 'global' group: this is the group of configuration that is used for all tables in the application.

Inside the user properties files (datatables_XX.properties), users can:

• Override some properties of the 'global' group, by prefixing the property name with global.
• Create configuration groups, by prefixing the property name with the name of the group to create

For example, if the user properties file contains:
group1.i18n.msg.search=My label
group1.i18n.msg.processing=My other label

the ConfigLoader must create a group called 'group1' containing all properties present in the 'global' group but where i18n.msg.search and i18n.msg.processing are overriden with the user's ones.

Note that:

• A configuration group can be enabled locally in a table thanks to an tag attribute.
• A configuration group always extends the 'global' group.
• All properties must be prefixed by the group name (even for the 'global' group).

Parameters:

map - The map to update after the resolution of the configuration groups.

locale - The current locale used to get the right properties file from the resource bundle.

request - The request sent by the browser.

getUserProperties

public Properties getUserProperties()

TODO

Returns: