NAME

       HTTP::OAI::Identify - Provide access to an OAI Identify response

SYNOPSIS

               use HTTP::OAI::Identify;

               my $i = new HTTP::OAI::Identify(
                       adminEmail=>'billg@microsoft.com',
                       baseURL=>'http://www.myarchives.org/oai',
                       repositoryName=>'www.myarchives.org'
               );

               for( $i->adminEmail ) {
                       print $_, "\n";
               }

METHODS

       $i = new HTTP::OAI::Identify(-baseURL=>'http://arXiv.org/oai1'[, adminEmail=>$email,
       protocolVersion=>'2.0', repositoryName=>'myarchive'])
           This constructor method returns a new instance of the OAI::Identify module.

       $i->version
           Return the original version of the OAI response, according to the given XML namespace.

       $i->headers
           Returns an HTTP::Headers object. Use $headers->header('headername') to retrive field
           values.

       $burl = $i->baseURL([$burl])
       $eds = $i->earliestDatestamp([$eds])
       $gran = $i->granularity([$gran])
       $version = $i->protocolVersion($version)
       $name = $i->repositoryName($name)
           Returns and optionally sets the relevent header. NOTE: protocolVersion will always be
           '2.0'. Use $i->version to find out the protocol version used by the repository.

       @addys = $i->adminEmail([$email])
       @cmps = $i->compression([$cmp])
           Returns and optionally adds to the multi-value headers.

       @dl = $i->description([$d])
           Returns the description list and optionally appends a new description $d. Returns an
           array ref of HTTP::OAI::Descriptions, or an empty ref if there are no description.

       $d = $i->next
           Returns the next description or undef if no more description left.

       $dom = $i->toDOM
           Returns a XML::DOM object representing the Identify response.