lib/ZOOM/IRSpy/Task/Retrieve.pm

   1 # $Id: Retrieve.pm,v 1.3 2006-11-02 16:11:44 mike Exp $
   2
   3 package ZOOM::IRSpy::Task::Retrieve;
   4
   5 use 5.008;
   6 use strict;
   7 use warnings;
   8
   9 use ZOOM::IRSpy::Task;
  10 our @ISA = qw(ZOOM::IRSpy::Task);
  11
  12 =head1 NAME
  13
  14 ZOOM::IRSpy::Task::Retrieve - a searching task for IRSpy
  15
  16 =head1 SYNOPSIS
  17
  18  ## to follow
  19
  20 =head1 DESCRIPTION
  21
  22  ## to follow
  23
  24 =cut
  25
  26 sub new {
  27     my $class = shift();
  28     my($rs) = shift();
  29     my($index0) = shift();
  30
  31     my $this = $class->SUPER::new(@_);
  32     $this->{rs} = $rs;
  33     $this->{index0} = $index0;
  34     return $this;
  35 }
  36
  37 sub run {
  38     my $this = shift();
  39
  40     $this->set_options();
  41
  42     my $conn = $this->conn();
  43     my $rs = $this->{rs};
  44     my $index0 = $this->{index0};
  45     $this->irspy()->log("irspy_task", $conn->option("host"),
  46                         " retrieving record $index0 from $rs");
  47     $rs->records($index0, 1, 0); # requests record
  48     warn "no ZOOM-C level events queued by $this"
  49         if $conn->is_idle();
  50
  51     $this->set_options();
  52 }
  53
  54 sub render {
  55     my $this = shift();
  56     my $syntax = $this->{options}->{preferredRecordSyntax};
  57     $syntax = defined $syntax ? "'$syntax'" : "undef";
  58     return ref($this) . "(" . $this->{index0} . ", $syntax)";
  59 }
  60
  61 use overload '""' => \&render;
  62
  63
  64 =head1 SEE ALSO
  65
  66 ZOOM::IRSpy
  67
  68 =head1 AUTHOR
  69
  70 Mike Taylor, E<lt>mike@indexdata.comE<gt>
  71
  72 =head1 COPYRIGHT AND LICENSE
  73
  74 Copyright (C) 2006 by Index Data ApS.
  75
  76 This library is free software; you can redistribute it and/or modify
  77 it under the same terms as Perl itself, either Perl version 5.8.7 or,
  78 at your option, any later version of Perl 5 you may have available.
  79
  80 =cut
  81
  82 1;