-# $Id: Pod.pm,v 1.14 2006-07-18 11:43:55 mike Exp $
+# $Id: Pod.pm,v 1.22 2006-10-06 11:33:07 mike Exp $
package ZOOM::Pod;
use ZOOM;
BEGIN {
- # Just register the name
+ # Just register the names: this doesn't turn the levels on
ZOOM::Log::mask_str("pod");
ZOOM::Log::mask_str("pod_unhandled");
}
}, $class;
}
+
+=head2 connections()
+
+ @c = $pod->connections();
+
+Returns a list of the connection objects in the pod.
+
+=cut
+
+sub connections {
+ my $this = shift();
+ return @{ $this->{conn} }
+}
+
+
=head2 option()
$oldElemSet = $pod->option("elementSetName");
my($event, $sub) = @_;
my $old = $this->{callback}->{$event};
- $this->{callback}->{$event} = $sub
- if defined $sub;
+ $this->{callback}->{$event} = $sub;
return $old;
}
+=head2 remove_callbacks()
+
+ $pod->remove_callbacks();
+
+Removes all registed callbacks from the pod. This is useful when the
+pod has completed one operation and is about to start the next.
+
+=cut
+
+sub remove_callbacks {
+ my $this = shift();
+ $this->{callback} = {};
+}
+
=head2 search_pqf()
$pod->search_pqf("@attr 1=1003 wedel");
maintain the one-to-one mapping between connections and result-sets.
Submitting a new search on a connection before the old one has
completed will result in a total failure in the nature of causality,
-and the spontaneous existence-failure of the universe. Do not do
-this.
+and the spontaneous existence-failure of the universe. Try to avoid
+doing this too often.
=cut
my($pqf) = @_;
foreach my $i (0..@{ $this->{conn} }-1) {
- $this->{rs}->[$i] = $this->{conn}->[$i]->search_pqf($pqf);
+ my $conn = $this->{conn}->[$i];
+ $this->{rs}->[$i] = $conn->search_pqf($pqf)
+ if !$conn->option("pod_omit");
}
}
my $res = 0;
- my @conn;
- foreach my $conn (@{ $this->{conn} }) {
- if (!$conn->option("pod_omit")) {
- push @conn, $conn;
- } else {
- # If we don't push anything onto @conn, then the index $i
- # will be meaningless in the loop below, and the
- # references to $rs[$i] will be wrong. Ouch.
- push @conn, undef;
+ while (1) {
+ my @conn;
+ my @idxmap; # maps indexes into conn to global indexes
+ foreach my $i (0 .. @{ $this->{conn} }-1) {
+ my $conn = $this->{conn}->[$i];
+ if ($conn->option("pod_omit")) {
+ #ZOOM::Log::log("pod", "connection $i omitted (",
+ #$conn->option("host"), ")");
+ } else {
+ push @conn, $conn;
+ push @idxmap, $i;
+ #ZOOM::Log::log("pod", "connection $i included (",
+ #$conn->option("host"), ")");
+ }
}
- }
- while ((my $i = ZOOM::event(\@conn)) != 0) {
- my $conn = $conn[$i-1];
+ last if @conn == 0;
+ my $i0 = ZOOM::event(\@conn);
+ last if $i0 == 0;
+ my $i = 1+$idxmap[$i0-1];
+ my $conn = $this->{conn}->[$i-1];
+ die "connection-mapping screwup" if $conn ne $conn[$i0-1];
+
my $ev = $conn->last_event();
my $evstr = ZOOM::event_str($ev);
ZOOM::Log::log("pod", "connection ", $i-1, ": event $ev ($evstr)");