Webpacus/Model/WebPAC.pm

package Webpacus::Model::WebPAC;

use strict;
use warnings;
use lib '/data/webpac2/lib';
use base qw/
        Catalyst::Model
/;
use WebPAC::Store 0.08;
use Search::Estraier 0.04;
use File::Slurp;
use Time::HiRes qw/time/;
use Encode qw/encode decode from_to/;
use Template;

=head1 NAME

Webpacus::Model::WebPAC - Catalyst Model

=head1 SYNOPSIS

See L<Webpacus> and L<WebPAC>.

=head1 DESCRIPTION

Catalyst Model for access to WebPAC data.

=head2 new

Configuration for hyperestraier in C<config.yaml> like this:

 --- #YAML:1.0
 # DO NOT USE TABS FOR INDENTATION OR label/value SEPARATION!!!

 # configuration for hyper estraier full text search engine
 hyperestraier:
  masterurl: 'http://localhost:1978/node/webpac2'
  defaultnode: 'webpac2'
  defaultdepth: 1
  user: 'admin'
  passwd: 'admin'
  hits_on_page: 100
  hits_for_pager: 1000

 webpac:
  db_path: '/data/webpac2/db'
  template_path: '/data/webpac2/conf/output/tt'
  template: 'html_ffzg_results_short.tt'
  # encoding comming from webpac
  webpac_encoding: 'iso-8859-2'

=cut

sub new {
        my ( $self, $c, $config ) = @_;

        $self = $self->NEXT::new($c, $config);
        $self->config($config);

        my $log = $c->log;
        $self->{log} = $log;

        my $est_cfg = $c->config->{hyperestraier};
        $est_cfg->{'log'} = $log;

        $est_cfg->{encoding} = $est_cfg->{catalyst_encoding} || $c->config->{catalyst_encoding} or $c->log->fatal("can't find catalyst_encoding");

        $log->dumper($est_cfg, 'est_cfg');

        if (! $est_cfg->{database}) {
                my $defaultnode = $est_cfg->{defaultnode} || $log->logdie("can't find defaultnode in estraier configuration");
                $log->info("using default node $defaultnode");
                $est_cfg->{database} = $defaultnode;
        }

        my $url = $est_cfg->{masterurl} . '/node/' . $est_cfg->{database};

        $log->info("opening Hyper Estraier index $url as $est_cfg->{'user'}");

        $self->{est_node} = Search::Estraier::Node->new(
                url => $url,
                user => $est_cfg->{user},
                passwd => $est_cfg->{passwd},
        );

        $log->fatal("can't create Search::Estraier::Node $url") unless ($self->{est_node});

        # save config parametars in object
        foreach my $f (qw/
                db_path template_path hits_on_page webpac_encoding defaultdepth
                masterurl defaultnode
                /) {
                $self->{$f} = $c->config->{hyperestraier}->{$f} ||
                        $c->config->{webpac}->{$f};
                $log->debug("self->{$f} = " . $self->{$f});
        }
        my $db_path = $self->{db_path};
        my $template_path = $self->{template_path};

        $log->debug("using db path '$db_path', template path '$template_path'");

        $self->{db} = new WebPAC::Store(
                path => $db_path,
                read_only => 1,
                database => $est_cfg->{database},
        );

        # default template from config.yaml
        $self->{template} ||= $c->config->{webpac}->{template};

        $log->debug("converting encoding from webpac_encoding '" .
                $c->config->{webpac}->{webpac_encoding} .
                "'"
        );

        $self->{databases} = $c->config->{databases} || $log->fatal("can't find databases in config");

        # create Template toolkit instance
        $self->{'tt'} = Template->new(
                INCLUDE_PATH => $template_path,
                FILTERS => {
                        dump_html => sub {
                                return unless (@_);
                                my $out;
                                my $i = 1;
                                foreach my $v (@_) {
                                        $out .= qq{<div id="dump_$i">} .
                                                Data::HTMLDumper->Dump([ $v ],[ "v$i" ]) .
                                                qq{</div>};
                                        $i++;
                                }
                                $out =~ s!<table[^>/]*>!<table class="dump">!gis if ($out);
                                return $out;
                        }
                },
                EVAL_PERL => 1,
        );

        return $self;

}

=head2 setup_site

 $self->setup_site('site_name');

Change node URL and database name according to site name (if available) or fallback
to C<defaultnode> from configuration.

=cut

sub setup_site {
        my $self = shift;

        my $site = shift || $self->{defaultnode};

        $self->{log}->fatal("setup_site can't find site or defaultnode") unless ($site);

        my $url = $self->{masterurl} . '/node/' . $site;
        $self->{est_node}->set_url( $url );
        $self->{log}->debug("setup_site $site using $url");
}

=head2 search

  my $m->search(
        phrase => 'query phrase',
        add_attr => \@add_attr
        get_attr => [ '@uri' ],
        max => 42,
        template => 'result_template.tt',
        depth => 1,
  );

All fields are standard C<WebPAC::Search::Estraier> parametars except
C<template> which will (if specified) return results in HTML using
selected template.

=cut

