Package org.itracker.services

Interface ConfigurationService

All Superinterfaces:

org.itracker.core.resources.ITrackerResourcesProvider

All Known Implementing Classes:

ConfigurationServiceImpl

public interface ConfigurationService
extends org.itracker.core.resources.ITrackerResourcesProvider

Manages the applications configuration properties.

Field Summary

Fields

Modifier and Type	Field	Description
static String	PNAME_SYSTEM_BASE_URL

Method Summary

Modifier and Type	Method	Description
boolean	configurationItemExists(org.itracker.model.Configuration configuration)
org.itracker.model.Configuration	createConfigurationItem(org.itracker.model.Configuration configuration)	Creates a Configuration.
org.itracker.model.CustomField	createCustomField(org.itracker.model.CustomField customField)	This method will create a new CustomField for persistance in the database.
org.itracker.model.CustomFieldValue	createCustomFieldValue(org.itracker.model.CustomFieldValue customFieldValue)	This method will create a new CustomFieldValue for persistance in the database.
org.itracker.model.ProjectScript	createProjectScript(org.itracker.model.ProjectScript projectScript)	This method will create a new project script for persistance in the database.
org.itracker.model.WorkflowScript	createWorkflowScript(org.itracker.model.WorkflowScript workflowScript)	This method will create a new workflow script for persistance in the database.
Map<String,List<String>>	getAvailableLanguages()
boolean	getBooleanProperty(String name, boolean defaultValue)	Load a configuration from application properties.
org.itracker.model.Configuration	getConfigurationItem(Integer id)	Load a configuration from database.
List<org.itracker.model.Configuration>	getConfigurationItemsByType(int type)	Deprecated. use getConfigurationItemsByType(Configuration.Type type)
List<org.itracker.model.Configuration>	getConfigurationItemsByType(int type, Locale locale)	Deprecated. use getConfigurationItemsByType(Configuration.Type type, Locale locale)
List<org.itracker.model.Configuration>	getConfigurationItemsByType(org.itracker.model.Configuration.Type type)	Returns all the configuration items of a particular type.
List<org.itracker.model.Configuration>	getConfigurationItemsByType(org.itracker.model.Configuration.Type type, Locale locale)	Returns all the configuration items of a particular type.
org.itracker.model.CustomField	getCustomField(Integer id)	This method will return the requested custom field.
List<org.itracker.model.CustomField>	getCustomFields()	This method will return all the custom fields defined in the system.
org.itracker.model.CustomFieldValue	getCustomFieldValue(Integer id)	This method will return the requested custom field value.
Map<String,String>	getDefinedKeys(String locale)
List<org.itracker.model.NameValuePair>	getDefinedKeysAsArray(String locale)
int	getIntegerProperty(String name, int defaultValue)	Load a configuration from application properties.
String	getJndiPropertiesOverridePrefix()	The JNDI context where the configuration.properties values can be overridden.
org.itracker.model.Language	getLanguageItemByKey(String key, Locale locale)	This method will return the translation for a particular key in a locale.
List<org.itracker.model.Language>	getLanguageItemsByKey(String key)	This method will return all the translations for a particular key.
Properties	getLanguageProperties(Locale locale)
String	getLanguageValue(String key, Locale locale)
long	getLongProperty(String name, long defaultValue)	Load a configuration from application properties.
String	getMailSessionLookupName()	The JNDI lookup name for the mail-session.
int	getNumberAvailableLanguages()
int	getNumberDefinedKeys(String locale)
org.itracker.model.ProjectScript	getProjectScript(Integer id)	This method will return the requested project script.
List<org.itracker.model.ProjectScript>	getProjectScripts()	This method will return all defined project scripts.
String	getProperty(String name)	Load a configuration from application properties.
String	getProperty(String name, String defaultValue)	Load a configuration from application properties.
String[]	getSortedKeys()	Returns all of the keys currently defined in the base locale sorted and grouped in a logical manner.
String	getSystemBaseURL()
org.itracker.model.SystemConfiguration	getSystemConfiguration(Locale locale)	This method will return the current configuration of the system.
org.itracker.model.WorkflowScript	getWorkflowScript(Integer id)	This method will return the requested workflow script.
List<org.itracker.model.WorkflowScript>	getWorkflowScripts()	This method will return all defined workflow scripts.
void	initializeAllLanguages(boolean forceReload)	This method will attempt to load all of the locales defined in the ITracker.properties file, and add them to the database if they don't already exist.
void	initializeConfiguration()	This method will load the some default system configuration data into the database.
boolean	initializeLocale(String locale, boolean forceReload)	This method will load the specified locale.
boolean	isConfigurationItemUpToDate(org.itracker.model.Configuration configuration)
void	removeConfigurationItem(Integer id)	This method will remove the configuration item with the supplied id.
void	removeConfigurationItems(int type)	Deprecated. use removeConfigurationItems(Configuration.Type type)
void	removeConfigurationItems(org.itracker.model.Configuration configuration)	This method will remove all configuration items that match the supplied models type and value.
void	removeConfigurationItems(org.itracker.model.Configuration.Type type)	This method will remove all configuration items that match the supplied type.
boolean	removeCustomField(Integer customFieldId)	Removes a single custom field from the database.
boolean	removeCustomFieldValue(Integer customFieldValueId)	Removes a single custom field value from the database.
boolean	removeCustomFieldValues(Integer customFieldId)	Removes all custom field values from the database for a single custom field.
void	removeLanguageItem(org.itracker.model.Language language)
boolean	removeLanguageKey(String key)	This method will remove all language items with the supplied key regardless of locale.
void	removeProjectScript(Integer id)	This method removes a project script in the database.
void	removeWorkflowScript(Integer id)	This method removes a workflow script in the database.
void	resetConfigurationCache()	This method will reset any caches in the system of configuration items for all configuration item types.
void	resetConfigurationCache(int type)	Deprecated. use resetConfigurationCache(Configuration.Type type)
void	resetConfigurationCache(org.itracker.model.Configuration.Type type)	This method will reset any caches in the system of configuration items for the specified configuration item type.
void	setJndiPropertiesOverridePrefix(String jndiPropertiesOverridePrefix)
void	setMailSessionLookupName(String mailSessionLookupName)
org.itracker.model.Configuration	updateConfigurationItem(org.itracker.model.Configuration configuration)	This method updates a configuration item in the database.
List<org.itracker.model.Configuration>	updateConfigurationItems(List<org.itracker.model.Configuration> configurations, org.itracker.model.Configuration.Type type)	Updates the configuration items.
org.itracker.model.CustomField	updateCustomField(org.itracker.model.CustomField customField)	This method updates a custom field in the database.
org.itracker.model.CustomFieldValue	updateCustomFieldValue(org.itracker.model.CustomFieldValue customFieldValue)	This method updates a custom field value in the database.
List<org.itracker.model.CustomFieldValue>	updateCustomFieldValues(Integer customFieldId, List<org.itracker.model.CustomFieldValue> customFieldValues)	This method updates a set of custom field values in the database.
void	updateLanguage(Locale locale, List<org.itracker.model.Language> languages)
void	updateLanguage(Locale locale, List<org.itracker.model.Language> languages, org.itracker.model.Configuration config)
org.itracker.model.Language	updateLanguageItem(org.itracker.model.Language language)	Updates a translations for a particular key and locale.
org.itracker.model.ProjectScript	updateProjectScript(org.itracker.model.ProjectScript projectScript)	This method updates a project script in the database.
org.itracker.model.WorkflowScript	updateWorkflowScript(org.itracker.model.WorkflowScript workflowScript)	This method updates a workflow script in the database.

