org.sourceforge.vlibrary.util

Interface SruSrwClientInterface

All Known Implementing Classes:

SruSrwClientImpl

public interface SruSrwClientInterface

Method Summary

Modifier and Type	Method and Description
Map	callSruSrwProvider(String identifier) Looks up using SRU/SRW defined endpoint an identifier (normally ISBN) and returns the first record returned by SRU/SRW as a HashMap of fields

Method Detail

callSruSrwProvider

Map callSruSrwProvider(String identifier)
                throws Exception

Looks up using SRU/SRW defined endpoint an identifier (normally ISBN) and returns the first record returned by SRU/SRW as a HashMap of fields

Parameters:

identifier - Normally the isbn of the book to search, expressed in the "xxxxxxxxxx" format
ISBN can be in 10 or 13 digit format, no spaces or dashes

If something else is passed instead of an (unique) ISBN, the first record (of potentially many) is always returned.

This is a limitation due to the fact that the main SRU/SRW SP (LOC.GOV) does not seem to have implemented fully the dc (Dublin Core) context (missing especially the dc.identifier index).

For example, a search for Web Services will return: recordMap={TITLE=Introduction to Semantic Web and Semantic Web services /, PUBLISHER=Boca Raton, FL : CRC Press,, AUTHOR=Yu, Liyang., DATE=2007., SUBJECTSLIST=[Semantic Web., Web services.]}
Note that any dentifier strings containing spaces must be escaped (ex: "%22Web%20Services%22").

Returns:

Map containing the elements described above using the names: AUTHOR, TITLE, PUBLISHER, PUBLISHEDDATE, SUBJECTSLIST and String values, with the exception of SubjectsList whose value is a List of string subjects

Throws:

Exception - if either parameters are incorrect, the SRU/SRW enpoint cannot be called, if the returned XML cannot be parsed or if the record identified by identifier could not be found by provider

See Also:

SRU/SRW Specification for more details