Koha/MetadataIterator.pm

   1 package Koha::MetadataIterator;
   2
   3 # This contains an iterator over biblio and authority records
   4
   5 # Copyright 2014 Catalyst IT
   6 #
   7 # This file is part of Koha.
   8 #
   9 # Koha is free software; you can redistribute it and/or modify it
  10 # under the terms of the GNU General Public License as published by
  11 # the Free Software Foundation; either version 3 of the License, or
  12 # (at your option) any later version.
  13 #
  14 # Koha is distributed in the hope that it will be useful, but
  15 # WITHOUT ANY WARRANTY; without even the implied warranty of
  16 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  17 # GNU General Public License for more details.
  18 #
  19 # You should have received a copy of the GNU General Public License
  20 # along with Koha; if not, see <http://www.gnu.org/licenses>.
  21
  22 =head1 NAME
  23
  24 Koha::MetadataIterator - iterates over records
  25
  26 =head1 DESCRIPTION
  27
  28 This provides a fairly generic iterator that will return records provided
  29 by a function.
  30
  31 =head1 SYNOPSIS
  32
  33     use Koha::MetadataIterator;
  34     my $next_func = sub {
  35         # something that'll return each record
  36     };
  37     my $iterator = Koha::MetadataIterator->new($next_func);
  38     while ( my $record = $iterator->next() ) {
  39         # do something with $record
  40     }
  41
  42 =head1 METHODS
  43
  44 =cut
  45
  46 use Modern::Perl;
  47
  48 =head2 new
  49
  50     my $it = new($next_func);
  51
  52 Takes a function that will provide the next bit of data.
  53
  54 =cut
  55
  56 sub new {
  57     my ( $class, $next_func ) = @_;
  58
  59     bless { next_func => $next_func, }, $class;
  60 }
  61
  62 =head2 next()
  63
  64 Provides the next record.
  65
  66 =cut
  67
  68 sub next {
  69     my ($self) = @_;
  70
  71     return $self->{next_func}->();
  72 }
  73
  74 1;