Package cz.auderis.tools.config

Provides mechanism for semantically safe access to configuration data.

See: Description

Interface Summary

Interface	Description
ConfigurationDataProvider	ResourceProvider
DataTranslator	DataTranslator defines a mechanism by which an arbitrary object is translated into an instance of a given class.
DataTranslatorContext	DataTranslatorContext

Class Summary

Class	Description
ConfigurationData	ConfigurationData
StandardJavaTranslator	PrimitiveTranslator

Exception Summary

Exception	Description
ConfigurationDataException

Package cz.auderis.tools.config Description

Provides mechanism for semantically safe access to configuration data. The term "configuration data" represents data that are:

• Usually immutable during the application process life
• Represented by primitive entities (such as strings, numbers etc.) or low-level, less-structured classes, such as UUID, InetAddress and similar

The typical sources of configuration data may be for example property files, resource bundles, one-time queries to a database or LDAP, system properties and others.

This package allows turning regular interfaces into accessors of configuration data. This approach has several benefits:

• Programmer defines configuration entries semantics (data type + entry name) at compile time.
• Configuration entries may (should!) be documented via normal Javadoc.
• Usages of configuration entries may be found by usual IDE tools.
• Client of configuration data accessor doesn't have to be concerned with the actual source of configuration data.
• A certain level of intelligence is used to turn configuration data source values into requested data types. For example text-represented numbers would be correctly transformed to primitives.

Version:

1.0

Author:

Boleslav Bobcik <bbobcik@gmail.com>