- Introspection methods
- Information management
- SEE ALSO
- COPYRIGHT AND LICENSE
Config::Model::AnyThing - Base class for configuration tree item
# internal class
This class must be inherited by all nodes or leaves of the configuration tree.
AnyThing provides some methods and no constructor.
Returns the element name that contain this object.
For object stored in an array or hash element, returns the index (or key) containing this object.
Returns the node containing this object. May return undef if
parent() is called on the root of the tree.
Returns the type (e.g.
warped_node) of the element containing this object.
Returns the root node of the configuration tree.
Returns the node location in the configuration tree. This location conforms with the syntax defined by "grab()" method.
Returns the node location in the configuration tree. This location truncates long indexes to be readable. It cannot be used by "grab()" method.
Return the element name with its index (if any). I.e. returns
Return the element name with its index (if any). Too long indexes are truncated to be readable.
Annotation is a way to store miscellaneous information associated to each node. (Yeah... comments). Reading and writing annotation makes sense only if they can be read from and written to the configuration file, hence the need for the following method:
Returns 1 if at least one of the backends attached to a parent node support to read and write annotations (aka comments) in the configuration file.
Returns 1 if at least one of the backends support to read and write annotations (aka comments) in the configuration file.
annotation( [ note1, [ note2 , ... ] ] )
Without argument, return a string containing the object's annotation (or an empty string).
With several arguments, join the arguments with "\n", store the annotations and return the resulting string.
load_pod_annotation ( pod_string )
Load annotations in configuration tree from a pod document. The pod must be in the form:
=over =item path Annotation text =back
Clear the annotation of an element
Grab an object from the configuration tree.
A string indicating the steps to follow in the tree to find the required item. (mandatory)
When set to
grabwill throw an exception if no object is found using the passed string. When set to
adaptative, the object found at last will be returned. For instance, for the step
good_step wrong_step, only the object held by
good_stepwill be returned. When set to
loose, grab will return undef in case of problem. (default is
listor an array ref containing these values. Returns only an object of requested type. Depending on
grabwill either throw an exception or return the last found object of requested type. (optional, default to
undef, which means any type of object)
$root->grep(step => 'foo:2 bar', type => 'leaf') $root->grep(step => 'foo:2 bar', type => ['leaf','check_list'])
When set to 1,
listconfiguration element are created when requested by the passed steps. (default is 1).
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).
step parameters is made of the following items separated by spaces:
Go up one node
Go to the root node.
Go up the configuration tree until the
Fooconfiguration class is found. Raise an exception if no
Fooclass is found when root node is reached.
Go down using
Go down using
xxxelement and id
yy(valid for hash or list elements)
Go up the tree until a node containing element
xxxis found. Then go down the tree like item
?xxx:yy, go up the tree the same way. But no check is done to see if id
yyactually exists or not. Only the element
xxxis considered when going up the tree.
Like "grab(...)", but will return the value of a leaf or check_list object, not just the leaf object.
Will raise an exception if following the steps ends on anything but a leaf or a check_list.
Like "grab(...)", but will return the annotation of an object.
Returns the root of the configuration tree.
grab_ancestor( Foo )
Go up the configuration tree until the
Foo configuration class is found. Returns the found node or undef.
Notify the instance of semantic changes. Parameters are:
old value. (optional)
new value (optional)
Location of the changed parameter starting from root node. Default to
element name. Default to
If the changed parameter is part of a hash or an array,
indexcontains the key or the index to get the changed parameter.
information about the change. Mandatory of neither old or new value are defined.
When set to 1, force recording of change even if in initial load phase.
show_message( string )
Forwarded to "show_message( string )" in Config::Model::Instance.
Returns an object dedicated to search an element in the configuration model (respecting privilege level).
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.
Returns a string describing any issue with Config::Model::Warper object. Returns '' if invoked on a tree object without warp specification.
Dominique Dumont, (ddumont at cpan dot org)
COPYRIGHT AND LICENSE
This software is Copyright (c) 2015 by Dominique Dumont.
This is free software, licensed under:
The GNU Lesser General Public License, Version 2.1, February 1999