/[Search-Estraier]/trunk/lib/Search/Estraier.pm
This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!
ViewVC logotype

Diff of /trunk/lib/Search/Estraier.pm

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

trunk/Estraier.pm revision 108 by dpavlin, Sun Feb 19 17:13:57 2006 UTC trunk/lib/Search/Estraier.pm revision 199 by dpavlin, Sun Jan 20 16:51:47 2008 UTC
# Line 4  use 5.008; Line 4  use 5.008;
4  use strict;  use strict;
5  use warnings;  use warnings;
6    
7  our $VERSION = '0.04_2';  our $VERSION = '0.09';
8    
9  =head1 NAME  =head1 NAME
10    
# Line 20  Search::Estraier - pure perl module to u Line 20  Search::Estraier - pure perl module to u
20          my $node = new Search::Estraier::Node(          my $node = new Search::Estraier::Node(
21                  url => 'http://localhost:1978/node/test',                  url => 'http://localhost:1978/node/test',
22                  user => 'admin',                  user => 'admin',
23                  passwd => 'admin'                  passwd => 'admin',
24                    create => 1,
25                    label => 'Label for node',
26                    croak_on_error => 1,
27          );          );
28    
29          # create document          # create document
# Line 117  our @ISA = qw/Search::Estraier/; Line 120  our @ISA = qw/Search::Estraier/;
120    
121  =head1 Search::Estraier::Document  =head1 Search::Estraier::Document
122    
123  This class implements Document which is collection of attributes  This class implements Document which is single item in Hyper Estraier.
124  (key=value), vectors (also key value) display text and hidden text.  
125    It's is collection of:
126    
127    =over 4
128    
129    =item attributes
130    
131    C<< 'key' => 'value' >> pairs which can later be used for filtering of results
132    
133    You can add common filters to C<attrindex> in estmaster's C<_conf>
134    file for better performance. See C<attrindex> in
135    L<Hyper Estraier P2P Guide|http://hyperestraier.sourceforge.net/nguide-en.html>.
136    
137    =item vectors
138    
139    also C<< 'key' => 'value' >> pairs
140    
141    =item display text
142    
143    Text which will be used to create searchable corpus of your index and
144    included in snippet output.
145    
146    =item hidden text
147    
148    Text which will be searchable, but will not be included in snippet.
149    
150    =back
151    
152  =head2 new  =head2 new
153    
# Line 154  sub new { Line 182  sub new {
182    
183                          if ($line =~ m/^%VECTOR\t(.+)$/) {                          if ($line =~ m/^%VECTOR\t(.+)$/) {
184                                  my @fields = split(/\t/, $1);                                  my @fields = split(/\t/, $1);
185                                  for my $i ( 0 .. ($#fields - 1) ) {                                  if ($#fields % 2 == 1) {
186                                          $self->{kwords}->{ $fields[ $i ] } = $fields[ $i + 1 ];                                          $self->{kwords} = { @fields };
187                                          $i++;                                  } else {
188                                            warn "can't decode $line\n";
189                                  }                                  }
190                                  next;                                  next;
191                            } elsif ($line =~ m/^%SCORE\t(.+)$/) {
192                                $self->{score} = $1;
193                                next;
194                          } elsif ($line =~ m/^%/) {                          } elsif ($line =~ m/^%/) {
195                                  # What is this? comment?                                  # What is this? comment?
196                                  #warn "$line\n";                                  #warn "$line\n";
# Line 240  sub add_hidden_text { Line 272  sub add_hidden_text {
272          push @{ $self->{htexts} }, $self->_s($text);          push @{ $self->{htexts} }, $self->_s($text);
273  }  }
274    
275    =head2 add_vectors
276    
277    Add a vectors
278    
279      $doc->add_vector(
280            'vector_name' => 42,
281            'another' => 12345,
282      );
283    
284    =cut
285    
286    sub add_vectors {
287            my $self = shift;
288            return unless (@_);
289    
290            # this is ugly, but works
291            die "add_vector needs HASH as argument" unless ($#_ % 2 == 1);
292    
293            $self->{kwords} = {@_};
294    }
295    
296    =head2 set_score
297    
298    Set the substitute score
299    
300      $doc->set_score(12345);
301    
302    =cut
303    
304    sub set_score {
305        my $self = shift;
306        my $score = shift;
307        return unless (defined($score));
308        $self->{score} = $score;
309    }
310    
311    =head2 score
312    
313    Get the substitute score
314    
315    =cut
316    
317    sub score {
318        my $self = shift;
319        return -1 unless (defined($self->{score}));
320        return $self->{score};
321    }
322    
323  =head2 id  =head2 id
324    
# Line 334  sub dump_draft { Line 413  sub dump_draft {
413          }          }
414    
415          if ($self->{kwords}) {          if ($self->{kwords}) {
416                  $draft .= '%%VECTOR';                  $draft .= '%VECTOR';
417                  while (my ($key, $value) = each %{ $self->{kwords} }) {                  while (my ($key, $value) = each %{ $self->{kwords} }) {
418                          $draft .= "\t$key\t$value";                          $draft .= "\t$key\t$value";
419                  }                  }
420                  $draft .= "\n";                  $draft .= "\n";
421          }          }
422    
423            if (defined($self->{score}) && $self->{score} >= 0) {
424                $draft .= "%SCORE\t" . $self->{score} . "\n";
425            }
426    
427          $draft .= "\n";          $draft .= "\n";
428    
429          $draft .= join("\n", @{ $self->{dtexts} }) . "\n" if ($self->{dtexts});          $draft .= join("\n", @{ $self->{dtexts} }) . "\n" if ($self->{dtexts});
# Line 599  sub options { Line 682  sub options {
682  }  }
683    
684    
685    =head2 set_skip
686    
687    Set number of skipped documents from beginning of results
688    
689      $cond->set_skip(42);
690    
691    Similar to C<offset> in RDBMS.
692    
693    =cut
694    
695    sub set_skip {
696            my $self = shift;
697            $self->{skip} = shift;
698    }
699    
700    =head2 skip
701    
702    Return skip for this condition.
703    
704      print $cond->skip;
705    
706    =cut
707    
708    sub skip {
709            my $self = shift;
710            return $self->{skip};
711    }
712    
713    
714    =head2 set_distinct
715    
716      $cond->set_distinct('@author');
717    
718    =cut
719    
720    sub set_distinct {
721            my $self = shift;
722            $self->{distinct} = shift;
723    }
724    
725    =head2 distinct
726    
727    Return distinct attribute
728    
729      print $cond->distinct;
730    
731    =cut
732    
733    sub distinct {
734            my $self = shift;
735            return $self->{distinct};
736    }
737    
738    =head2 set_mask
739    
740    Filter out some links when searching.
741    
742    Argument array of link numbers, starting with 0 (current node).
743    
744      $cond->set_mask(qw/0 1 4/);
745    
746    =cut
747    
748    sub set_mask {
749            my $self = shift;
750            return unless (@_);
751            $self->{mask} = \@_;
752    }
753    
754    
755  package Search::Estraier::ResultDocument;  package Search::Estraier::ResultDocument;
756    
757  use Carp qw/croak/;  use Carp qw/croak/;
# Line 843  or in more verbose form Line 996  or in more verbose form
996    
997    my $node = new Search::HyperEstraier::Node(    my $node = new Search::HyperEstraier::Node(
998          url => 'http://localhost:1978/node/test',          url => 'http://localhost:1978/node/test',
999            user => 'admin',
1000            passwd => 'admin'
1001            create => 1,
1002            label => 'optional node label',
1003          debug => 1,          debug => 1,
1004          croak_on_error => 1          croak_on_error => 1
1005    );    );
# Line 855  with following arguments: Line 1012  with following arguments:
1012    
1013  URL to node  URL to node
1014    
1015    =item user
1016    
1017    specify username for node server authentication
1018    
1019    =item passwd
1020    
1021    password for authentication
1022    
1023    =item create
1024    
1025    create node if it doesn't exists
1026    
1027    =item label
1028    
1029    optional label for new node if C<create> is used
1030    
1031  =item debug  =item debug
1032    
1033  dumps a B<lot> of debugging output  dumps a B<lot> of debugging output
# Line 874  sub new { Line 1047  sub new {
1047          my $self = {          my $self = {
1048                  pxport => -1,                  pxport => -1,
1049                  timeout => 0,   # this used to be -1                  timeout => 0,   # this used to be -1
                 dnum => -1,  
                 wnum => -1,  
                 size => -1.0,  
1050                  wwidth => 480,                  wwidth => 480,
1051                  hwidth => 96,                  hwidth => 96,
1052                  awidth => 96,                  awidth => 96,
1053                  status => -1,                  status => -1,
1054          };          };
1055    
1056          bless($self, $class);          bless($self, $class);
1057    
1058          if ($#_ == 0) {          if ($#_ == 0) {
1059                  $self->{url} = shift;                  $self->{url} = shift;
1060          } else {          } else {
                 my $args = {@_};  
   
1061                  %$self = ( %$self, @_ );                  %$self = ( %$self, @_ );
1062    
1063                    $self->set_auth( $self->{user}, $self->{passwd} ) if ($self->{user});
1064    
1065                  warn "## Node debug on\n" if ($self->{debug});                  warn "## Node debug on\n" if ($self->{debug});
1066          }          }
1067    
1068            $self->{inform} = {
1069                    dnum => -1,
1070                    wnum => -1,
1071                    size => -1.0,
1072            };
1073    
1074            if ($self->{create}) {
1075                    if (! eval { $self->name } || $@) {
1076                            my $name = $1 if ($self->{url} =~ m#/node/([^/]+)/*#);
1077                            croak "can't find node name in '$self->{url}'" unless ($name);
1078                            my $label = $self->{label} || $name;
1079                            $self->master(
1080                                    action => 'nodeadd',
1081                                    name => $name,
1082                                    label => $label,
1083                            ) || croak "can't create node $name ($label)";
1084                    }
1085            }
1086    
1087          $self ? return $self : return undef;          $self ? return $self : return undef;
1088  }  }
1089    
# Line 984  Add a document Line 1174  Add a document
1174    
1175    $node->put_doc( $document_draft ) or die "can't add document";    $node->put_doc( $document_draft ) or die "can't add document";
1176    
1177  Return true on success or false on failture.  Return true on success or false on failure.
1178    
1179  =cut  =cut
1180    
# Line 992  sub put_doc { Line 1182  sub put_doc {
1182          my $self = shift;          my $self = shift;
1183          my $doc = shift || return;          my $doc = shift || return;
1184          return unless ($self->{url} && $doc->isa('Search::Estraier::Document'));          return unless ($self->{url} && $doc->isa('Search::Estraier::Document'));
1185          $self->shuttle_url( $self->{url} . '/put_doc',          if ($self->shuttle_url( $self->{url} . '/put_doc',
1186                  'text/x-estraier-draft',                  'text/x-estraier-draft',
1187                  $doc->dump_draft,                  $doc->dump_draft,
1188                  undef                  undef
1189          ) == 200;          ) == 200) {
1190                    $self->_clear_info;
1191                    return 1;
1192            }
1193            return undef;
1194  }  }
1195    
1196    
# Line 1015  sub out_doc { Line 1209  sub out_doc {
1209          my $id = shift || return;          my $id = shift || return;
1210          return unless ($self->{url});          return unless ($self->{url});
1211          croak "id must be number, not '$id'" unless ($id =~ m/^\d+$/);          croak "id must be number, not '$id'" unless ($id =~ m/^\d+$/);
1212          $self->shuttle_url( $self->{url} . '/out_doc',          if ($self->shuttle_url( $self->{url} . '/out_doc',
1213                  'application/x-www-form-urlencoded',                  'application/x-www-form-urlencoded',
1214                  "id=$id",                  "id=$id",
1215                  undef                  undef
1216          ) == 200;          ) == 200) {
1217                    $self->_clear_info;
1218                    return 1;
1219            }
1220            return undef;
1221  }  }
1222    
1223    
# Line 1037  sub out_doc_by_uri { Line 1235  sub out_doc_by_uri {
1235          my $self = shift;          my $self = shift;
1236          my $uri = shift || return;          my $uri = shift || return;
1237          return unless ($self->{url});          return unless ($self->{url});
1238          $self->shuttle_url( $self->{url} . '/out_doc',          if ($self->shuttle_url( $self->{url} . '/out_doc',
1239                  'application/x-www-form-urlencoded',                  'application/x-www-form-urlencoded',
1240                  "uri=" . uri_escape($uri),                  "uri=" . uri_escape($uri),
1241                  undef                  undef
1242          ) == 200;          ) == 200) {
1243                    $self->_clear_info;
1244                    return 1;
1245            }
1246            return undef;
1247  }  }
1248    
1249    
# Line 1059  sub edit_doc { Line 1261  sub edit_doc {
1261          my $self = shift;          my $self = shift;
1262          my $doc = shift || return;          my $doc = shift || return;
1263          return unless ($self->{url} && $doc->isa('Search::Estraier::Document'));          return unless ($self->{url} && $doc->isa('Search::Estraier::Document'));
1264          $self->shuttle_url( $self->{url} . '/edit_doc',          if ($self->shuttle_url( $self->{url} . '/edit_doc',
1265                  'text/x-estraier-draft',                  'text/x-estraier-draft',
1266                  $doc->dump_draft,                  $doc->dump_draft,
1267                  undef                  undef
1268          ) == 200;          ) == 200) {
1269                    $self->_clear_info;
1270                    return 1;
1271            }
1272            return undef;
1273  }  }
1274    
1275    
# Line 1221  sub _fetch_doc { Line 1427  sub _fetch_doc {
1427          $path = '/etch_doc' if ($a->{etch});          $path = '/etch_doc' if ($a->{etch});
1428    
1429          if ($a->{id}) {          if ($a->{id}) {
1430                  croak "id must be numberm not '$a->{id}'" unless ($a->{id} =~ m/^\d+$/);                  croak "id must be number not '$a->{id}'" unless ($a->{id} =~ m/^\d+$/);
1431                  $arg = 'id=' . $a->{id};                  $arg = 'id=' . $a->{id};
1432          } elsif ($a->{uri}) {          } elsif ($a->{uri}) {
1433                  $arg = 'uri=' . uri_escape($a->{uri});                  $arg = 'uri=' . uri_escape($a->{uri});
# Line 1270  sub _fetch_doc { Line 1476  sub _fetch_doc {
1476    
1477  sub name {  sub name {
1478          my $self = shift;          my $self = shift;
1479          $self->_set_info unless ($self->{name});          $self->_set_info unless ($self->{inform}->{name});
1480          return $self->{name};          return $self->{inform}->{name};
1481  }  }
1482    
1483    
# Line 1283  sub name { Line 1489  sub name {
1489    
1490  sub label {  sub label {
1491          my $self = shift;          my $self = shift;
1492          $self->_set_info unless ($self->{label});          $self->_set_info unless ($self->{inform}->{label});
1493          return $self->{label};          return $self->{inform}->{label};
1494  }  }
1495    
1496    
# Line 1296  sub label { Line 1502  sub label {
1502    
1503  sub doc_num {  sub doc_num {
1504          my $self = shift;          my $self = shift;
1505          $self->_set_info if ($self->{dnum} < 0);          $self->_set_info if ($self->{inform}->{dnum} < 0);
1506          return $self->{dnum};          return $self->{inform}->{dnum};
1507  }  }
1508    
1509    
# Line 1309  sub doc_num { Line 1515  sub doc_num {
1515    
1516  sub word_num {  sub word_num {
1517          my $self = shift;          my $self = shift;
1518          $self->_set_info if ($self->{wnum} < 0);          $self->_set_info if ($self->{inform}->{wnum} < 0);
1519          return $self->{wnum};          return $self->{inform}->{wnum};
1520  }  }
1521    
1522    
# Line 1322  sub word_num { Line 1528  sub word_num {
1528    
1529  sub size {  sub size {
1530          my $self = shift;          my $self = shift;
1531          $self->_set_info if ($self->{size} < 0);          $self->_set_info if ($self->{inform}->{size} < 0);
1532          return $self->{size};          return $self->{inform}->{size};
1533  }  }
1534    
1535    
# Line 1356  sub search { Line 1562  sub search {
1562          );          );
1563          return if ($rv != 200);          return if ($rv != 200);
1564    
1565          my (@docs, $hints);          my @records     = split /--------\[.*?\]--------(?::END)?\r?\n/, $resbody;
1566            my $hintsText   = splice @records, 0, 2; # starts with empty record
1567          my @lines = split(/\n/, $resbody);          my $hints               = { $hintsText =~ m/^(.*?)\t(.*?)$/gsm };
1568          return unless (@lines);  
1569            # process records
1570          my $border = $lines[0];          my $docs = [];
1571          my $isend = 0;          foreach my $record (@records)
1572          my $lnum = 1;          {
1573                    # split into keys and snippets
1574          while ( $lnum <= $#lines ) {                  my ($keys, $snippet) = $record =~ m/^(.*?)\n\n(.*?)$/s;
1575                  my $line = $lines[$lnum];  
1576                  $lnum++;                  # create document hash
1577                    my $doc                         = { $keys =~ m/^(.*?)=(.*?)$/gsm };
1578                  #warn "## $line\n";                  $doc->{'@keywords'}     = $doc->{keywords};
1579                  if ($line && $line =~ m/^\Q$border\E(:END)*$/) {                  ($doc->{keywords})      = $keys =~ m/^%VECTOR\t(.*?)$/gm;
1580                          $isend = $1;                  $doc->{snippet}         = $snippet;
1581                          last;  
1582                  }                  push @$docs, new Search::Estraier::ResultDocument(
1583                            attrs           => $doc,
1584                  if ($line =~ /\t/) {                          uri             => $doc->{'@uri'},
1585                          my ($k,$v) = split(/\t/, $line, 2);                          snippet         => $snippet,
1586                          $hints->{$k} = $v;                          keywords        => $doc->{'keywords'},
1587                  }                  );
         }  
   
         my $snum = $lnum;  
   
         while( ! $isend && $lnum <= $#lines ) {  
                 my $line = $lines[$lnum];  
                 #warn "# $lnum: $line\n";  
                 $lnum++;  
   
                 if ($line && $line =~ m/^\Q$border\E/) {  
                         if ($lnum > $snum) {  
                                 my $rdattrs;  
                                 my $rdvector;  
                                 my $rdsnippet;  
                                   
                                 my $rlnum = $snum;  
                                 while ($rlnum < $lnum - 1 ) {  
                                         #my $rdline = $self->_s($lines[$rlnum]);  
                                         my $rdline = $lines[$rlnum];  
                                         $rlnum++;  
                                         last unless ($rdline);  
                                         if ($rdline =~ /^%/) {  
                                                 $rdvector = $1 if ($rdline =~ /^%VECTOR\t(.+)$/);  
                                         } elsif($rdline =~ /=/) {  
                                                 $rdattrs->{$1} = $2 if ($rdline =~ /^(.+)=(.+)$/);  
                                         } else {  
                                                 confess "invalid format of response";  
                                         }  
                                 }  
                                 while($rlnum < $lnum - 1) {  
                                         my $rdline = $lines[$rlnum];  
                                         $rlnum++;  
                                         $rdsnippet .= "$rdline\n";  
                                 }  
                                 #warn Dumper($rdvector, $rdattrs, $rdsnippet);  
                                 if (my $rduri = $rdattrs->{'@uri'}) {  
                                         push @docs, new Search::Estraier::ResultDocument(  
                                                 uri => $rduri,  
                                                 attrs => $rdattrs,  
                                                 snippet => $rdsnippet,  
                                                 keywords => $rdvector,  
                                         );  
                                 }  
                         }  
                         $snum = $lnum;  
                         #warn "### $line\n";  
                         $isend = 1 if ($line =~ /:END$/);  
                 }  
   
1588          }          }
1589    
1590          if (! $isend) {          return new Search::Estraier::NodeResult( docs => $docs, hints => $hints );
                 warn "received result doesn't have :END\n$resbody";  
                 return;  
         }  
   
         #warn Dumper(\@docs, $hints);  
   
         return new Search::Estraier::NodeResult( docs => \@docs, hints => $hints );  
