The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

 perfSONAR_PS::Datatypes::v2_0::pinger::Message::Data::CommonTime::Datum  - A base class, implements  'datum'  element from the perfSONAR_PS RelaxNG schema
  

DESCRIPTION

   Object representation of the datum element.
   Object fields are:
    Scalar:     timeType, 
    Scalar:     ttl, 
    Scalar:     numBytes, 
    Scalar:     value, 
    Scalar:     name, 
    Scalar:     valueUnits, 
    Scalar:     timeValue, 
    Scalar:     seqNum, 
   
   The constructor accepts only single parameter, it could be a hashref to parameters hash  or DOM with  'datum' element 
    
    

SYNOPSIS

              use perfSONAR_PS::Datatypes::v2_0::pinger::Message::Data::CommonTime::Datum;
          
          my $el =  perfSONAR_PS::Datatypes::v2_0::pinger::Message::Data::CommonTime::Datum->new($DOM_Obj);
 

METHODS

new( )

      creates   object, accepts DOM with  element tree or hashref to the list of
      keyd parameters
         timeType   => undef, 
         ttl   => undef, 
         numBytes   => undef, 
         value   => undef, 
         name   => undef, 
         valueUnits   => undef, 
         timeValue   => undef, 
         seqNum   => undef, 

getDOM ($)

       accept parent DOM
       return datum object DOM, generated from object contents 
  

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 datum ( 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  datum object

registerNamespaces ()

   will parse all subelements and register all namepspaces within the datum namespace

fromDOM ($)

   accepts parent XML DOM   element   tree as parameter 
   returns datum  object

AUTHORS

   Maxim Grigoriev (FNAL)  2007-2008, maxim@fnal.gov