The Connector is generic connection to a data set, typically configuration
data in a hierarchical structure. Each connector object accepts the get(KEY)
method, which, when given a key, returns the associated value from the
connector's data source.
Typically, a connector acts as a proxy to a simple data source like
YAML, Config::Std, Config::Versioned, or to a more complex data source
like an LDAP server or Proc::SafeExec. The standard calling convention
via get(KEY) makes the connectors interchangeable.
In addition, a set of meta-connectors may be used to combine multiple
connectors into more complex chains. The Connector::Multi, for example,
allows for redirection to delegate connectors via symbolic links. If
you have a list of connectors and want to use them in a load-balancing,
round-robin fashion or have the list iterated until a value is found,
use Connector::List and choose the algorithm to perform.
# USAGE
In general, the following steps are needed (replace MODULENAME with the
name of the Connector module you need):
use Connector::MODULENAME;
my $conn = Connector::MODULENAME->new({
LOCATION => $path_to_config_for_module,
});
my $val = $conn->get('full.name.of.key');
See the POD for the modules as well as the test scripts for more details
and examples on the individual connectors.