Methods inherited from interface org.itracker.core.resources.ITrackerResourcesProvider

getLanguageEntry

Field Detail

PNAME_SYSTEM_BASE_URL

static final String PNAME_SYSTEM_BASE_URL

See Also:

Constant Field Values

Method Detail

getProperty

String getProperty(String name)

Load a configuration from application properties.

Parameters:

name - configuration key

Returns:

the value from the configuration

getProperty

String getProperty(String name,
                   String defaultValue)

Load a configuration from application properties.

Specified by:

getProperty in interface org.itracker.core.resources.ITrackerResourcesProvider

Parameters:

name - configuration key

defaultValue - returned if the value is null

Returns:

the value from the configuration

getBooleanProperty

boolean getBooleanProperty(String name,
                           boolean defaultValue)

Load a configuration from application properties.

Parameters:

name - configuration key

defaultValue - returned if the value is null

Returns:

the boolean value from the configuration

getIntegerProperty

int getIntegerProperty(String name,
                       int defaultValue)

Load a configuration from application properties.

Parameters:

name - configuration key

defaultValue - returned if the value is null

Returns:

the integer value from the configuration

getLongProperty

long getLongProperty(String name,
                     long defaultValue)

Load a configuration from application properties.

Parameters:

name - configuration key

defaultValue - returned if the value is null

