File Information
Library: Util
Package: Configuration
Header: Poco/Util/ConfigurationView.h
Description
This configuration implements a "view" into a sub-hierarchy of another configuration.
For example, given a configuration with the following properties:
config.value1 config.value2 config.sub.value1 config.sub.value2
and a ConfigurationView with the prefix "config", then the above properties will be available via the view as
value1 value2 sub.value1 sub.value2
A ConfigurationView is most useful in combination with a LayeredConfiguration.
If a property is not found in the view, it is searched in the original configuration. Given the above example configuration, the property named "config.value1" will still be found in the view.
The main reason for this is that placeholder expansion (${property}) still works as expected given a ConfigurationView.
Inheritance
Direct Base Classes: AbstractConfiguration
All Base Classes: Poco::RefCountedObject, AbstractConfiguration
Member Summary
Member Functions: enumerate, getRaw, removeRaw, setRaw, translateKey
Inherited Functions: createLocalView, createView, duplicate, enableEvents, enumerate, eventsEnabled, expand, getBool, getDouble, getInt, getInt16, getInt32, getInt64, getRaw, getRawString, getString, getUInt, getUInt16, getUInt32, getUInt64, has, hasOption, hasProperty, keys, parseBool, parseInt, parseInt16, parseInt64, parseUInt, parseUInt16, parseUInt64, referenceCount, release, remove, removeRaw, setBool, setDouble, setInt, setInt16, setInt32, setInt64, setRaw, setRawWithEvent, setString, setUInt, setUInt16, setUInt32, setUInt64
Constructors
ConfigurationView
ConfigurationView(
const std::string & prefix,
AbstractConfiguration::Ptr pConfig
);
Creates the ConfigurationView. The ConfigurationView retains (shared) ownership of the passed configuration.
Destructor
~ConfigurationView
Member Functions
enumerate
void enumerate(
const std::string & key,
Keys & range
) const;
getRaw
bool getRaw(
const std::string & key,
std::string & value
) const;
removeRaw
void removeRaw(
const std::string & key
);
setRaw
void setRaw(
const std::string & key,
const std::string & value
);
translateKey
std::string translateKey(
const std::string & key
) const;