Mike Taylor > Net-Z3950-UDDI > UDDI::HalfDecent::ResultSet

Download:
Net-Z3950-UDDI-0.04.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Source  

NAME ^

UDDI::HalfDecent::ResultSet - a set of results from a UDDI query

SYNOPSIS ^

 $rs = $uddi->find_business(name => 'frog');
 $n = $rs->count();
 foreach $i (0 .. $n-1) {
     $bi = $rs->record($i);
 }

DESCRIPTION ^

This is a container class which allows access to the multiple records found by various interrogation methods on a UDDI object. Depending on what method gave rise to the result-set it will contain different kinds of objects, e.g. find_business() will yield a result-set of Business objects. In a parallel universe, there are ResultSet subclasses corresponding to each of the possible contained object types, but that's not how we do things here.

METHODS ^

new()

 $uddi = new UDDI::HalfDecent::ResultSet($uddi, $xpc, $node, $class);

Creates and returns a new UDDI result-set object representing the result of a search. Note that client code need never call this: it is invoked by the UDDI library itself, in methods such as find_business().

This constructor takes four arguments: $uddi is the UDDI object for which it is created, and which will be used for logging, etc; $xpc is an XPath content with all relevant namespaces registered; and $node is the context node of the list-containing element, which in general will be different from the context-node registered as part of the XPath context. (If you didn't understand that last bit, don't worry about it -- you won't be calling this constructor yourself, remember?) $class is the class to which the individual result records must belong.

count()

 $n = $rs->count();

Returns the number of records in the result-set, e.g. the number of businesses found by a find_business() call.

record()

 foreach $i (0 .. $n-1) {
     $bi = $rs->record($i);
 }

Returns a single record from the result-set, indexed from zero.

SEE ALSO ^

UDDI::HalfDecent is the module that uses this. See also its SEE ALSOs.

AUTHOR, COPYRIGHT AND LICENSE ^

As for Net::Z3950::UDDI.

syntax highlighting: