org.greenstone.fedora.services
Interface FedoraGS3DL

All Known Implementing Classes:

FedoraConnection, FedoraGS3Connection

public interface FedoraGS3DL

Defines the methods that must be provided to retrieve the datastreams specific to Greenstone documents stored in a Fedora repository.

Author:

ak19

Field Summary

static java.lang.String	_COLLECTION
static java.lang.String	COLLECTION
static java.lang.String	COLLECTIONNAME
static java.lang.String	COLON
static java.lang.String	DC Fedora's Dublin Core metadata
static java.lang.String	DLS DLS metadata of Greenstone documents - this metadata set is optionally provided for top level documents.
static java.lang.String	ENGLISH
static java.lang.String	EX EX marks the XML metadata file that contains Greenstone extracted metadata
static java.lang.String	FEDORA_GS3 Instead of message router, we indicate that request messages sent here come from FedoraGS3
static java.lang.String	GREENSTONE "greenstone" is the FEDORA PID prefix we'll be working with
static java.lang.String	GREENSTONE_
static java.lang.String	HYPHEN
static java.lang.String	ID
static java.lang.String	METADATA
static java.lang.String	NAME
static java.lang.String	PERIOD
static java.lang.String	QUALIFIER
static java.lang.String	SECTION The SECTION prefix in the name of a section's datastream; eg.
static java.lang.String	SECTION_ELEMENT
static java.lang.String	TITLE
static java.lang.String	TOC Table of contents for a Greenstone-Fedora document which outlines the structure of the document.
static java.lang.String	UTF8
static java.lang.String	WILDCARD

Method Summary

java.lang.String[]	browseTitlesByLetter(java.lang.String collName, java.lang.String letter) Allows browsing document titles of a greenstone collection stored in the fedora repository by letter.
java.lang.String	getAssocFileBaseURL()
java.lang.String	getBaseURL()
java.lang.String	getChildrenOfSection(java.lang.String docPID, java.lang.String sectionID)
org.w3c.dom.Element	getChildrenOfSectionXML(java.lang.String docPID, java.lang.String sectionID)
java.lang.String[]	getCollectionDocs(java.lang.String colPID)
java.lang.String	getCollectionName(java.lang.String collPID)
java.lang.String[]	getCollectionNames(java.lang.String[] collPIDs)
java.lang.String	getCollectionPID(java.lang.String collName)
java.lang.String[]	getCollectionPIDs(java.lang.String[] collNames)
java.lang.String[]	getCollections() Gets all greenstone collections.
java.lang.String	getCollectionTitle(java.lang.String collPID) Gets the title of the collection denoted by the given collection's pid by retrieving the title metadata for it from the collection's EX datastream.
java.lang.String[]	getCollectionTitles(java.lang.String[] collPIDs)
java.lang.String	getDC(java.lang.String pid) All objects (incl "greenstone:*" objects) in fedora - be they collections, top-level documents or document sections) have an EX datastream.
java.lang.String	getDLS(java.lang.String pid) Some "greenstone:*" top-level documents in the fedora repository (but not greenstone collections or document sections) have a DLS metadata datastream.
java.lang.String	getDocName(java.lang.String docPID)
java.lang.String	getDocTitle(java.lang.String docPID) Gets the title metadata for a particular doc object in a collection denoted by docPID.
java.lang.String[]	getDocTitles(java.lang.String[] docPIDs)
java.lang.String	getEX(java.lang.String pid) All "greenstone:*" objects in fedora (be they collections, top-level documents or document sections) have an EX datastream.
java.lang.String	getLanguage()
int	getMaxResults() The default maximum number of search results returned for a search.
java.lang.String	getPortAddressURL()
java.lang.String	getSection(java.lang.String docPID, java.lang.String sectionID)
java.lang.String	getSectionDCMetadata(java.lang.String docPID, java.lang.String sectionID)
java.lang.String	getSectionEXMetadata(java.lang.String docPID, java.lang.String sectionID)
java.lang.String[]	getSectionNames(java.lang.String docPID) Given the pid of a document fedora data object, this method will return all itemIDs that are part of that data object and are Sections.
java.lang.String[]	getSectionNumbers(java.lang.String docPID) Given the pid of a document fedora data object, this method will return all itemIDs that are part of that data object and are Sections, but just the Section numbers are returned.
java.lang.String	getSectionTitle(java.lang.String docPID, java.lang.String sectionID)
java.lang.String[]	getSectionTitles(java.lang.String[] docPIDs, java.lang.String[] sectionIDs)
java.lang.String	getSubsection(java.lang.String docPID, java.lang.String sectionID)
org.w3c.dom.Element	getSubsectionXML(java.lang.String docPID, java.lang.String sectionID)
java.lang.String	getTitle(java.lang.String docPID, java.lang.String sectionID)
java.lang.String[]	getTitles(java.lang.String docPID, java.lang.String[] sectionIDs)
java.lang.String	getTOC(java.lang.String pid) All "greenstone:*" objects in fedora (be they collections or documents) have a TOC datastream.
java.lang.String[]	searchDocumentTitles(java.lang.String collName, java.lang.String titleContents, boolean startsWith) Allows querying document titles of a greenstone collection stored in the fedora repository for a term that may occur anywhere in their titles.
void	setLanguage(java.lang.String lang) Sets the the default language used to query for titles (and anything else where there are multiple language options).
void	setMaxResults(int maxresults) Set the default maximum number of search results returned for a search.

