org.dlese.dpc.services.dds.toolkit

Class RepositoryUtils

java.lang.Object

org.dlese.dpc.services.dds.toolkit.RepositoryUtils

public class RepositoryUtils
extends java.lang.Object

Provides functions that use the DDSServicesToolkit to get information about collections, itemRecords, terms and other data from a DDS repository.

Author:

ostwald, weatherley

Constructor Summary

Constructors

Constructor and Description
RepositoryUtils(DDSServicesToolkit ddsServicesToolkit) Constructor for the RepositoryUtils object
RepositoryUtils(java.lang.String baseUrl) Constructor for the RepositoryUtils object

Method Summary

Modifier and Type	Method and Description
java.lang.String[]	checkForErrorResponse(org.dom4j.Document doc)
protected CollectionInfo	getCollectionInfo(java.lang.String collection) Gets the collectionInfo instance for the specified collection
java.util.List	getCollectionInfos() Gets the collectionInfos attribute of the RepositoryUtils object
java.util.List	getCollectionKeys() Returns a List of collection keys (e.g., "dcc") defined in the repository.
protected int	getIntAtPath(org.dom4j.Node baseElement, java.lang.String relativePath) Gets the integer value of the node located at relativePath from given baseElement.
java.util.Map	getItemRecordMap(CollectionInfo collectionInfo, int startOffset, int numReturns) Returns an itemRecordMap for the specified collection, startOffset and batchSize
java.util.Map	getItemRecordMap(java.lang.String collection) Gets a mapping of recordIds to itemRecords (as Documents) for the specified collection
java.util.Collection	getItemRecords(CollectionInfo collectionInfo, int startOffset, int numReturns) Gets a batch of itemRecords
java.util.Collection	getItemRecords(java.lang.String collection) Returns the itemRecords of the specified collection as dom4j.Documents
TermsInfo	getTermsInfoForFields(java.lang.String[] fields) Get terms data for one or more fields in a DDS repository index.
DDSServicesToolkit	getToolKit()
protected java.lang.String	getValueAtPath(org.dom4j.Node baseElement, java.lang.String relativePath) Gets the textual value of the node located at relativePath from given baseElement.
static void	main(java.lang.String[] args) The main program for the RepositoryUtils class
protected java.lang.String	subElementValue(org.dom4j.Element parent, java.lang.String childTagName) Gets the text value of the specified child of a given parent element.

Methods inherited from class java.lang.Object

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

Constructor Detail

RepositoryUtils

public RepositoryUtils(java.lang.String baseUrl)

Constructor for the RepositoryUtils object

Parameters:

baseUrl - DDSWebservice baseUrl (e.g., "http://www.dlese.org/dds/services/ddsws1-1")

RepositoryUtils

public RepositoryUtils(DDSServicesToolkit ddsServicesToolkit)

Constructor for the RepositoryUtils object

Parameters:

ddsServicesToolkit - A DDSServicesToolkit

Method Detail

getToolKit

public DDSServicesToolkit getToolKit()

getItemRecordMap

public java.util.Map getItemRecordMap(java.lang.String collection)
                               throws java.lang.Exception

Gets a mapping of recordIds to itemRecords (as Documents) for the specified collection

Parameters:

collection - collection key (e.g., "dcc")

Returns:

The itemRecordMap value

Throws:

java.lang.Exception - if the itemRecordMap cannot be constructed

getItemRecordMap

public java.util.Map getItemRecordMap(CollectionInfo collectionInfo,
                                      int startOffset,
                                      int numReturns)
                               throws java.lang.Exception

Returns an itemRecordMap for the specified collection, startOffset and batchSize

NOTE: to search over all records,

Parameters:

collectionInfo - NOT YET DOCUMENTED

startOffset - NOT YET DOCUMENTED

numReturns - NOT YET DOCUMENTED

Returns:

The itemRecordMap value

Throws:

java.lang.Exception - NOT YET DOCUMENTED

checkForErrorResponse

public java.lang.String[] checkForErrorResponse(org.dom4j.Document doc)

getItemRecords

public java.util.Collection getItemRecords(java.lang.String collection)
                                    throws java.lang.Exception

Returns the itemRecords of the specified collection as dom4j.Documents

Parameters:

collection - collection key ("dcc")

Returns:

The itemRecords value

Throws:

java.lang.Exception - Description of the Exception

getItemRecords

public java.util.Collection getItemRecords(CollectionInfo collectionInfo,
                                           int startOffset,
                                           int numReturns)
                                    throws java.lang.Exception

Gets a batch of itemRecords

Parameters:

collectionInfo - NOT YET DOCUMENTED

startOffset - NOT YET DOCUMENTED

numReturns - NOT YET DOCUMENTED

Returns:

The itemRecords value

Throws:

java.lang.Exception - NOT YET DOCUMENTED

getCollectionKeys

public java.util.List getCollectionKeys()
                                 throws java.lang.Exception

Returns a List of collection keys (e.g., "dcc") defined in the repository.

Returns:

The collectionKeys value

Throws:

java.lang.Exception - NOT YET DOCUMENTED

getCollectionInfos

public java.util.List getCollectionInfos()
                                  throws java.lang.Exception

Gets the collectionInfos attribute of the RepositoryUtils object

Returns:

A list of CollectionInfo instances

Throws:

java.lang.Exception - Description of the Exception

getCollectionInfo

protected CollectionInfo getCollectionInfo(java.lang.String collection)
                                    throws java.lang.Exception

Gets the collectionInfo instance for the specified collection

Parameters:

collection - collection key (e.g., "dcc")

Returns:

The collectionInfo value

Throws:

java.lang.Exception - NOT YET DOCUMENTED

getValueAtPath

protected java.lang.String getValueAtPath(org.dom4j.Node baseElement,
                                          java.lang.String relativePath)
                                   throws java.lang.Exception

Gets the textual value of the node located at relativePath from given baseElement.

Parameters:

baseElement - Description of the Parameter

relativePath - Description of the Parameter

Returns:

The valueAtPath value

Throws:

java.lang.Exception - if there is no node at relativePath from baseElement

getIntAtPath

protected int getIntAtPath(org.dom4j.Node baseElement,
                           java.lang.String relativePath)
                    throws java.lang.Exception

Gets the integer value of the node located at relativePath from given baseElement.

Parameters:

baseElement - Description of the Parameter

relativePath - Description of the Parameter

Returns:

The intAtPath value

Throws:

java.lang.Exception - if there is no node at relativePath from baseElement, or if the value found is not an integer

subElementValue

protected java.lang.String subElementValue(org.dom4j.Element parent,
                                           java.lang.String childTagName)

Gets the text value of the specified child of a given parent element.

Parameters:

parent - Element whose child element supplies the text

childTagName - tagName of child element

Returns:

textual content of named child element

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

The main program for the RepositoryUtils class

Parameters:

args - The command line arguments

Throws:

java.lang.Exception - NOT YET DOCUMENTED

getTermsInfoForFields

public TermsInfo getTermsInfoForFields(java.lang.String[] fields)
                                throws DDSServiceErrorResponseException,
                                       java.lang.Exception

Get terms data for one or more fields in a DDS repository index. The request accepts one or more fields to list the terms data for. Note that this request is much less efficient when more than one field is requested.

Parameters:

fields - One or more fields to get terms data for

Returns:

The data about the terms in the given field(s)

Throws:

DDSServiceErrorResponseException - If service error

java.lang.Exception - If other error