- SEE ALSO
- AUTHOR, COPYRIGHT AND LICENSE
Net::Z3950::UDDI::Session - client session for z2uddi
use Net::Z3950::UDDI::Session; $session = new Net::Z3950::UDDI::Session($uddi, $user, $password); $nhits = $session->search($config, $dbname, $rpn);
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.
$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.
$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
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
$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.
Net::Z3950::UDDI is the module that uses this.
z2uddi is the gateway program that uses