Field Detail

FEDORA_GS3

static final java.lang.String FEDORA_GS3

Instead of message router, we indicate that request messages sent here come from FedoraGS3

See Also:

Constant Field Values

GREENSTONE

static final java.lang.String GREENSTONE

"greenstone" is the FEDORA PID prefix we'll be working with

See Also:

Fedora batch processing, Constant Field Values

GREENSTONE_

static final java.lang.String GREENSTONE_

See Also:

Constant Field Values

COLLECTION

static final java.lang.String COLLECTION

See Also:

Constant Field Values

_COLLECTION

static final java.lang.String _COLLECTION

See Also:

Constant Field Values

WILDCARD

static final java.lang.String WILDCARD

See Also:

Constant Field Values

HYPHEN

static final java.lang.String HYPHEN

See Also:

Constant Field Values

COLON

static final java.lang.String COLON

See Also:

Constant Field Values

PERIOD

static final java.lang.String PERIOD

See Also:

Constant Field Values

UTF8

static final java.lang.String UTF8

See Also:

Constant Field Values

TITLE

static final java.lang.String TITLE

See Also:

Constant Field Values

ID

static final java.lang.String ID

See Also:

Constant Field Values

NAME

static final java.lang.String NAME

See Also:

Constant Field Values

COLLECTIONNAME

static final java.lang.String COLLECTIONNAME

See Also:

Constant Field Values

QUALIFIER

static final java.lang.String QUALIFIER

See Also:

Constant Field Values

ENGLISH

static final java.lang.String ENGLISH

See Also:

Constant Field Values

METADATA

static final java.lang.String METADATA

See Also:

Constant Field Values

SECTION_ELEMENT

static final java.lang.String SECTION_ELEMENT

See Also:

Constant Field Values

EX

static final java.lang.String EX

EX marks the XML metadata file that contains Greenstone extracted metadata

See Also:

Constant Field Values

DC

static final java.lang.String DC

Fedora's Dublin Core metadata

See Also:

Constant Field Values

DLS

static final java.lang.String DLS

DLS metadata of Greenstone documents - this metadata set is optionally provided for top level documents. Not all Greenstone top-level documents in the Fedora repository may have associated DLS metadata, however.

See Also:

Constant Field Values

TOC

static final java.lang.String TOC

Table of contents for a Greenstone-Fedora document which outlines the structure of the document.

See Also:

Constant Field Values

SECTION

static final java.lang.String SECTION

The SECTION prefix in the name of a section's datastream; eg. SECTION1.2.2

See Also:

Constant Field Values

Method Detail

getLanguage

java.lang.String getLanguage()

Returns:

the default language used to query for titles (and anything else where there are multiple language options). Upon initialisation, this defaults to English.

setLanguage

void setLanguage(java.lang.String lang)