sub search {
        my $self = shift;

        my $search_start_t = time();

        my $args = {@_};

        my $log = $self->{log};

        $log->dumper($args, 'args');

        my $query = $args->{phrase} || $log->warn("no query phrase") && return;

        my $template_filename = $args->{template} || $self->{template};

        $args->{max} ||= $self->{'hits_for_pager'};
        if (! $args->{max}) {
                $args->{max} = 100;
                $log->warn("max not set when calling model. Using default of $args->{max}");
        }

        my $times;      # store some times for benchmarking

        my $t = time();

        # transfer depth of search
        if (! $args->{depth}) {
                my $default = $self->{defaultdepth} || $log->logdie("can't find defaultdepth in estraier configuration");
                $args->{depth} = $default;
                $log->warn("using default search depth $default");
        }
        $args->{depth} ||= 0;

        $log->debug("searching for maximum $args->{max} results using depth $args->{depth} phrase: ", $query || '[none]');

        #
        # construct condition for Hyper Estraier
        #
        my $cond = Search::Estraier::Condition->new();
        if ( ref($args->{add_attr}) eq 'ARRAY' ) {
                $log->debug("adding search attributes: " . join(", ", @{ $args->{add_attr} }) );
                map {
                        $cond->add_attr( $_ );
                        $log->debug(" + $_");
                } @{ $args->{add_attr} };
        };

        $cond->set_phrase( $query ) if ($query);
        $cond->set_options( $args->{options} ) if ($args->{options});
        $cond->set_order( $args->{order} ) if ($args->{order});

        my $max = $args->{max} || 7;
        my $page = $args->{page} || 1;
        if ($page < 1) {
                $log->warn("page number $page < 1");
                $page = 1;
        }

        $cond->set_max( $page * $max );

        my $result = $self->{est_node}->search($cond, $args->{depth});
        my $hits = $result->doc_num;

        $times->{est} += time() - $t;

        $log->debug( sprintf("search took %.6fs and returned $hits hits.", $times->{est}) );

        $log->dumper($result->{hints}, 'result->hints' );

        #
        # fetch results
        #

        my @results;

        for my $i ( (($page - 1) * $max) .. ( $hits - 1 ) ) {

                $t = time();

                #$log->debug("get_doc($i)");
                my $doc = $result->get_doc( $i );
                if (! $doc) {
                        $log->warn("can't find result $i");
                        next;
                }

                my $hash;

                foreach my $attr (@{ $args->{get_attr} }) {
                        my $val = $doc->attr( $attr );
                        #$log->debug("attr $attr = ", $val || 'undef');
                        $hash->{$attr} = $val if (defined($val));
                }

                $times->{hash} += time() - $t;

                next unless ($hash);

                if (! $args->{'template'}) {
                        push @results, $hash;
                } else {
                        my ($database, $prefix, $id);

                        if ( $hash->{'@uri'} =~ m!/([^/]+)/([^/]+)/(\d+)$!) {
                                ($database, $prefix,$id) = ($1,$2,$3);
                        } else {
                                $log->warn("can't decode database/prefix/id from " .  $hash->{'@uri'});
                                next;
                        }

                        #$log->debug("load_ds( id => $id, prefix => '$prefix' )");

                        $t = time();

                        my $ds = $self->{db}->load_ds( database => $database, prefix => $prefix, id => $id );
                        if (! $ds) {
                                $log->error("can't load_ds( ${database}/${prefix}/${id} )");
                                next;
                        }

                        $times->{db} += time() - $t;

                        $t = time();

                        my $html = $self->apply(
                                template => $template_filename,
                                data => $ds,
                                record_uri => "${database}/${prefix}/${id}",
                                config => $self->{databases}->{$database},
                        );

                        $times->{apply} += time() - $t;

                        $t = time();

                        $html = decode($self->{webpac_encoding}, $html);

                        $times->{decode} += time() - $t;

                        push @results, $html;
                }

        }

        $log->debug( sprintf(
                "duration breakdown: estraier %.6fs, hash %.6fs, store %.6fs, apply %.6fs, decode %.06f, total: %.6fs",
                $times->{est}, $times->{hash}, $times->{db}, $times->{apply}, $times->{decode}, time() - $search_start_t,
        ) );

        return \@results;
}

=head2 record

  my $html = $m->record(
        mfn => 42,
        template => 'foo.tt',
  );

This will load one record, convert it to html using C<template> and return
it.

=cut

sub record {
        my $self = shift;

        my $args = {@_};
        my $log = $self->{log};
        $log->dumper( $args, 'args' );

        foreach my $f (qw/record_uri template/) {
                $log->fatal("need $f") unless ($args->{$f});
        }

        my ($database, $prefix, $id);

        if ($args->{record_uri} =~ m#^([^/]+)/([^/]+)/([^/]+)$#) {
                ($database, $prefix, $id) = ($1,$2,$3);
        } else {
                $log->error("can't parse $args->{record_uri} into prefix, database and uri");
                return;
        }

        my $ds = $self->{db}->load_ds( id => $id, prefix => $prefix, database => $database );
        if (! $ds) {
                $log->error("can't load_ds( $database/$prefix/$id )");
                return;
        }

        my $html = $self->apply(
                template => $args->{template},
                data => $ds,
                record_uri => $args->{record_uri},
                config => $self->{databases}->{$database},
        );

        $html = decode($self->{webpac_encoding}, $html);

        return $html;
}


=head2 list_nodes

  my @nodes = $m->list_nodes( 'site' );

Return all databases which have records for selected site. Returned array of
hashes has elements C<name> and C<label>.

=cut

sub list_nodes {
        my $self = shift;

        my $site = shift;

        $self->{log}->debug("list_nodes use site $site");

        $self->setup_site( $site );

        my @nodes;

        if ($self->{est_node}->doc_num > 0) {
                push @nodes, {
                        name => $self->{est_node}->name,
                        label => $self->{est_node}->label,
                }
        }

        # refresh set info
        $self->{est_node}->_set_info;

        my $links = $self->{est_node}->links || return @nodes;

        $self->{log}->dumper( $links, 'links' );

        foreach my $link (@{ $links }) {
                my ($url, $label, $credit) = split(/\t/, $link, 3);
                if ($url =~ m#/node/(.+)$#) {
                        push @nodes, {
                                name => $1,
                                label => $label,
                        }
                } else {
                        $self->{log}->warn("can't find node name in link $link");
                }
        }

        $self->{log}->dumper( \@nodes, 'nodes' );

        return @nodes;
}

=cut


=head2 save_html

  $m->save_html( '/full/path/to/file', $content );

