Net::OAI::Record::Header - class for record header representation
Actually this class implements a SAX filter for the complete
record OAI-PMH element. The contents of the
header child are collected into a header object and can be accessed by the methods documented here.
Events will be traditionally forwarded only from the subelement(s) of the
metadata child which makes it difficult to access data contained in the (possibly multiple)
about containers which may follow the
metadata in the
Beginning from OAI-Harvester v1.20 a new "recordHandler" argument may be given to the harvester functions
listRecords(): In contrast to a "metadataHandler" argument this will pass the "fwdAll" argument to the constructor of this Header class and result in forwarding all events in the
record itself) to the handler specified, not only those from
In case of compatibility issues of Filters written for older veresions you might set
$Net::OAI::Harvester::OLDmetadataHandler = 1, in which case the metadataHandler Option behaves like a recordHandler.
The SAX filter implemented by this class purposefully does not generate any start_document() or end_document() events. Consider inserting Net::OAI::Record::DocumentHelper as an additional filtering stage if your handler(s) need these events, if they fail class verification, or if you need a hook for capturing their result.
Gets the optional
status attribute of the OAI header and returns either "deleted" or "".