Package edu.ucsb.nceas.metacat.oaipmh.harvester

Class HarvesterVerb

java.lang.Object

edu.ucsb.nceas.metacat.oaipmh.harvester.HarvesterVerb

Direct Known Subclasses:

GetRecord, Identify, ListIdentifiers, ListMetadataFormats, ListRecords, ListSets

public abstract class HarvesterVerb
extends Object

HarvesterVerb is the parent class for each of the OAI verbs.

Author:

Duane Costa, University of New Mexico, LTER Network Office, Jeffrey A. Young, OCLC Online Computer Library Center

Field Summary

Fields

Modifier and Type	Field	Description
static final String	SCHEMA_LOCATION_V2_0

Constructor Summary

Constructors

Constructor	Description
HarvesterVerb()	Mock object creator (for unit testing purposes)
HarvesterVerb(String requestURL)	Performs the OAI request

Method Summary

Modifier and Type	Method	Description
Document	getDocument()	Get the OAI response as a DOM object
NodeList	getErrors()	Get the OAI errors
NodeList	getNodeList(String xpath)	Get a NodeList containing the nodes in the response DOM for the specified xpath
String	getRequestURL()	Get the OAI request URL for this response
String	getSchemaLocation()	Get the xsi:schemaLocation for the OAI response
String	getSingleString(String xpath)	Get the String value for the given XPath location in the response DOM
void	runVerb()	Preforms the OAI request for this OAI-PMH verb
String	toString()	Transform the document content to a string and return it.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

SCHEMA_LOCATION_V2_0

public static final String SCHEMA_LOCATION_V2_0

See Also:

• Constant Field Values

Constructor Details

HarvesterVerb

public HarvesterVerb()

Mock object creator (for unit testing purposes)

HarvesterVerb

public HarvesterVerb(String requestURL)
              throws IOException,
ParserConfigurationException,
SAXException,
TransformerException

Performs the OAI request

Parameters:

requestURL -

Throws:

IOException

ParserConfigurationException

SAXException

TransformerException

Method Details

getDocument

public Document getDocument()

Get the OAI response as a DOM object

Returns:

the DOM for the OAI response

getErrors

public NodeList getErrors()
                   throws TransformerException

Get the OAI errors

Returns:

a NodeList of /oai:OAI-PMH/oai:error elements

Throws:

TransformerException

getNodeList

public NodeList getNodeList(String xpath)
                     throws TransformerException

Get a NodeList containing the nodes in the response DOM for the specified xpath

Parameters:

xpath -

Returns:

the NodeList for the xpath into the response DOM

Throws:

TransformerException

getRequestURL

public String getRequestURL()

Get the OAI request URL for this response

Returns:

the OAI request URL as a String

getSchemaLocation

public String getSchemaLocation()

Get the xsi:schemaLocation for the OAI response

Returns:

the xsi:schemaLocation value

getSingleString

public String getSingleString(String xpath)
                       throws TransformerException

Get the String value for the given XPath location in the response DOM

Parameters:

xpath -

Returns:

a String containing the value of the XPath location.

Throws:

TransformerException

runVerb

public void runVerb()
             throws IOException,
ParserConfigurationException,
SAXException,
TransformerException

Preforms the OAI request for this OAI-PMH verb

Throws:

IOException

ParserConfigurationException

SAXException

TransformerException

toString

public String toString()

Transform the document content to a string and return it.

Overrides:

toString in class Object

Returns:

returnString - the string that results from transforming the document