It will use C<Encode> to convert content encoding back to
Webpac codepage, recode JavaScript Unicode entities (%u1234),
strip extra newlines at beginning and end, and save to 
C</full/path/to/file.new> and if that succeeds, just rename
it over original file which should be atomic on filesystem level.

=cut

sub save_html {
        my ($self, $path, $content) = @_;

        # FIXME Should this be UTF-8 or someting?
        my $js_encoding = $self->{webpac_encoding};
        $js_encoding = 'UTF-16';

        sub _conv_js {
                return '0x' . $_[1];
                return encode($_[0], chr(hex($_[1])));
        }
        #$content =~ s/%u([a-fA-F0-9]{4})/_conv_js($js_encoding,$1)/gex;
        $content =~ s/^[\n\r]+//s;
        $content =~ s/[\n\r]+$/\n/s;
        $content =~ s/\n\r/\n/gs;

        my $disk_encoding = $self->{webpac_encoding} || 'utf-8';
        $self->{log}->debug("convert encoding to $disk_encoding");
        from_to($content, 'utf-8', $disk_encoding) || $self->{log}->warn("encoding from utf-8 to $disk_encoding failed for: $content");

        write_file($path . '.new', {binmode => ':raw' }, $content) || die "can't save ${path}.new $!";
        rename $path . '.new', $path || die "can't rename to $path: $!";
}

=head2 load_html

  my $html = $m->load_html('/full/path/to/file');

