NAME

Net::Z3950::UDDI::Session - client session for z2uddi

SYNOPSIS

use Net::Z3950::UDDI::Session;
$session = new Net::Z3950::UDDI::Session($uddi, $user, $password);
$nhits = $session->search($config, $dbname, $rpn);

DESCRIPTION

Net::Z3950::UDDI::Session objects represent the state of a single client session, i.e. a Z39.50 connection to the gateway. They are created when the client's Init request is received, and updated by subsequent client requests and back-end responses.

METHODS

new()

$session = new Net::Z3950::UDDI::Session($uddi, $user, $password);

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

search()

$rs = $session->search($dbname, $config, $setname, $rpn);

Performs a search in database named $dbname in the session $session, reusing an existing database connection if one has already been created for this session, and creating and caching a new one otherwise. In the latter case, $config is used to determine the type of back-end database to create, among other things. The search is for the query specified by the SimpleServer-like RPN structure $rpn.

Returns a new Net::Z3950::ResultSet object. Well, actually an object of one of the back-end-specific subclasses of that class, but the invoker should not worry about that. The result is cached under the specified $setname and can subsequently be retrieved using resultset_by_name().

resultset_by_name()

$rs = $session->resultset_by_name($setname);

Returns the previously generated result-set with the specified name, or an undefined value if no such result-set exists.

SEE ALSO

Net::Z3950::UDDI is the module that uses this.

z2uddi is the gateway program that uses Net::Z3950::UDDI.

AUTHOR, COPYRIGHT AND LICENSE

As for Net::Z3950::UDDI.