/ 
Net-Z3950-UDDI-0.04
River stage zero No dependents
/ Net::Z3950::UDDI::Database

NAME

Net::Z3950::UDDI::Database - back-end independent database for z2uddi

SYNOPSIS

$db = new Net::Z3950::UDDI::Database($dbconfig);
$map = $db->config()->property("indexmap"); 
$rs = $db->search($rpn);

DESCRIPTION

Net::Z3950::UDDI::Database objects represent a connection to backend database of some kind or another, but hide the details of whether that database is a SOAP service or a UDDI repostory (or something else again) by presenting a simple, generic API.

METHODS

new()

$session = new Net::Z3950::UDDI::Database($dbname, $config)

Creates and returns a new session object for the specied user, using the specified password. These authentication credentials are optional if not required by the back-ends accessed by subsequent searches.

The returned object will not be of the Database base-class, but of one of the subclasses such as Database::soap or Database::uddi. This selection is made on the basis of the type parameter specified in the database's $config: a module corresponding to that type is loaded and invoked.

search()

$rs = $db->search($rpn);

Searches the specified database using the query $rpn, which is a structure representing a Z39.50 Type-1 query, of the kind passed into search callback functions by Index Data's SimpleServer. (That's convenient!)

Returns a result-set, and object of a subclass of Net::Z3950::UDDI::ResultSet corresponding to $db's particular subclass of Net::Z3950::UDDI::Database

SUBCLASSING

### to be written

SEE ALSO

Net::Z3950::UDDI::Session is the module that immediately uses this, as it maintains a mapping of Z39.50 database-names to Database objects.

AUTHOR, COPYRIGHT AND LICENSE

As for Net::Z3950::UDDI.