Returns:

the long value from the configuration

getConfigurationItem

org.itracker.model.Configuration getConfigurationItem(Integer id)

Load a configuration from database.

Parameters:

id - the row identifier

Returns:

the model from the configuration

getJndiPropertiesOverridePrefix

String getJndiPropertiesOverridePrefix()

The JNDI context where the configuration.properties values can be overridden.

Returns:

setJndiPropertiesOverridePrefix

void setJndiPropertiesOverridePrefix(String jndiPropertiesOverridePrefix)

getMailSessionLookupName

String getMailSessionLookupName()

The JNDI lookup name for the mail-session.

Returns:

setMailSessionLookupName

void setMailSessionLookupName(String mailSessionLookupName)

getConfigurationItemsByType

List<org.itracker.model.Configuration> getConfigurationItemsByType(int type)

Deprecated. use getConfigurationItemsByType(Configuration.Type type)

Returns all the configuration items of a particular type. The name values for all the items will not be initialized.

Parameters:

type - the type of configuration items to retrieve

Returns:

an array of ConfigurationModels

getConfigurationItemsByType

List<org.itracker.model.Configuration> getConfigurationItemsByType(org.itracker.model.Configuration.Type type)

Returns all the configuration items of a particular type. The name values for all the items will not be initialized.

Parameters:

type - the type of configuration items to retrieve

Returns:

an array of ConfigurationModels

getConfigurationItemsByType

List<org.itracker.model.Configuration> getConfigurationItemsByType(org.itracker.model.Configuration.Type type,
                                                                   Locale locale)

Returns all the configuration items of a particular type. The name values for all the items will not be initialized.

Parameters:

type - the type of configuration items to retrieve

locale - the locale to use when setting the configuration items name values

Returns:

an array of ConfigurationModels

getConfigurationItemsByType

List<org.itracker.model.Configuration> getConfigurationItemsByType(int type,
                                                                   Locale locale)

Deprecated. use getConfigurationItemsByType(Configuration.Type type, Locale locale)

Returns all the configuration items of a particular type. In addition, all of the configuration items name values will be initialized to the values for the supplied locale.

Parameters:

type - the type of configuration items to retrieve

locale - the locale to use when setting the configuration items name values

Returns:

an array of ConfigurationModels

createConfigurationItem

org.itracker.model.Configuration createConfigurationItem(org.itracker.model.Configuration configuration)

Creates a Configuration.

Parameters:

configuration - The Configuration to store

Returns:

the Configuration after saving

updateConfigurationItem

org.itracker.model.Configuration updateConfigurationItem(org.itracker.model.Configuration configuration)

This method updates a configuration item in the database.

Version will be fixed to current initialized version.

Parameters:

configuration - a Configuration of the item to update

Returns:

a Configuration with the updated item

updateConfigurationItems

List<org.itracker.model.Configuration> updateConfigurationItems(List<org.itracker.model.Configuration> configurations,
                                                                org.itracker.model.Configuration.Type type)

Updates the configuration items.

Version will be fixed to current initialized version.

Parameters:

configurations - the ConfigurationModels to update

type - The type of the ConfigurationItems to update

Returns:

an array with the saved models

configurationItemExists

boolean configurationItemExists(org.itracker.model.Configuration configuration)

isConfigurationItemUpToDate

boolean isConfigurationItemUpToDate(org.itracker.model.Configuration configuration)

removeConfigurationItem

void removeConfigurationItem(Integer id)

This method will remove the configuration item with the supplied id.

Parameters:

id - the id of the configuration information to remove

removeConfigurationItems

void removeConfigurationItems(int type)

Deprecated. use removeConfigurationItems(Configuration.Type type)

This method will remove all configuration items that match the supplied type. This will remove all items of that type such as all system status values.

Parameters:

type - the type of configuration information to remove

removeConfigurationItems

void removeConfigurationItems(org.itracker.model.Configuration.Type type)

This method will remove all configuration items that match the supplied type. This will remove all items of that type such as all system status values.

Parameters:

type - the type of configuration information to remove

removeConfigurationItems

void removeConfigurationItems(org.itracker.model.Configuration configuration)

