NAME

Config::Model::AnyThing - Base class for configuration tree item

VERSION

version 1.232

SYNOPSIS

package Config::Model::Node ;
use base qw/Config::Model::AnyThing/ ;

DESCRIPTION

This class must be inherited by all nodes or leaves of the configuration tree.

AnyThing provides some methods and no constructor.

Introspection methods

element_name()

Returns the element name that contain this object.

index_value()

For object stored in an array or hash element, returns the index (or key) containing this object.

parent()

Returns the node containing this object. May return undef if parent() is called on the root of the tree.

get_container_type()

Returns the type (e.g. list or hash or leaf or node or warped_node) of the element containing this object.

root()

Returns the root node of the configuration tree.

location()

Returns the node location in the configuration tree. This location conforms with the syntax defined by "grab()" method.

composite_name

Return the element name with its index (if any). I.e. returns foo:bar or foo.

Annotation

Annotation is a way to store miscellaneous information associated to each node. (Yeah... comments) These comments will be saved outside of the configuration file and restored the next time the command is run.

annotation( [ note1, [ note2 , ... ] ] )

Without argument, return a string containing the object's annotation.

With several arguments, join the arguments with "\n", store the annotations and return the resulting string.

Information management

grab(...)

Grab an object from the configuration tree.

Parameters are:

step

A string indicating the steps to follow in the tree to find the required item. (mandatory)

strict

When set to 1, grab will throw an exception if no object is found using the passed string. When set to 0, the object found at last will be returned. For instance, for the step good_step wrong_step, only the object held by good_step will be returned. (default is 1)

type

Either node, leaf, hash or list. Returns only an object of requested type. Depending on strict value, grab will either throw an exception or return the last found object of requested type. (optional, default to undef, which means any type of object)

autoadd

When set to 1, hash or list configuration element are created when requested by the passed steps. (default is 1).

grab_non_available

When set to 1, grab will return an object even if this one is not available. I.e. even if this element was warped out. (default is 0).

The step parameters is made of the following items separated by spaces:

-

Go up one node

!

Go to the root node.

xxx

Go down using xxx element.

xxx:yy

Go down using xxx element and id yy (valid for hash or list elements)

?xxx

Go up the tree until a node containing element xxx is found. Then go down the tree like item xxx.

If ?xxx:yy, go up the tree the same way. But no check is done to see if id yy actually exists or not. Only the element xxx is considered when going up the tree.

grab_value(...)

Like "grab(...)", but will return the value of a leaf object, not just the leaf object.

Will raise an exception if following the steps ends on anything but a leaf.

grab_annotation(...)

Like "grab(...)", but will return the annotation of an object.

grab_root()

Returns the root of the configuration tree.

searcher ()

Returns an object dedicated to search an element in the configuration model (respecting privilege level).

This method returns a Config::Model::Searcher object. See Config::Model::Searcher for details on how to handle a search.

dump_as_data ( )

Dumps the configuration data of the node and its siblings into a perl data structure.

Returns a hash ref containing the data. See Config::Model::DumpAsData for details.

AUTHOR

Dominique Dumont, (ddumont at cpan dot org)

SEE ALSO

Config::Model, Config::Model::Instance, Config::Model::Node, Config::Model::Loader, Config::Model::Dumper

cpanm Config::Model

perl -MCPAN -e shell
install Config::Model