NAME

Net::OAI::Record::Header - class for record header representation

SYNOPSIS

DESCRIPTION

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 record.

Beginning from OAI-Harvester v1.20 a new "recordHandler" argument may be given to the harvester functions getRecord() and 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 (including record itself) to the handler specified, not only those from metadata children.

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.

METHODS

new()

status()

Gets the optional status attribute of the OAI header and returns either "deleted" or "".

identifier()

datestamp()

setSpecs()

sets() DEPRECATED