This method will remove all configuration items that match the supplied models type and value. This effectively eliminates all previous versions of the item. It is normally called prior to a create to remove any older copies of this item.

Parameters:

configuration - the model to determine the type and value from

resetConfigurationCache

void resetConfigurationCache()

This method will reset any caches in the system of configuration items for all configuration item types.

resetConfigurationCache

void resetConfigurationCache(int type)

Deprecated. use resetConfigurationCache(Configuration.Type type)

This method will reset any caches in the system of configuration items for the specified configuration item type.

Parameters:

type - the type of configuration item to reset in any caches

resetConfigurationCache

void resetConfigurationCache(org.itracker.model.Configuration.Type type)

This method will reset any caches in the system of configuration items for the specified configuration item type.

Parameters:

type - the type of configuration item to reset in any caches

getProjectScript

org.itracker.model.ProjectScript getProjectScript(Integer id)

This method will return the requested project script.

Parameters:

id - the id of the requested script

Returns:

a ProjectScript with the requested script, or null if not found

getProjectScripts

List<org.itracker.model.ProjectScript> getProjectScripts()

This method will return all defined project scripts.

Returns:

a ProjectScript array with all defined scripts

createProjectScript

org.itracker.model.ProjectScript createProjectScript(org.itracker.model.ProjectScript projectScript)

This method will create a new project script for persistance in the database.

Parameters:

projectScript - the model to create the script from

updateProjectScript

org.itracker.model.ProjectScript updateProjectScript(org.itracker.model.ProjectScript projectScript)

This method updates a project script in the database.

Parameters:

projectScript - a ProjectScript of the item to update

Returns:

a ProjectScript with the updated item

removeProjectScript

void removeProjectScript(Integer id)

This method removes a project script in the database.

Parameters:

id - The id of the project script

getWorkflowScript

org.itracker.model.WorkflowScript getWorkflowScript(Integer id)

This method will return the requested workflow script.

Parameters:

id - the id of the requested script

Returns:

a WorkflowScript with the requested script, or null if not found

getWorkflowScripts

List<org.itracker.model.WorkflowScript> getWorkflowScripts()

This method will return all defined workflow scripts.

Returns:

a WorkflowScript array with all defined scripts

createWorkflowScript

org.itracker.model.WorkflowScript createWorkflowScript(org.itracker.model.WorkflowScript workflowScript)

This method will create a new workflow script for persistance in the database.

Parameters:

workflowScript - the model to create the script from

updateWorkflowScript

org.itracker.model.WorkflowScript updateWorkflowScript(org.itracker.model.WorkflowScript workflowScript)

This method updates a workflow script in the database.

Parameters:

workflowScript - a WorkflowScript of the item to update

Returns:

a WorkflowScript with the updated item

removeWorkflowScript

void removeWorkflowScript(Integer id)

This method removes a workflow script in the database.

Parameters:

id - The id of the workflow script

getCustomField

org.itracker.model.CustomField getCustomField(Integer id)

This method will return the requested custom field.

Parameters:

id - the id of the requested field

Returns:

a CustomField with the requested field, or null if not found

getCustomFields

List<org.itracker.model.CustomField> getCustomFields()

This method will return all the custom fields defined in the system.

Returns:

an array of CustomFieldModels

createCustomField

org.itracker.model.CustomField createCustomField(org.itracker.model.CustomField customField)

This method will create a new CustomField for persistance in the database. If the field includes a set of option values, those will be created also.

Parameters:

customField - the model to create the field from

updateCustomField

org.itracker.model.CustomField updateCustomField(org.itracker.model.CustomField customField)

This method updates a custom field in the database. It does not include any updates to language items that would be used to display the localized label for the field. If any options are included, the list will be used to replace any existing options.

Parameters:

customField - a CustomField of the item to update

Returns:

a CustomField with the updated item

removeCustomField

boolean removeCustomField(Integer customFieldId)

Removes a single custom field from the database.

Parameters:

customFieldId - the id of the custom field to remove

getCustomFieldValue

org.itracker.model.CustomFieldValue getCustomFieldValue(Integer id)

This method will return the requested custom field value.

Parameters:

id - the id of the requested field value

Returns:

a CustomField with the requested field value, or null if not found

createCustomFieldValue

org.itracker.model.CustomFieldValue createCustomFieldValue(org.itracker.model.CustomFieldValue customFieldValue)

This method will create a new CustomFieldValue for persistance in the database.

Parameters:

customFieldValue - the model to create the field from

