The Perl and Raku Conference 2025: Greenville, South Carolina - June 27-29 Learn more

NAME

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

DESCRIPTION

Object representation of the commonTime 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 'commonTime' element

SYNOPSIS

my $el = perfSONAR_PS::Datatypes::v2_0::pinger::Message::Data::CommonTime->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 commonTime 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 commonTime ( 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 commonTime object

registerNamespaces ()

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

fromDOM ($)

accepts parent XML DOM element tree as parameter
returns commonTime object

AUTHORS

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