Sets the the default language used to query for titles (and anything else where there are multiple language options). If the default language for any query is not available, then English ("en") is used. If that's not available then the first other available language is used.

Parameters:

lang - - the two-letter language code to set the default language to.

getMaxResults

int getMaxResults()

The default maximum number of search results returned for a search. Upon initialisation, this defaults to Java's Integer.MAX_VALUE.

setMaxResults

void setMaxResults(int maxresults)

Set the default maximum number of search results returned for a search.

Parameters:

maxresults - - the new default maximum number of search results to be returned.

getBaseURL

java.lang.String getBaseURL()

Returns:

fedora's baseURL

getPortAddressURL

java.lang.String getPortAddressURL()

Returns:

the portAddressURL of the Fedora APIA web service (should be the endpoint location in the APIA's WSDL file). Else set this in the .properties file to something else.

getAssocFileBaseURL

java.lang.String getAssocFileBaseURL()

Returns:

the baseURL for gsdlAssocFiles

getCollections

java.lang.String[] getCollections()
                                  throws java.rmi.RemoteException

Gets all greenstone collections. Searches for greenstone:*-collection.

Returns:

an array of Strings containing the pids of all collections matching the format greenstone:*-collection.

Throws:

java.rmi.RemoteException

getCollectionNames

java.lang.String[] getCollectionNames(java.lang.String[] collPIDs)

Parameters:

collPIDs - - an array of Strings denoting the pids for greenstone collections stored in the fedora repositoryl. These should be of the format "greenstone:<collectionName>-collection".

Returns:

the <name>s (in greenstone:<name>-collection) for the collections indicated by collPIDs.

getCollectionPIDs

java.lang.String[] getCollectionPIDs(java.lang.String[] collNames)

Parameters:

collNames - - a list of names of greenstone collections stored in the fedora repository.

Returns:

"greenstone:<name>-collection" for all <name>s in the parameter collNames.

getCollectionPID

java.lang.String getCollectionPID(java.lang.String collName)

Parameters:

collName - - the name of a greenstone collection stored stored in the fedora repository.

Returns:

greenstone:<name>-collection for the <name> denoted by parameter collName.

getCollectionTitle

java.lang.String getCollectionTitle(java.lang.String collPID)
                                    throws java.rmi.RemoteException,
                                           java.io.UnsupportedEncodingException,
                                           org.xml.sax.SAXException,
                                           java.io.IOException

Gets the title of the collection denoted by the given collection's pid by retrieving the title metadata for it from the collection's EX datastream.

Parameters:

collPID - is the pid of a greenstone collection in the fedora repository.

Returns:

the title (in the default language, else English, else the first title found) for the particular collection denoted by its PID.

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

org.xml.sax.SAXException

java.io.IOException

getCollectionTitles

java.lang.String[] getCollectionTitles(java.lang.String[] collPIDs)
                                       throws java.rmi.RemoteException,
                                              java.io.UnsupportedEncodingException,
                                              org.xml.sax.SAXException,
                                              java.io.IOException

Parameters:

collPIDs - - a list of pids identifying greenstone collections stored in the fedora repository.

Returns:

the collection titles for all the collections indicated by collPIDs.

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

org.xml.sax.SAXException

java.io.IOException

getDocTitles

java.lang.String[] getDocTitles(java.lang.String[] docPIDs)
                                throws java.rmi.RemoteException,
                                       java.io.UnsupportedEncodingException,
                                       org.xml.sax.SAXException,
                                       java.io.IOException

Parameters:

docPIDs - - a list of pids identifying documents stored in the fedora repository.

Returns:

the title metadata for the given doc objects of a collection. These titles are returned in the same order as the given docIDs.

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

org.xml.sax.SAXException

java.io.IOException

getDocTitle

java.lang.String getDocTitle(java.lang.String docPID)
                             throws java.rmi.RemoteException,
                                    java.io.UnsupportedEncodingException,
                                    org.xml.sax.SAXException,
                                    java.io.IOException

Gets the title metadata for a particular doc object in a collection denoted by docPID. The docPID already contains the collection name.

Parameters:

docPID - is the pid of the document in the fedora repository (docPID is of the form greenstone:<colName>-<doc-identifier>

Returns:

the title for the fedora document item denoted by docPID

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

org.xml.sax.SAXException

java.io.IOException

getSectionTitles

java.lang.String[] getSectionTitles(java.lang.String[] docPIDs,
                                    java.lang.String[] sectionIDs)
                                    throws java.rmi.RemoteException,
                                           java.io.UnsupportedEncodingException,
                                           org.xml.sax.SAXException,
                                           java.io.IOException

Parameters:

docPIDs - - a list of pids identifying documents stored in the fedora repository.

sectionIDs - - a list of sectionIDs identifying individual sections of documents stored in the fedora repository whose titles are requested.

Returns:

the title metadata for the given document sections. These titles are returned in the same order as the given docPIDs and associated sectionIDs.

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

org.xml.sax.SAXException

java.io.IOException

getSectionTitle

java.lang.String getSectionTitle(java.lang.String docPID,
                                 java.lang.String sectionID)
                                 throws java.io.UnsupportedEncodingException,
                                        java.rmi.RemoteException,
                                        org.xml.sax.SAXException,
                                        java.io.IOException

Parameters:

docPID - - a pid identifying a document in the fedora repository.

sectionID - - the sectionID of the section of the document whose title is requested.

Returns:

the title metadata for the given document section. (The docPID already contain the collection name anyway.)

Throws:

java.io.UnsupportedEncodingException

java.rmi.RemoteException

org.xml.sax.SAXException

java.io.IOException

getCollectionDocs

java.lang.String[] getCollectionDocs(java.lang.String colPID)
                                     throws java.rmi.RemoteException

Parameters:

colPID - is the pid of the greenstone collection stored in the fedora repository.

Returns:

a list of the fedora pids of all (document) objects in the given greenstone collection stored in fedora's repository. All pids that do not map to a collection are assumed to be documents.

Throws:

java.rmi.RemoteException

getSectionNames

java.lang.String[] getSectionNames(java.lang.String docPID)
                                   throws java.rmi.RemoteException

Given the pid of a document fedora data object, this method will return all itemIDs that are part of that data object and are Sections.

Parameters:

docPID - is a fedora pid identifying a greenstone document object.

Returns:

an array of itemIDs of the Sections of the document, indicated by docPID, in ascending order. These are of the form: "SECTION1.*"

Throws:

java.rmi.RemoteException

getSectionNumbers

java.lang.String[] getSectionNumbers(java.lang.String docPID)
                                     throws java.rmi.RemoteException

Given the pid of a document fedora data object, this method will return all itemIDs that are part of that data object and are Sections, but just the Section numbers are returned.

Parameters:

docPID - is a fedora pid identifying a greenstone document object.

Returns:

an array of itemIDs of the Section numbers of the document indicated by docPID, in ascending order. Return values are of form: "1.*".

Throws:

java.rmi.RemoteException

getTitles

java.lang.String[] getTitles(java.lang.String docPID,
                             java.lang.String[] sectionIDs)
                             throws java.rmi.RemoteException,
                                    java.io.UnsupportedEncodingException,
                                    org.xml.sax.SAXException,
                                    java.io.IOException

Parameters:

docPID - is a fedora pid identifying a greenstone document object.

sectionIDs - is a list of identifiers identifying sections in the document denoted by docPID, whose titles need to be returned. Each sectionID may sectionID may be either a section name (e.g. SECTION1.5.1) or a section number (eg. 1.5.1).

Returns:

the titles for the document sections denoted by the parameters.

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

org.xml.sax.SAXException

java.io.IOException

getTitle

java.lang.String getTitle(java.lang.String docPID,
                          java.lang.String sectionID)
                          throws java.rmi.RemoteException,
                                 java.io.UnsupportedEncodingException,
                                 org.xml.sax.SAXException,
                                 java.io.IOException

Parameters:

docPID - is a fedora pid identifying a greenstone document object.

sectionID - identifies the particular section in the document denoted by docPID, whose title needs to be returned. The sectionID may sectionID may be either a section name (e.g. SECTION1.5.1) or a section number (eg. 1.5.1).

Returns:

the title for the document section denoted by the parameters.

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

org.xml.sax.SAXException

java.io.IOException

getDocName

java.lang.String getDocName(java.lang.String docPID)

Parameters:

docPID - is the pid of a greenstone document in the fedora repository.

Returns:

the <docName> in the parameter docPID (which is of the form: greenstone:<colname>-<docName>)

getCollectionName

java.lang.String getCollectionName(java.lang.String collPID)

Parameters:

collPID - is the pid of a greenstone collection in the fedora repository.

Returns:

the <name> in the parameter collPID (greenstone:<name>-collection)

getDC

java.lang.String getDC(java.lang.String pid)
                       throws java.rmi.RemoteException,
                              java.io.UnsupportedEncodingException

All objects (incl "greenstone:*" objects) in fedora - be they collections, top-level documents or document sections) have an EX datastream. This method returns the content (XML) of the DC datastream as it is stored in fedora's repository.

Parameters:

pid - - the fedora persistent identifier for an item in the fedora repository.

Returns:

a String version of the XML in the DC datastream for the fedora object denoted by pid.

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

getEX

java.lang.String getEX(java.lang.String pid)
                       throws java.rmi.RemoteException,
                              java.io.UnsupportedEncodingException

All "greenstone:*" objects in fedora (be they collections, top-level documents or document sections) have an EX datastream. This method returns the content (XML) of the EX datastream as is.

Parameters:

pid - - the fedora persistent identifier for an item in the fedora repository.

Returns:

a String version of the XML in the DC datastream for the fedora object denoted by pid.

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

getDLS

java.lang.String getDLS(java.lang.String pid)
                        throws java.rmi.RemoteException,
                               java.io.UnsupportedEncodingException

Some "greenstone:*" top-level documents in the fedora repository (but not greenstone collections or document sections) have a DLS metadata datastream. This method returns the content (XML) of the DLS datastream as is.

Parameters:

pid - - the fedora persistent identifier for an item in the fedora repository.

Returns:

a String version of the XML in the DLS datastream for the fedora object denoted by pid.

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

getTOC

java.lang.String getTOC(java.lang.String pid)
                        throws java.rmi.RemoteException,
                               java.io.UnsupportedEncodingException

All "greenstone:*" objects in fedora (be they collections or documents) have a TOC datastream. This method returns the content (XML) of the TOC datastream as is. (Calls default fedora-system 3 dissemination <pid>/TOC.)

Parameters:

pid - - the fedora persistent identifier for an item in the fedora repository.

Returns:

a String version of the XML in the DC datastream for the fedora object denoted by pid.

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

getSection

java.lang.String getSection(java.lang.String docPID,
                            java.lang.String sectionID)
                            throws java.rmi.RemoteException,
                                   java.io.UnsupportedEncodingException

Parameters:

docPID - is a fedora pid identifying a greenstone document object.

sectionID - identifies the particular section in the document denoted by docPID, may be a section name or number.

Returns:

the section's XML (as a String) as it is stored in fedora. Works out if sectionID is a sectionName or sectionNumber.

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

getSectionDCMetadata

java.lang.String getSectionDCMetadata(java.lang.String docPID,
                                      java.lang.String sectionID)
                                      throws java.rmi.RemoteException,
                                             java.io.UnsupportedEncodingException

Parameters:

docPID - is a fedora pid identifying a greenstone document object.

sectionID - identifies the particular section in the document denoted by docPID, may be a section name or number.

Returns:

the required section's DC metadata XML datastream.

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

getSectionEXMetadata

java.lang.String getSectionEXMetadata(java.lang.String docPID,
                                      java.lang.String sectionID)
                                      throws java.rmi.RemoteException,
                                             java.io.UnsupportedEncodingException

Parameters:

docPID - is a fedora pid identifying a greenstone document object.

sectionID - identifies the particular section in the document denoted by docPID, may be a section name or number.

Returns:

the required section's EX metadata XML datastream.

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

getChildrenOfSectionXML

org.w3c.dom.Element getChildrenOfSectionXML(java.lang.String docPID,
                                            java.lang.String sectionID)
                                            throws java.rmi.RemoteException,
                                                   java.io.UnsupportedEncodingException,
                                                   org.xml.sax.SAXException,
                                                   java.io.IOException

Parameters:

docPID - is a fedora pid identifying a greenstone document object.

sectionID - identifies the particular section in the document denoted by docPID, may be a section name or number.

Returns:

the XML content of the TOC of just that portion of the TOC which contains the section denoted by sectionID and its direct child subsections. The children are returned in the order they are encountered, which happens to be in the required order of ascending sectionID.

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

org.xml.sax.SAXException

java.io.IOException

getChildrenOfSection

java.lang.String getChildrenOfSection(java.lang.String docPID,
                                      java.lang.String sectionID)
                                      throws java.rmi.RemoteException,
                                             java.io.UnsupportedEncodingException,
                                             org.xml.sax.SAXException,
                                             java.io.IOException,
                                             javax.xml.transform.TransformerException

Parameters:

docPID - is a fedora pid identifying a greenstone document object.

sectionID - identifies the particular section in the document denoted by docPID, may be a section name or number.

Returns:

a string representing the XML content of the TOC of just that portion of the TOC which contains the section denoted by sectionID and its direct child subsections. The children are returned in the order they are encountered, which happens to be in the required order of ascending sectionID.

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

org.xml.sax.SAXException

java.io.IOException

javax.xml.transform.TransformerException

getSubsectionXML

org.w3c.dom.Element getSubsectionXML(java.lang.String docPID,
                                     java.lang.String sectionID)
                                     throws java.rmi.RemoteException,
                                            java.io.UnsupportedEncodingException,
                                            org.xml.sax.SAXException,
                                            java.io.IOException

Parameters:

docPID - is a fedora pid identifying a greenstone document object.

sectionID - identifies the particular section in the document denoted by docPID, may be a section name or number.

Returns:

the part of the TOC XML file (which outlines doc structure) relating to the given section. This includes the section denoted by sectionID as well as all descendent subsections thereof.

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

org.xml.sax.SAXException

java.io.IOException

getSubsection

java.lang.String getSubsection(java.lang.String docPID,
                               java.lang.String sectionID)
                               throws java.rmi.RemoteException,
                                      java.io.UnsupportedEncodingException,
                                      org.xml.sax.SAXException,
                                      java.io.IOException,
                                      javax.xml.transform.TransformerException

Parameters:

docPID - is a fedora pid identifying a greenstone document object.

sectionID - identifies the particular section in the document denoted by docPID, may be a section name or number.

Returns:

a String representation of the part of the TOC XML file (which outlines doc structure) relating to the given section. This includes the section denoted by sectionID as well as all descendent subsections thereof.

Throws:

java.rmi.RemoteException

java.io.UnsupportedEncodingException

org.xml.sax.SAXException

java.io.IOException

javax.xml.transform.TransformerException

browseTitlesByLetter

java.lang.String[] browseTitlesByLetter(java.lang.String collName,
                                        java.lang.String letter)
                                        throws java.rmi.RemoteException,
                                               FedoraGS3Exception.FedoraVersionNotSupportedException

Allows browsing document titles of a greenstone collection stored in the fedora repository by letter.

Parameters:

letter - is the starting letter to browse by.

Returns:

the browse results for documents that start with any letter from A to Z. Returns the document pids whose titles start with the given letter.

Throws:

java.rmi.RemoteException

FedoraGS3Exception.FedoraVersionNotSupportedException

searchDocumentTitles

java.lang.String[] searchDocumentTitles(java.lang.String collName,
                                        java.lang.String titleContents,
                                        boolean startsWith)
                                        throws java.rmi.RemoteException,
                                               FedoraGS3Exception.FedoraVersionNotSupportedException

Allows querying document titles of a greenstone collection stored in the fedora repository for a term that may occur anywhere in their titles.

Parameters:

titleContents - is the word or phrase to search the collection's document titles for.

startsWith - - if true, searches for titles that start with titleContents. Else it searches for titles that contain titleContents.

Returns:

the document pids whose titles contain the parameter term.

Throws:

java.rmi.RemoteException

FedoraGS3Exception.FedoraVersionNotSupportedException