This will convert file from Webpac encoding to Catalyst and
convert that data to escaped HTML (for sending into
C<< <textarea/> >> tags in html.

=cut

sub load_html {
        my ($self, $path) = @_;

        die "no path?" unless ($path);

        my $content = read_file($path, {binmode => ':raw' }) || die "can't read $path: $!";

        return decode($self->{webpac_encoding}, $content);
}


=head2 apply

Create output from in-memory data structure using Template Toolkit template.

 my $text = $tt->apply(
        template => 'text.tt',
        data => $ds,
        record_uri => 'database/prefix/mfn',
 );

It also has follwing template toolikit filter routies defined:

=cut

sub apply {
        my $self = shift;

        my $args = {@_};

        my $log = $self->{log} || die "no log?";

        foreach my $a (qw/template data/) {
                $log->fatal("need $a") unless ($args->{$a});
        }

=head3 tt_filter_type

filter to return values of specified from $ds, usage from TT template is in form
C<d('FieldName','delimiter')>, where C<delimiter> is optional, like this:

  [% d('Title') %]
  [% d('Author',', ' %]

=cut

        sub tt_filter_type {
                my ($data,$type) = @_;
                
                die "no data?" unless ($data);
                $type ||= 'display';

                my $default_delimiter = {
                        'display' => '&#182;<br/>',
                        'index' => '\n',
                };

                return sub {

                        my ($name,$join) = @_;

                        die "no data hash" unless ($data->{'data'} && ref($data->{'data'}) eq 'HASH');
                        # Hm? Should we die here?
                        return unless ($name);

                        my $item = $data->{'data'}->{$name} || return;

                        my $v = $item->{$type} || return;

                        if (ref($v) eq 'ARRAY') {
                                if ($#{$v} == 0) {
                                        $v = $v->[0];
                                } else {
                                        $join = $default_delimiter->{$type} unless defined($join);
                                        $v = join($join, @{$v});
                                }
                        } else {
                                warn("TT filter $type(): field $name values aren't ARRAY, ignoring");
                        }

                        return $v;
                }
        }

        $args->{'d'} = tt_filter_type($args, 'display');
        $args->{'display'} = tt_filter_type($args, 'display');

=head3 tt_filter_search

filter to return links to search, usage in TT:

  [% search('FieldToDisplay','FieldToSearch','optional delimiter', 'optional_template.tt') %]

=cut

        sub tt_filter_search {

                my ($data) = @_;

                die "no data?" unless ($data);
                
                return sub {

                        my ($display,$search,$delimiter,$template) = @_;
                        
                        # default delimiter
                        $delimiter ||= '&#182;<br/>',

                        die "no data hash" unless ($data->{'data'} && ref($data->{'data'}) eq 'HASH');
                        # Hm? Should we die here?
                        return unless ($display);

                        my $item = $data->{'data'}->{$display} || return;

                        return unless($item->{'display'});
                        if (! $item->{'search'}) {
                                warn "error in TT template: field $display didn't insert anything into search, use d('$display') and not search('$display'...)";
                                return;
                        }

                        my @warn;
                        foreach my $type (qw/display search/) {
                                push @warn, "field $display type $type values aren't ARRAY" unless (ref($item->{$type}) eq 'ARRAY');
                        }

                        if (@warn) {
                                warn("TT filter search(): " . join(",", @warn) . ", skipping");
                                return;
                        }
                        my @html;

                        my $d_el = $#{ $item->{'display'} };
                        my $s_el = $#{ $item->{'search'} }; 

                        # easy, both fields have same number of elements or there is just
                        # one search and multiple display
                        if ( $d_el == $s_el || $s_el == 0 ) {

                                foreach my $i ( 0 .. $d_el ) {

                                        my $s;
                                        if ($s_el > 0) {
                                                $s = $item->{'search'}->[$i] or warn "can't find value $i for type search in field $search";
                                        } else {
                                                $s = $item->{'search'}->[0];
                                        }
                                        #$s =~ s/([^\w.-])/sprintf("%%%02X",ord($1))/eg;
                                        $s = __quotemeta( $s );

                                        my $d = $item->{'display'}->[$i] or warn "can't find value $i for type display in field $display";

                                        my $template_arg = '';
                                        $template_arg = qq{,'$template'} if ($template);

                                        push @html, qq{<a href="#" onclick="return search_via_link('$search','$s'${template_arg})">$d</a>};
                                }

                                return join($delimiter, @html);
                        } else {
                                my $html = qq{<div class="notice">WARNING: we should really support if there is $d_el display elements and $s_el search elements, but currently there is no nice way to do so, so we will just display values</div>};
                                my $v = $item->{'display'};

                                if ($#{$v} == 0) {
                                        $html .= $v->[0];
                                } else {
                                        $html .= join($delimiter, @{$v});
                                }
                                return $html;
                        }
                }
        }

        $args->{'search'} = tt_filter_search($args);

=head3 load_rec

Used mostly for onClick events like this:

  <a href="#" onClick="[% load_rec( record_uri, 'template_name.tt') %]>foo</a>

It will automatically do sanity checking and create correct JavaScript code.

=cut

        $args->{'load_rec'} = sub {
                my @errors;

                my $record_uri = shift or push @errors, "record_uri missing";
                my $template = shift or push @errors, "template missing";

                if ($record_uri !~ m#^[^/]+/[^/]+/[^/]+$#) {
                        push @errors, "invalid format of record_uri: $record_uri";
                }

                if (@errors) {
                        return "Logger.error('errors in load_rec: " . join(", ", @errors) . "'); return false;";
                } else {
                        return "load_rec('$record_uri','$template'); return false;";
                }
        };

=head3 load_template

Used to re-submit search request and load results in different template

  <a href="#" onClick="[% load_template( 'template_name.tt' ) %]">bar</a>

=cut

        $args->{'load_template'} = sub {
                my $template = shift or return "Logger.error('load_template missing template name!'); return false;";
                return "load_template($template); return false;";
        };

        my $out;

        $self->{'tt'}->process(
                $args->{'template'},
                $args,
                \$out
        ) || $log->error( "apply can't process template: ", $self->{'tt'}->error() );

        return $out;
}


=head2 __quotemeta

Helper to quote JavaScript-friendly characters

=cut

sub __quotemeta {
        local $_ = shift;
        $_ = decode('iso-8859-2', $_);

        s<([\x{0080}-\x{fffd}]+)>{sprintf '\u%0*v4X', '\u', $1}ge if ( Encode::is_utf8($_) );
        {
                use bytes;  
                s<((?:[^ \x21-\x7E]|(?:\\(?!u)))+)>{sprintf '\x%0*v2X', '\x', $1}ge;
        }

        s/\\x09/\\t/g;
        s/\\x0A/\\n/g;
        s/\\x0D/\\r/g;
        s/"/\\"/g;
        s/\\x5C/\\\\/g;

        return $_;
}


=head1 AUTHOR

Dobrica Pavlinusic C<< <dpavlin@rot13.org> >>

=head1 LICENSE

This library is free software, you can redistribute it and/or modify
it under the same terms as Perl itself.

=cut

1;
1	dpavlin	92	package Webpacus::Model::WebPAC;
2
3			use strict;
4			use warnings;
5			use lib '/data/webpac2/lib';
6	dpavlin	93	use base qw/
7			Catalyst::Model
8			/;
9	dpavlin	237	use WebPAC::Store 0.08;
10	dpavlin	382	use Search::Estraier 0.04;
11	dpavlin	135	use File::Slurp;
12	dpavlin	378	use Time::HiRes qw/time/;
13	dpavlin	348	use Encode qw/encode decode from_to/;
14	dpavlin	379	use Template;
15	dpavlin	92
16			=head1 NAME
17
18			Webpacus::Model::WebPAC - Catalyst Model
19
20			=head1 SYNOPSIS
21
22			See L<Webpacus> and L<WebPAC>.
23
24			=head1 DESCRIPTION
25
26			Catalyst Model for access to WebPAC data.
27
28			=head2 new
29
30			Configuration for hyperestraier in C<config.yaml> like this:
31
32			--- #YAML:1.0
33			# DO NOT USE TABS FOR INDENTATION OR label/value SEPARATION!!!
34
35			# configuration for hyper estraier full text search engine
36			hyperestraier:
37	dpavlin	222	masterurl: 'http://localhost:1978/node/webpac2'
38			defaultnode: 'webpac2'
39			defaultdepth: 1
40	dpavlin	96	user: 'admin'
41			passwd: 'admin'
42	dpavlin	143	hits_on_page: 100
43	dpavlin	305	hits_for_pager: 1000
44	dpavlin	92
45	dpavlin	96	webpac:
46			db_path: '/data/webpac2/db'
47			template_path: '/data/webpac2/conf/output/tt'
48			template: 'html_ffzg_results_short.tt'
49			# encoding comming from webpac
50			webpac_encoding: 'iso-8859-2'
51
52	dpavlin	92	=cut
53
54			sub new {
55			my ( $self, $c, $config ) = @_;
56
57			$self = $self->NEXT::new($c, $config);
58			$self->config($config);
59
60			my $log = $c->log;
61	dpavlin	94	$self->{log} = $log;
62	dpavlin	92
63	dpavlin	93	my $est_cfg = $c->config->{hyperestraier};
64			$est_cfg->{'log'} = $log;
65	dpavlin	92
66	dpavlin	271	$est_cfg->{encoding} = $est_cfg->{catalyst_encoding} \|\| $c->config->{catalyst_encoding} or $c->log->fatal("can't find catalyst_encoding");
67	dpavlin	142
68	dpavlin	400	$log->dumper($est_cfg, 'est_cfg');
69	dpavlin	92
70	dpavlin	222	if (! $est_cfg->{database}) {
71			my $defaultnode = $est_cfg->{defaultnode} \|\| $log->logdie("can't find defaultnode in estraier configuration");
72			$log->info("using default node $defaultnode");
73			$est_cfg->{database} = $defaultnode;
74			}
75
76	dpavlin	382	my $url = $est_cfg->{masterurl} . '/node/' . $est_cfg->{database};
77	dpavlin	92
78	dpavlin	382	$log->info("opening Hyper Estraier index $url as $est_cfg->{'user'}");
79
80			$self->{est_node} = Search::Estraier::Node->new(
81			url => $url,
82			user => $est_cfg->{user},
83			passwd => $est_cfg->{passwd},
84			);
85
86			$log->fatal("can't create Search::Estraier::Node $url") unless ($self->{est_node});
87
88	dpavlin	167	# save config parametars in object
89	dpavlin	399	foreach my $f (qw/
90			db_path template_path hits_on_page webpac_encoding defaultdepth
91	dpavlin	400	masterurl defaultnode
92	dpavlin	399	/) {
93	dpavlin	167	$self->{$f} = $c->config->{hyperestraier}->{$f} \|\|
94			$c->config->{webpac}->{$f};
95			$log->debug("self->{$f} = " . $self->{$f});
96			}
97			my $db_path = $self->{db_path};
98			my $template_path = $self->{template_path};
99	dpavlin	95
100			$log->debug("using db path '$db_path', template path '$template_path'");
101
102	dpavlin	222	$self->{db} = new WebPAC::Store(
103	dpavlin	95	path => $db_path,
104			read_only => 1,
105	dpavlin	224	database => $est_cfg->{database},
106	dpavlin	95	);
107
108	dpavlin	101	# default template from config.yaml
109	dpavlin	95	$self->{template} \|\|= $c->config->{webpac}->{template};
110
111	dpavlin	100	$log->debug("converting encoding from webpac_encoding '" .
112			$c->config->{webpac}->{webpac_encoding} .
113	dpavlin	99	"'"
114			);
115	dpavlin	96
116	dpavlin	382	$self->{databases} = $c->config->{databases} \|\| $log->fatal("can't find databases in config");
117	dpavlin	155
118	dpavlin	379	# create Template toolkit instance
119			$self->{'tt'} = Template->new(
120			INCLUDE_PATH => $template_path,
121			FILTERS => {
122			dump_html => sub {
123			return unless (@_);
124			my $out;
125			my $i = 1;
126			foreach my $v (@_) {
127			$out .= qq{<div id="dump_$i">} .
128			Data::HTMLDumper->Dump([ $v ],[ "v$i" ]) .
129			qq{</div>};
130			$i++;
131			}
132			$out =~ s!<table[^>/]*>!<table class="dump">!gis if ($out);
133			return $out;
134			}
135			},
136			EVAL_PERL => 1,
137			);
138	dpavlin	378
139	dpavlin	92	return $self;
140
141			}
142
143	dpavlin	399	=head2 setup_site
144	dpavlin	135
145	dpavlin	399	$self->setup_site('site_name');
146
147	dpavlin	400	Change node URL and database name according to site name (if available) or fallback
148			to C<defaultnode> from configuration.
149	dpavlin	399
150			=cut
151
152			sub setup_site {
153			my $self = shift;
154
155	dpavlin	400	my $site = shift \|\| $self->{defaultnode};
156	dpavlin	399
157	dpavlin	400	$self->{log}->fatal("setup_site can't find site or defaultnode") unless ($site);
158
159	dpavlin	399	my $url = $self->{masterurl} . '/node/' . $site;
160			$self->{est_node}->set_url( $url );
161	dpavlin	400	$self->{log}->debug("setup_site $site using $url");
162	dpavlin	399	}
163
164	dpavlin	135	=head2 search
165
166	dpavlin	150	my $m->search(
167			phrase => 'query phrase',
168	dpavlin	155	add_attr => \@add_attr
169			get_attr => [ '@uri' ],
170			max => 42,
171	dpavlin	150	template => 'result_template.tt',
172	dpavlin	222	depth => 1,
173	dpavlin	150	);
174	dpavlin	135
175	dpavlin	155	All fields are standard C<WebPAC::Search::Estraier> parametars except
176			C<template> which will (if specified) return results in HTML using
177			selected template.
178
179	dpavlin	135	=cut
180
181	dpavlin	93	sub search {
182	dpavlin	150	my $self = shift;
183	dpavlin	93
184	dpavlin	378	my $search_start_t = time();
185
186	dpavlin	150	my $args = {@_};
187
188	dpavlin	95	my $log = $self->{log};
189	dpavlin	94
190	dpavlin	400	$log->dumper($args, 'args');
191	dpavlin	95
192	dpavlin	150	my $query = $args->{phrase} \|\| $log->warn("no query phrase") && return;
193	dpavlin	95
194	dpavlin	150	my $template_filename = $args->{template} \|\| $self->{template};
195
196	dpavlin	305	$args->{max} \|\|= $self->{'hits_for_pager'};
197	dpavlin	155	if (! $args->{max}) {
198	dpavlin	305	$args->{max} = 100;
199			$log->warn("max not set when calling model. Using default of $args->{max}");
200	dpavlin	155	}
201	dpavlin	93
202	dpavlin	155	my $times; # store some times for benchmarking
203
204			my $t = time();
205
206	dpavlin	222	# transfer depth of search
207			if (! $args->{depth}) {
208			my $default = $self->{defaultdepth} \|\| $log->logdie("can't find defaultdepth in estraier configuration");
209			$args->{depth} = $default;
210			$log->warn("using default search depth $default");
211			}
212	dpavlin	383	$args->{depth} \|\|= 0;
213	dpavlin	222
214	dpavlin	383	$log->debug("searching for maximum $args->{max} results using depth $args->{depth} phrase: ", $query \|\| '[none]');
215	dpavlin	155
216	dpavlin	382	#
217			# construct condition for Hyper Estraier
218			#
219			my $cond = Search::Estraier::Condition->new();
220			if ( ref($args->{add_attr}) eq 'ARRAY' ) {
221			$log->debug("adding search attributes: " . join(", ", @{ $args->{add_attr} }) );
222			map {
223	dpavlin	383	$cond->add_attr( $_ );
224	dpavlin	382	$log->debug(" + $_");
225			} @{ $args->{add_attr} };
226			};
227
228			$cond->set_phrase( $query ) if ($query);
229			$cond->set_options( $args->{options} ) if ($args->{options});
230			$cond->set_order( $args->{order} ) if ($args->{order});
231
232			my $max = $args->{max} \|\| 7;
233			my $page = $args->{page} \|\| 1;
234			if ($page < 1) {
235			$log->warn("page number $page < 1");
236			$page = 1;
237			}
238
239			$cond->set_max( $page * $max );
240	dpavlin	99
241	dpavlin	383	my $result = $self->{est_node}->search($cond, $args->{depth});
242	dpavlin	382	my $hits = $result->doc_num;
243
244	dpavlin	384	$times->{est} += time() - $t;
245
246	dpavlin	380	$log->debug( sprintf("search took %.6fs and returned $hits hits.", $times->{est}) );
247	dpavlin	150
248	dpavlin	400	$log->dumper($result->{hints}, 'result->hints' );
249	dpavlin	385
250	dpavlin	155	#
251	dpavlin	382	# fetch results
252	dpavlin	155	#
253
254	dpavlin	382	my @results;
255	dpavlin	100
256	dpavlin	382	for my $i ( (($page - 1) * $max) .. ( $hits - 1 ) ) {
257	dpavlin	95
258	dpavlin	382	$t = time();
259
260			#$log->debug("get_doc($i)");
261			my $doc = $result->get_doc( $i );
262			if (! $doc) {
263			$log->warn("can't find result $i");
264	dpavlin	224	next;
265			}
266	dpavlin	95
267	dpavlin	382	my $hash;
268	dpavlin	95
269	dpavlin	382	foreach my $attr (@{ $args->{get_attr} }) {
270			my $val = $doc->attr( $attr );
271			#$log->debug("attr $attr = ", $val \|\| 'undef');
272			$hash->{$attr} = $val if (defined($val));
273	dpavlin	242	}
274	dpavlin	155
275	dpavlin	382	$times->{hash} += time() - $t;
276	dpavlin	155
277	dpavlin	382	next unless ($hash);
278	dpavlin	115
279	dpavlin	382	if (! $args->{'template'}) {
280			push @results, $hash;
281			} else {
282			my ($database, $prefix, $id);
283	dpavlin	155
284	dpavlin	382	if ( $hash->{'@uri'} =~ m!/([^/]+)/([^/]+)/(\d+)$!) {
285			($database, $prefix,$id) = ($1,$2,$3);
286			} else {
287			$log->warn("can't decode database/prefix/id from " . $hash->{'@uri'});
288			next;
289			}
290	dpavlin	100
291	dpavlin	382	#$log->debug("load_ds( id => $id, prefix => '$prefix' )");
292	dpavlin	155
293	dpavlin	382	$t = time();
294	dpavlin	155
295	dpavlin	382	my $ds = $self->{db}->load_ds( database => $database, prefix => $prefix, id => $id );
296			if (! $ds) {
297			$log->error("can't load_ds( ${database}/${prefix}/${id} )");
298			next;
299			}
300	dpavlin	100
301	dpavlin	382	$times->{db} += time() - $t;
302	dpavlin	100
303	dpavlin	382	$t = time();
304
305			my $html = $self->apply(
306			template => $template_filename,
307			data => $ds,
308			record_uri => "${database}/${prefix}/${id}",
309			config => $self->{databases}->{$database},
310			);
311
312			$times->{apply} += time() - $t;
313
314			$t = time();
315
316			$html = decode($self->{webpac_encoding}, $html);
317
318			$times->{decode} += time() - $t;
319
320			push @results, $html;
321			}
322
323	dpavlin	95	}
324
325	dpavlin	155	$log->debug( sprintf(
326	dpavlin	382	"duration breakdown: estraier %.6fs, hash %.6fs, store %.6fs, apply %.6fs, decode %.06f, total: %.6fs",
327			$times->{est}, $times->{hash}, $times->{db}, $times->{apply}, $times->{decode}, time() - $search_start_t,
328	dpavlin	155	) );
329
330	dpavlin	382	return \@results;
331	dpavlin	93	}
332
333	dpavlin	165	=head2 record
334
335			my $html = $m->record(
336			mfn => 42,
337			template => 'foo.tt',
338			);
339
340			This will load one record, convert it to html using C<template> and return
341			it.
342
343			=cut
344
345			sub record {
346			my $self = shift;
347
348			my $args = {@_};
349			my $log = $self->{log};
350	dpavlin	400	$log->dumper( $args, 'args' );
351	dpavlin	165
352	dpavlin	242	foreach my $f (qw/record_uri template/) {
353	dpavlin	228	$log->fatal("need $f") unless ($args->{$f});
354	dpavlin	165	}
355
356	dpavlin	242	my ($database, $prefix, $id);
357	dpavlin	165
358	dpavlin	242	if ($args->{record_uri} =~ m#^([^/]+)/([^/]+)/([^/]+)$#) {
359			($database, $prefix, $id) = ($1,$2,$3);
360			} else {
361			$log->error("can't parse $args->{record_uri} into prefix, database and uri");
362			return;
363			}
364	dpavlin	165
365	dpavlin	242	my $ds = $self->{db}->load_ds( id => $id, prefix => $prefix, database => $database );
366			if (! $ds) {
367			$log->error("can't load_ds( $database/$prefix/$id )");
368			return;
369			}
370
371	dpavlin	379	my $html = $self->apply(
372	dpavlin	165	template => $args->{template},
373			data => $ds,
374	dpavlin	242	record_uri => $args->{record_uri},
375	dpavlin	305	config => $self->{databases}->{$database},
376	dpavlin	165	);
377
378	dpavlin	348	$html = decode($self->{webpac_encoding}, $html);
379	dpavlin	165
380			return $html;
381			}
382
383	dpavlin	305
384	dpavlin	403	=head2 list_nodes
385
386			my @nodes = $m->list_nodes( 'site' );
387
388			Return all databases which have records for selected site. Returned array of
389			hashes has elements C<name> and C<label>.
390
391			=cut
392
393			sub list_nodes {
394			my $self = shift;
395
396			my $site = shift;
397
398			$self->{log}->debug("list_nodes use site $site");
399
400			$self->setup_site( $site );
401
402			my @nodes;
403
404			if ($self->{est_node}->doc_num > 0) {
405			push @nodes, {
406			name => $self->{est_node}->name,
407			label => $self->{est_node}->label,
408			}
409			}
410
411			# refresh set info
412			$self->{est_node}->_set_info;
413
414			my $links = $self->{est_node}->links \|\| return @nodes;
415
416			$self->{log}->dumper( $links, 'links' );
417
418			foreach my $link (@{ $links }) {
419			my ($url, $label, $credit) = split(/\t/, $link, 3);
420			if ($url =~ m#/node/(.+)$#) {
421			push @nodes, {
422			name => $1,
423			label => $label,
424			}
425			} else {
426			$self->{log}->warn("can't find node name in link $link");
427			}
428			}
429
430			$self->{log}->dumper( \@nodes, 'nodes' );
431
432			return @nodes;
433			}
434
435			=cut
436
437
438	dpavlin	135	=head2 save_html
439	dpavlin	93
440	dpavlin	135	$m->save_html( '/full/path/to/file', $content );
441	dpavlin	93
442	dpavlin	348	It will use C<Encode> to convert content encoding back to
443	dpavlin	135	Webpac codepage, recode JavaScript Unicode entities (%u1234),
444			strip extra newlines at beginning and end, and save to
445			C</full/path/to/file.new> and if that succeeds, just rename
446			it over original file which should be atomic on filesystem level.
447
448			=cut
449
450			sub save_html {
451			my ($self, $path, $content) = @_;
452
453	dpavlin	348	# FIXME Should this be UTF-8 or someting?
454			my $js_encoding = $self->{webpac_encoding};
455			$js_encoding = 'UTF-16';
456
457	dpavlin	135	sub _conv_js {
458	dpavlin	348	return '0x' . $_[1];
459			return encode($_[0], chr(hex($_[1])));
460	dpavlin	135	}
461	dpavlin	348	#$content =~ s/%u([a-fA-F0-9]{4})/_conv_js($js_encoding,$1)/gex;
462	dpavlin	135	$content =~ s/^[\n\r]+//s;
463			$content =~ s/[\n\r]+$/\n/s;
464	dpavlin	282	$content =~ s/\n\r/\n/gs;
465	dpavlin	135
466	dpavlin	348	my $disk_encoding = $self->{webpac_encoding} \|\| 'utf-8';
467			$self->{log}->debug("convert encoding to $disk_encoding");
468			from_to($content, 'utf-8', $disk_encoding) \|\| $self->{log}->warn("encoding from utf-8 to $disk_encoding failed for: $content");
469	dpavlin	179
470			write_file($path . '.new', {binmode => ':raw' }, $content) \|\| die "can't save ${path}.new $!";
471	dpavlin	135	rename $path . '.new', $path \|\| die "can't rename to $path: $!";
472			}
473
474			=head2 load_html
475
476			my $html = $m->load_html('/full/path/to/file');
477
478			This will convert file from Webpac encoding to Catalyst and
479			convert that data to escaped HTML (for sending into
480			C<< <textarea/> >> tags in html.
481
482			=cut
483
484			sub load_html {
485			my ($self, $path) = @_;
486
487			die "no path?" unless ($path);
488
489	dpavlin	179	my $content = read_file($path, {binmode => ':raw' }) \|\| die "can't read $path: $!";
490	dpavlin	135
491	dpavlin	348	return decode($self->{webpac_encoding}, $content);
492	dpavlin	135	}
493
494	dpavlin	379
495			=head2 apply
496
497			Create output from in-memory data structure using Template Toolkit template.
498
499			my $text = $tt->apply(
500			template => 'text.tt',
501			data => $ds,
502			record_uri => 'database/prefix/mfn',
503			);
504
505			It also has follwing template toolikit filter routies defined:
506
507			=cut
508
509			sub apply {
510			my $self = shift;
511
512			my $args = {@_};
513
514			my $log = $self->{log} \|\| die "no log?";
515
516			foreach my $a (qw/template data/) {
517	dpavlin	382	$log->fatal("need $a") unless ($args->{$a});
518	dpavlin	379	}
519
520			=head3 tt_filter_type
521
522			filter to return values of specified from $ds, usage from TT template is in form
523			C<d('FieldName','delimiter')>, where C<delimiter> is optional, like this:
524
525			[% d('Title') %]
526			[% d('Author',', ' %]
527
528			=cut
529
530			sub tt_filter_type {
531			my ($data,$type) = @_;
532
533			die "no data?" unless ($data);
534			$type \|\|= 'display';
535
536			my $default_delimiter = {
537			'display' => '¶<br/>',
538			'index' => '\n',
539			};
540
541			return sub {
542
543			my ($name,$join) = @_;
544
545			die "no data hash" unless ($data->{'data'} && ref($data->{'data'}) eq 'HASH');
546			# Hm? Should we die here?
547			return unless ($name);
548
549			my $item = $data->{'data'}->{$name} \|\| return;
550
551			my $v = $item->{$type} \|\| return;
552
553			if (ref($v) eq 'ARRAY') {
554			if ($#{$v} == 0) {
555			$v = $v->[0];
556			} else {
557			$join = $default_delimiter->{$type} unless defined($join);
558			$v = join($join, @{$v});
559			}
560			} else {
561			warn("TT filter $type(): field $name values aren't ARRAY, ignoring");
562			}
563
564			return $v;
565			}
566			}
567
568			$args->{'d'} = tt_filter_type($args, 'display');
569			$args->{'display'} = tt_filter_type($args, 'display');
570
571			=head3 tt_filter_search
572
573			filter to return links to search, usage in TT:
574
575			[% search('FieldToDisplay','FieldToSearch','optional delimiter', 'optional_template.tt') %]
576
577			=cut
578
579			sub tt_filter_search {
580
581			my ($data) = @_;
582
583			die "no data?" unless ($data);
584
585			return sub {
586
587			my ($display,$search,$delimiter,$template) = @_;
588
589			# default delimiter
590			$delimiter \|\|= '¶<br/>',
591
592			die "no data hash" unless ($data->{'data'} && ref($data->{'data'}) eq 'HASH');
593			# Hm? Should we die here?
594			return unless ($display);
595
596			my $item = $data->{'data'}->{$display} \|\| return;
597
598			return unless($item->{'display'});
599			if (! $item->{'search'}) {
600			warn "error in TT template: field $display didn't insert anything into search, use d('$display') and not search('$display'...)";
601			return;
602			}
603
604			my @warn;
605			foreach my $type (qw/display search/) {
606			push @warn, "field $display type $type values aren't ARRAY" unless (ref($item->{$type}) eq 'ARRAY');
607			}
608
609			if (@warn) {
610			warn("TT filter search(): " . join(",", @warn) . ", skipping");
611			return;
612			}
613			my @html;
614
615			my $d_el = $#{ $item->{'display'} };
616			my $s_el = $#{ $item->{'search'} };
617
618			# easy, both fields have same number of elements or there is just
619			# one search and multiple display
620			if ( $d_el == $s_el \|\| $s_el == 0 ) {
621
622			foreach my $i ( 0 .. $d_el ) {
623
624			my $s;
625			if ($s_el > 0) {
626	dpavlin	383	$s = $item->{'search'}->[$i] or warn "can't find value $i for type search in field $search";
627	dpavlin	379	} else {
628			$s = $item->{'search'}->[0];
629			}
630			#$s =~ s/([^\w.-])/sprintf("%%%02X",ord($1))/eg;
631			$s = __quotemeta( $s );
632
633	dpavlin	383	my $d = $item->{'display'}->[$i] or warn "can't find value $i for type display in field $display";
634	dpavlin	379
635			my $template_arg = '';
636			$template_arg = qq{,'$template'} if ($template);
637
638			push @html, qq{<a href="#" onclick="return search_via_link('$search','$s'${template_arg})">$d</a>};
639			}
640
641			return join($delimiter, @html);
642			} else {
643			my $html = qq{<div class="notice">WARNING: we should really support if there is $d_el display elements and $s_el search elements, but currently there is no nice way to do so, so we will just display values</div>};
644			my $v = $item->{'display'};
645
646			if ($#{$v} == 0) {
647			$html .= $v->[0];
648			} else {
649			$html .= join($delimiter, @{$v});
650			}
651			return $html;
652			}
653			}
654			}
655
656			$args->{'search'} = tt_filter_search($args);
657
658			=head3 load_rec
659
660			Used mostly for onClick events like this:
661
662			<a href="#" onClick="[% load_rec( record_uri, 'template_name.tt') %]>foo</a>
663
664			It will automatically do sanity checking and create correct JavaScript code.
665
666			=cut
667
668			$args->{'load_rec'} = sub {
669			my @errors;
670
671			my $record_uri = shift or push @errors, "record_uri missing";
672			my $template = shift or push @errors, "template missing";
673
674			if ($record_uri !~ m#^[^/]+/[^/]+/[^/]+$#) {
675			push @errors, "invalid format of record_uri: $record_uri";
676			}
677
678			if (@errors) {
679			return "Logger.error('errors in load_rec: " . join(", ", @errors) . "'); return false;";
680			} else {
681			return "load_rec('$record_uri','$template'); return false;";
682			}
683			};
684
685			=head3 load_template
686
687			Used to re-submit search request and load results in different template
688
689			<a href="#" onClick="[% load_template( 'template_name.tt' ) %]">bar</a>
690
691			=cut
692
693			$args->{'load_template'} = sub {
694			my $template = shift or return "Logger.error('load_template missing template name!'); return false;";
695			return "load_template($template); return false;";
696			};
697
698			my $out;
699
700			$self->{'tt'}->process(
701			$args->{'template'},
702			$args,
703			\$out
704			) \|\| $log->error( "apply can't process template: ", $self->{'tt'}->error() );
705
706			return $out;
707			}
708
709
710			=head2 __quotemeta
711
712			Helper to quote JavaScript-friendly characters
713
714			=cut
715
716			sub __quotemeta {
717			local $_ = shift;
718			$_ = decode('iso-8859-2', $_);
719
720			s<([\x{0080}-\x{fffd}]+)>{sprintf '\u%0*v4X', '\u', $1}ge if ( Encode::is_utf8($_) );
721			{
722			use bytes;
723			s<((?:[^ \x21-\x7E]\|(?:\\(?!u)))+)>{sprintf '\x%0*v2X', '\x', $1}ge;
724			}
725
726			s/\\x09/\\t/g;
727			s/\\x0A/\\n/g;
728			s/\\x0D/\\r/g;
729			s/"/\\"/g;
730			s/\\x5C/\\\\/g;
731
732			return $_;
733			}
734
735
736
737	dpavlin	92	=head1 AUTHOR
738
739	dpavlin	348	Dobrica Pavlinusic C<< <dpavlin@rot13.org> >>
740	dpavlin	92
741			=head1 LICENSE
742
743			This library is free software, you can redistribute it and/or modify
744			it under the same terms as Perl itself.
745
746			=cut
747
748			1;