updateCustomFieldValue

org.itracker.model.CustomFieldValue updateCustomFieldValue(org.itracker.model.CustomFieldValue customFieldValue)

This method updates a custom field value in the database. It does not include any updates to language items that would be used to display the localized label for the field value.

Parameters:

customFieldValue - a CustomFieldValue of the item to update

Returns:

a CustomFieldValue with the updated item

updateCustomFieldValues

List<org.itracker.model.CustomFieldValue> updateCustomFieldValues(Integer customFieldId,
                                                                  List<org.itracker.model.CustomFieldValue> customFieldValues)

This method updates a set of custom field values in the database. If the array of values is null or zero length, it will remove all existing values from the custom field. Otherwise it will update the value and sort order of all the values. If the array of models contains more or less values than the current custom field, it will not remove theose values, or create new values.

Parameters:

customFieldId - the id of the custom field to update

customFieldValues - an array of CustomFieldValueModels to update

Returns:

a array of CustomFieldValueModels with the updated items

removeCustomFieldValue

boolean removeCustomFieldValue(Integer customFieldValueId)

Removes a single custom field value from the database.

Parameters:

customFieldValueId - the id of the custom field value to remove

removeCustomFieldValues

boolean removeCustomFieldValues(Integer customFieldId)

Removes all custom field values from the database for a single custom field.

Parameters:

customFieldId - the id of the custom field to remove the values for

getLanguageItemByKey

org.itracker.model.Language getLanguageItemByKey(String key,
                                                 Locale locale)

This method will return the translation for a particular key in a locale.

Parameters:

key - the key to look up

locale - the localue to translate the key for

Returns:

a Language with the translation

getLanguageItemsByKey

List<org.itracker.model.Language> getLanguageItemsByKey(String key)

This method will return all the translations for a particular key.

Parameters:

key - the key to look up

Returns:

an array of LanguageModels with the translations for the key

updateLanguageItem

org.itracker.model.Language updateLanguageItem(org.itracker.model.Language language)

Updates a translations for a particular key and locale.

Parameters:

language - A Language for the key to update

Returns:

a Language with the updated translation

removeLanguageKey

boolean removeLanguageKey(String key)

This method will remove all language items with the supplied key regardless of locale.

Parameters:

key - the key to remove

removeLanguageItem

void removeLanguageItem(org.itracker.model.Language language)

getSystemConfiguration

org.itracker.model.SystemConfiguration getSystemConfiguration(Locale locale)

This method will return the current configuration of the system.

Returns:

a SystemConfiguration with the current configuration of the system

getSortedKeys

String[] getSortedKeys()

Returns all of the keys currently defined in the base locale sorted and grouped in a logical manner.

getDefinedKeys

Map<String,String> getDefinedKeys(String locale)

getDefinedKeysAsArray

List<org.itracker.model.NameValuePair> getDefinedKeysAsArray(String locale)

getNumberDefinedKeys

int getNumberDefinedKeys(String locale)

getAvailableLanguages

Map<String,List<String>> getAvailableLanguages()

getNumberAvailableLanguages

int getNumberAvailableLanguages()

getLanguageProperties

Properties getLanguageProperties(Locale locale)

Specified by:

getLanguageProperties in interface org.itracker.core.resources.ITrackerResourcesProvider

updateLanguage

void updateLanguage(Locale locale,
                    List<org.itracker.model.Language> languages)

updateLanguage

void updateLanguage(Locale locale,
                    List<org.itracker.model.Language> languages,
                    org.itracker.model.Configuration config)

initializeLocale

boolean initializeLocale(String locale,
                         boolean forceReload)

This method will load the specified locale. It will look for the appropriate properties file, and then load all of the resources into the database.

Parameters:

locale - the locale to load

forceReload - if true, it will reload the languages from the property file even if it is listed as being up to date

initializeConfiguration

void initializeConfiguration()

This method will load the some default system configuration data into the database. The values it loads are determined from the base ITracker.properties file so the language initialization must be performed before this method is called.

getSystemBaseURL

String getSystemBaseURL()

getLanguageValue

String getLanguageValue(String key,
                        Locale locale)

initializeAllLanguages

void initializeAllLanguages(boolean forceReload)

This method will attempt to load all of the locales defined in the ITracker.properties file, and add them to the database if they don't already exist.

Parameters:

forceReload - if true, it will reload the languages from the property files even if they are listed as being up to date