1591  }  }
1592    
1593    
# Line 1486  sub cond_to_query { Line 1636  sub cond_to_query {
1636          push @args, 'wwidth=' . $self->{wwidth};          push @args, 'wwidth=' . $self->{wwidth};
1637          push @args, 'hwidth=' . $self->{hwidth};          push @args, 'hwidth=' . $self->{hwidth};
1638          push @args, 'awidth=' . $self->{awidth};          push @args, 'awidth=' . $self->{awidth};
1639            push @args, 'skip=' . $cond->{skip} if ($cond->{skip});
1640    
1641            if (my $distinct = $cond->distinct) {
1642                    push @args, 'distinct=' . uri_escape($distinct);
1643            }
1644    
1645            if ($cond->{mask}) {
1646                    my $mask = 0;
1647                    map { $mask += ( 2 ** $_ ) } @{ $cond->{mask} };
1648    
1649                    push @args, 'mask=' . $mask if ($mask);
1650            }
1651    
1652          return join('&', @args);          return join('&', @args);
1653  }  }
# Line 1632  sub set_user { Line 1794  sub set_user {
1794          croak "mode must be number, not '$mode'" unless ($mode =~ m/^\d+$/);          croak "mode must be number, not '$mode'" unless ($mode =~ m/^\d+$/);
1795    
1796          $self->shuttle_url( $self->{url} . '/_set_user',          $self->shuttle_url( $self->{url} . '/_set_user',
1797                  'text/plain',                  'application/x-www-form-urlencoded',
1798                  'name=' . uri_escape($name) . '&mode=' . $mode,                  'name=' . uri_escape($name) . '&mode=' . $mode,
1799                  undef                  undef
1800          ) == 200;          ) == 200;
# Line 1665  sub set_link { Line 1827  sub set_link {
1827                  undef                  undef
1828          ) == 200) {          ) == 200) {
1829                  # refresh node info after adding link                  # refresh node info after adding link
1830                  $self->_set_info;                  $self->_clear_info;
1831                  return 1;                  return 1;
1832          }          }
1833            return undef;
1834  }  }
1835    
1836  =head2 admins  =head2 admins
# Line 1680  Return array of users with admin rights Line 1843  Return array of users with admin rights
1843    
1844  sub admins {  sub admins {
1845          my $self = shift;          my $self = shift;
1846          $self->_set_info unless ($self->{name});          $self->_set_info unless ($self->{inform}->{name});
1847          return $self->{admins};          return $self->{inform}->{admins};
1848  }  }
1849    
1850  =head2 guests  =head2 guests
# Line 1694  Return array of users with guest rights Line 1857  Return array of users with guest rights
1857    
1858  sub guests {  sub guests {
1859          my $self = shift;          my $self = shift;
1860          $self->_set_info unless ($self->{name});          $self->_set_info unless ($self->{inform}->{name});
1861          return $self->{guests};          return $self->{inform}->{guests};
1862  }  }
1863    
1864  =head2 links  =head2 links
# Line 1708  Return array of links for this node Line 1871  Return array of links for this node
1871    
1872  sub links {  sub links {
1873          my $self = shift;          my $self = shift;
1874          $self->_set_info unless ($self->{name});          $self->_set_info unless ($self->{inform}->{name});
1875          return $self->{links};          return $self->{inform}->{links};
1876  }  }
1877    
1878    =head2 cacheusage
1879    
1880    Return cache usage for a node
1881    
1882      my $cache = $node->cacheusage;
1883    
1884    =cut
1885    
1886    sub cacheusage {
1887            my $self = shift;
1888    
1889            return unless ($self->{url});
1890    
1891            my $resbody;
1892            my $rv = $self->shuttle_url( $self->{url} . '/cacheusage',
1893                    'text/plain',
1894                    undef,
1895                    \$resbody,
1896            );
1897    
1898            return if ($rv != 200 || !$resbody);
1899    
1900            return $resbody;
1901    }
1902    
1903    =head2 master
1904    
1905    Set actions on Hyper Estraier node master (C<estmaster> process)
1906    
1907      $node->master(
1908            action => 'sync'
1909      );
1910    
1911    All available actions are documented in
1912    L<http://hyperestraier.sourceforge.net/nguide-en.html#protocol>
1913    
1914    =cut
1915    
1916    my $estmaster_rest = {
1917            shutdown => {
1918                    status => 202,
1919            },
1920            sync => {
1921                    status => 202,
1922            },
1923            backup => {
1924                    status => 202,
1925            },
1926            userlist => {
1927                    status => 200,
1928                    returns => [ qw/name passwd flags fname misc/ ],
1929            },
1930            useradd => {
1931                    required => [ qw/name passwd flags/ ],
1932                    optional => [ qw/fname misc/ ],
1933                    status => 200,
1934            },
1935            userdel => {
1936                    required => [ qw/name/ ],
1937                    status => 200,
1938            },
1939            nodelist => {
1940                    status => 200,
1941                    returns => [ qw/name label doc_num word_num size/ ],
1942            },
1943            nodeadd => {
1944                    required => [ qw/name/ ],
1945                    optional => [ qw/label/ ],
1946                    status => 200,
1947            },
1948            nodedel => {
1949                    required => [ qw/name/ ],
1950                    status => 200,
1951            },
1952            nodeclr => {
1953                    required => [ qw/name/ ],
1954                    status => 200,
1955            },
1956            nodertt => {
1957                    status => 200,  
1958            },
1959    };
1960    
1961    sub master {
1962            my $self = shift;
1963    
1964            my $args = {@_};
1965    
1966            # have action?
1967            my $action = $args->{action} || croak "need action, available: ",
1968                    join(", ",keys %{ $estmaster_rest });
1969    
1970            # check if action is valid
1971            my $rest = $estmaster_rest->{$action};
1972            croak "action '$action' is not supported, available actions: ",
1973                    join(", ",keys %{ $estmaster_rest }) unless ($rest);
1974    
1975            croak "BUG: action '$action' needs return status" unless ($rest->{status});
1976    
1977            my @args;
1978    
1979            if ($rest->{required} || $rest->{optional}) {
1980    
1981                    map {
1982                            croak "need parametar '$_' for action '$action'" unless ($args->{$_});
1983                            push @args, $_ . '=' . uri_escape( $args->{$_} );
1984                    } ( @{ $rest->{required} } );
1985    
1986                    map {
1987                            push @args, $_ . '=' . uri_escape( $args->{$_} ) if ($args->{$_});
1988                    } ( @{ $rest->{optional} } );
1989    
1990            }
1991    
1992            my $uri = new URI( $self->{url} );
1993    
1994            my $resbody;
1995    
1996            my $status = $self->shuttle_url(
1997                    'http://' . $uri->host_port . '/master?action=' . $action ,
1998                    'application/x-www-form-urlencoded',
1999                    join('&', @args),
2000                    \$resbody,
2001                    1,
2002            ) or confess "shuttle_url failed";
2003    
2004            if ($status == $rest->{status}) {
2005    
2006                    # refresh node info after sync
2007                    $self->_clear_info if ($action eq 'sync' || $action =~ m/^node(?:add|del|clr)$/);
2008    
2009                    if ($rest->{returns} && wantarray) {
2010    
2011                            my @results;
2012                            my $fields = $#{$rest->{returns}};
2013    
2014                            foreach my $line ( split(/[\r\n]/,$resbody) ) {
2015                                    my @e = split(/\t/, $line, $fields + 1);
2016                                    my $row;
2017                                    foreach my $i ( 0 .. $fields) {
2018                                            $row->{ $rest->{returns}->[$i] } = $e[ $i ];
2019                                    }
2020                                    push @results, $row;
2021                            }
2022    
2023                            return @results;
2024    
2025                    } elsif ($resbody) {
2026                            chomp $resbody;
2027                            return $resbody;
2028                    } else {
2029                            return 0E0;
2030                    }
2031            }
2032    
2033            carp "expected status $rest->{status}, but got $status";
2034            return undef;
2035    }
2036    
2037  =head1 PRIVATE METHODS  =head1 PRIVATE METHODS
2038    
# Line 1741  sub _set_info { Line 2062  sub _set_info {
2062          return if ($rv != 200 || !$resbody);          return if ($rv != 200 || !$resbody);
2063    
2064          my @lines = split(/[\r\n]/,$resbody);          my @lines = split(/[\r\n]/,$resbody);
2065            
2066          ( $self->{name}, $self->{label}, $self->{dnum}, $self->{wnum}, $self->{size} ) =          $self->_clear_info;
2067                  split(/\t/, shift @lines, 5);  
2068            ( $self->{inform}->{name}, $self->{inform}->{label}, $self->{inform}->{dnum},
2069                    $self->{inform}->{wnum}, $self->{inform}->{size} ) = split(/\t/, shift @lines, 5);
2070    
2071          return $resbody unless (@lines);          return $resbody unless (@lines);
2072    
2073          shift @lines;          shift @lines;
2074    
2075          while(my $admin = shift @lines) {          while(my $admin = shift @lines) {
2076                  push @{$self->{admins}}, $admin;                  push @{$self->{inform}->{admins}}, $admin;
2077          }          }
2078            
2079          while(my $guest = shift @lines) {          while(my $guest = shift @lines) {
2080                  push @{$self->{guests}}, $guest;                  push @{$self->{inform}->{guests}}, $guest;
2081          }          }
2082    
2083          while(my $link = shift @lines) {          while(my $link = shift @lines) {
2084                  push @{$self->{links}}, $link;                  push @{$self->{inform}->{links}}, $link;
2085          }          }
2086    
2087          return $resbody;          return $resbody;
2088    
2089  }  }
2090    
2091    =head2 _clear_info
2092    
2093    Clear information for node
2094    
2095      $node->_clear_info;
2096    
2097    On next call to C<name>, C<label>, C<doc_num>, C<word_num> or C<size> node
2098    info will be fetch again from Hyper Estraier.
2099    
2100    =cut
2101    sub _clear_info {
2102            my $self = shift;
2103            $self->{inform} = {
2104                    dnum => -1,
2105                    wnum => -1,
2106                    size => -1.0,
2107            };
2108    }
2109    
2110  ###  ###
2111    
2112  =head1 EXPORT  =head1 EXPORT
# Line 1777  L<http://hyperestraier.sourceforge.net/> Line 2119  L<http://hyperestraier.sourceforge.net/>
2119    
2120  Hyper Estraier Ruby interface on which this module is based.  Hyper Estraier Ruby interface on which this module is based.
2121    
2122    Hyper Estraier now also has pure-perl binding included in distribution. It's
2123    a faster way to access databases directly if you are not running
2124    C<estmaster> P2P server.
2125    
2126  =head1 AUTHOR  =head1 AUTHOR
2127    
2128  Dobrica Pavlinusic, E<lt>dpavlin@rot13.orgE<gt>  Dobrica Pavlinusic, E<lt>dpavlin@rot13.orgE<gt>
2129    
2130    Robert Klep E<lt>robert@klep.nameE<gt> contributed refactored search code
2131    
2132  =head1 COPYRIGHT AND LICENSE  =head1 COPYRIGHT AND LICENSE
2133    
Legend:
Removed from v.108  
changed lines
  Added in v.199
  ViewVC Help
Powered by ViewVC 1.1.26