-# $Id: Resultset.pm,v 1.6 2003-03-03 12:14:27 pop Exp $
+# $Id: Resultset.pm,v 1.13 2004-09-16 14:58:47 heikki Exp $
#
# Zebra perl API header
# =============================================================================
use IDZebra::Logger qw(:flags :calls);
use Scalar::Util qw(weaken);
use Carp;
- our $VERSION = do { my @r = (q$Revision: 1.6 $ =~ /\d+/g); sprintf "%d."."%02d" x $#r, @r };
+ our $VERSION = do { my @r = (q$Revision: 1.13 $ =~ /\d+/g); sprintf "%d."."%02d" x $#r, @r };
our @ISA = qw(IDZebra::Logger);
}
my $class = ref($proto) || $proto;
my $self = {};
bless ($self, $class);
+ logf(LOG_DEBUG,"creating a Resultset ".$args{name});
$self->{session} = $session;
weaken ($self->{session});
$self->{odr_stream} = IDZebra::odr_createmem($IDZebra::ODR_DECODE);
$self->{name} = $args{name};
+ $self->{query} = $args{query};
$self->{recordCount} = $args{recordCount};
$self->{errCode} = $args{errCode};
$self->{errString} = $args{errString};
+ logf(LOG_DEBUG,"created a Resultset ".$self->{name});
return ($self);
}
return ($self->{errCode});
}
+######################
+# this is disabled, while the term counts are broken by the work done to
+# rsets. To be reinstantiated some day real soon now...
+#sub terms {
+# use Data::Dumper;
+# my ($self) = @_;
+# my $count = 0; my $type = 0; my $len = 0;
+# my $tc = IDZebra::resultSetTerms($self->{session}{zh},$self->{name},
+# 0, \$count, \$type, "\0", \$len);
+#
+# logf (LOG_LOG,"Got $tc terms");
+#
+#
+# my @res = ();
+# for (my $i=0; $i<$tc; $i++) {
+# my $len = 1024;
+# my $t = {term => "\0" x $len, count => 0, type => 0};
+# my $stat = IDZebra::resultSetTerms($self->{session}{zh},$self->{name},
+# $i, \$t->{count}, \$t->{type},
+# $t->{term}, \$len);
+# $t->{term} = substr($t->{term}, 0, $len);
+# logf (LOG_LOG,
+# "term $i: type $t->{type}, '$t->{term}' ($t->{count})");
+# push (@res, $t);
+# }
+# return (@res);
+#}
+
# =============================================================================
sub DESTROY {
my $self = shift;
+# print STDERR "Destroy RS\n";
# Deleteresultset?
my $stats = 0;
+ logf(LOG_DEBUG, "Destroying a Resultset ". $self->{name});
if ($self->{session}{zh}) {
my $r = IDZebra::deleteResultSet($self->{session}{zh},
0, #Z_DeleteRequest_list,
}
delete($self->{session});
+ logf(LOG_DEBUG, "Destroyed a Resultset ". $self->{name});
}
# -----------------------------------------------------------------------------
sub records {
my $from = $args{from} ? $args{from} : 1;
my $to = $args{to} ? $args{to} : $self->{recordCount};
+ if (($to-$from) >= 1000) {
+ if ($args{to}) {
+ croak ("Cannot fetch more than 1000 records at a time");
+ } else {
+ $to = $from + 999;
+ }
+ }
+
my $elementSet = $args{elementSet} ? $args{elementSet} : 'R';
my $schema = $args{schema} ? $args{schema} : '';
my $recordSyntax = $args{recordSyntax} ? $args{recordSyntax} : '';
my $class = $args{class} ? $args{class} : '';
+ # ADAM: Reset before we use it (not after)
+ IDZebra::odr_reset($self->{odr_stream});
my $ro = IDZebra::RetrievalObj->new();
IDZebra::records_retrieve($self->{session}{zh},
$to,
$ro);
-
my @res = ();
for (my $i=$from; $i<=$to; $i++) {
if ($class) {
} else {
- push (@res, $rec);
+ push (@res, $rec);
}
}
- IDZebra::odr_reset($self->{odr_stream});
-
return (@res);
}
croak ("Session is closed or out of scope");
}
- unless ($setname) {
- $_[0] = $self->{session}->sortResultsets($sortspec,
- $self->{name}, ($self));
- return ($_[0]);
- } else {
- return ($self->{session}->sortResultsets($sortspec,
- $setname, ($self)));
+ if (!$setname) {
+ $setname=$self->{session}->_new_setname();
}
+ return ($self->{session}->sortResultsets($sortspec,
+ $setname, ($self)));
+# unless ($setname) {
+# return ($_[0] = $self->{session}->sortResultsets($sortspec,
+# $self->{session}->_new_setname, ($self)));
+# return ($_[0]);
+# } else {
+# return ($self->{session}->sortResultsets($sortspec,
+# $setname, ($self)));
+# }
}
# ============================================================================
=head1 SORTING
+You can sort resultsets by calling:
+
+ $rs1->sort($sort_expr);
+
+or create a new sorted resultset:
+
+ $rs2 = $rs1->sort($sort_expr);
+
+The sort expression has the same format as described in the I<yaz_client> documentation. For example:
+
+ $rs1->sort('1=4 id');
+
+will sort thr results by title, in a case insensitive way, in descending order, while
+
+ $rs1->sort('1=4 a');
+will sort ascending by titles.
=head1 COPYRIGHT
=head1 SEE ALSO
-IDZebra, IDZebra::Data1, Zebra documentation
+Zebra documentation, IDZebra::ResultSet, IDZebra::RetrievalRecord manpages.
=cut