NAME
perfSONAR_PS::Datatypes::v2_0::nmwg::Message::Metadata - A base class, implements 'metadata' element from the perfSONAR_PS RelaxNG schema
DESCRIPTION
Object representation of the metadata element.
Object fields are:
Scalar: metadataIdRef,
Scalar: id,
Object reference: subject => type ARRAY,
Object reference: parameters => type ARRAY,
Object reference: eventType => type ,
Object reference: key => type HASH,
The constructor accepts only single parameter, it could be a hashref to parameters hash or DOM with 'metadata' element
SYNOPSIS
use perfSONAR_PS::Datatypes::v2_0::nmwg::Message::Metadata;
my $el = perfSONAR_PS::Datatypes::v2_0::nmwg::Message::Metadata->new($DOM_Obj);
METHODS
new( )
creates object, accepts DOM with element tree or hashref to the list of
keyd parameters
metadataIdRef => undef,
id => undef,
subject => ARRAY,
parameters => ARRAY,
key => HASH,
getDOM ($)
accept parent DOM
return metadata object DOM, generated from object contents
addsubject()
if any of subelements can be an arrray then this method will provide
facility to add another element to the array and will return ref to such array
or just set the element to a new one
removeSubjectById()
remove specific element from the array of subject elements by id ( if id is supported by this element )
accepts single param - id - which is id attribute of the element
if there is no array then it will return undef and warninig
if it removed some id then $id will be returned
get specific object from the array of subject elements by MetadataIdRef( if MetadataIdRef is supported by this element )
accepts single param - MetadataIdRef
if there is no array then it will return just an object
getSubjectById()
get specific element from the array of subject elements by id ( if id is supported by this element )
accepts single param - id
if there is no array then it will return just an object
addparameters()
if any of subelements can be an arrray then this method will provide
facility to add another element to the array and will return ref to such array
or just set the element to a new one
removeParametersById()
remove specific element from the array of parameters elements by id ( if id is supported by this element )
accepts single param - id - which is id attribute of the element
if there is no array then it will return undef and warninig
if it removed some id then $id will be returned
get specific object from the array of parameters elements by MetadataIdRef( if MetadataIdRef is supported by this element )
accepts single param - MetadataIdRef
if there is no array then it will return just an object
getParametersById()
get specific element from the array of parameters elements by id ( if id is supported by this element )
accepts single param - id
if there is no array then it will return just an object
querySQL ()
depending on config it will return some hash ref to the initialized fields
for example querySQL ()
accepts one optional prameter - query hashref
will return:
{ ip_name_src => 'hepnrc1.hep.net' },}
merge
merge with another metadata ( append + overwrite if exists )
we can do it differently
method #1:
convert to dom both objects and then get resulted object from combined dom
method #2 default:
through the introspection of the object
buildIdMap()
if any of subelements has id then get a map of it in form of
hashref to { element}{id} = index in array and store in the idmap field
buildrefIdMap ()
if any of subelements has metadataIdRef then get a map of it in form of
hashref to { element}{ metadataIdRef } = index in array and store in the idmap field
asString()
shortcut to get DOM and convert into the XML string
returns XML string representation of the metadata object
registerNamespaces ()
will parse all subelements and register all namepspaces within the metadata namespace
fromDOM ($)
accepts parent XML DOM element tree as parameter
returns metadata object
AUTHORS
Maxim Grigoriev (FNAL) 2007-2008, maxim@fnal.gov