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
.