source: gsdl/trunk/perllib/plugins/LOMPlugin.pm@ 16104

Last change on this file since 16104 was 16019, checked in by kjdon, 16 years ago

changed some more string keys

  • Property svn:keywords set to Author Date Id Revision
File size: 18.7 KB
Line 
1###########################################################################
2#
3# LOMPlugin.pm -- plugin for import the collection from LOM
4#
5# A component of the Greenstone digital library software
6# from the New Zealand Digital Library Project at the
7# University of Waikato, New Zealand.
8#
9# Copyright (C) 2005 New Zealand Digital Library Project
10#
11# This program is free software; you can redistribute it and/or modify
12# it under the terms of the GNU General Public License as published by
13# the Free Software Foundation; either version 2 of the License, or
14# (at your option) any later version.
15#
16# This program is distributed in the hope that it will be useful,
17# but WITHOUT ANY WARRANTY; without even the implied warranty of
18# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19# GNU General Public License for more details.
20#
21# You should have received a copy of the GNU General Public License
22# along with this program; if not, write to the Free Software
23# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
24#
25###########################################################################
26
27### Note this plugin currently can't download source documents from outside if you are behind a firewall.
28
29package LOMPlugin;
30
31use ReadTextFile;
32use MetadataPass;
33use XMLParser;
34use Cwd;
35
36sub BEGIN {
37 @ISA = ('ReadTextFile', 'MetadataPass');
38}
39
40use strict; # every perl program should have this!
41no strict 'refs'; # make an exception so we can use variables as filehandles
42
43
44my $arguments =
45 [ { 'name' => "process_exp",
46 'desc' => "{BasePlugin.process_exp}",
47 'type' => "string",
48 'deft' => &get_default_process_exp(),
49 'reqd' => "no" },
50 { 'name' => "root_tag",
51 'desc' => "{LOMPlugin.root_tag}",
52 'type' => "regexp",
53 'deft' => q/^(?i)lom$/,
54 'reqd' => "no" },
55 { 'name' => "check_timestamp",
56 'desc' => "{LOMPlugin.check_timestamp}",
57 'type' => "flag" },
58 { 'name' => "download_srcdocs",
59 'desc' => "{LOMPlugin.download_srcdocs}",
60 'type' => "regexp",
61 'deft' => "",
62 'reqd' => "no" }];
63
64my $options = { 'name' => "LOMPlugin",
65 'desc' => "{LOMPlugin.desc}",
66 'abstract' => "no",
67 'inherits' => "yes",
68 'args' => $arguments };
69
70
71
72my ($self);
73sub new {
74 my $class = shift (@_);
75 my ($pluginlist,$inputargs,$hashArgOptLists) = @_;
76 push(@$pluginlist, $class);
77
78 push(@{$hashArgOptLists->{"ArgList"}},@{$arguments});
79 push(@{$hashArgOptLists->{"OptList"}},$options);
80
81 $self = new ReadTextFile($pluginlist, $inputargs, $hashArgOptLists);
82
83 if ($self->{'info_only'}) {
84 # don't worry about creating the XML parser as all we want is the
85 # list of plugin options
86 return bless $self, $class;
87 }
88
89 #create XML::Parser object for parsing dublin_core.xml files
90 my $parser = new XML::Parser('Style' => 'Stream',
91 'Handlers' => {'Char' => \&Char,
92 'Doctype' => \&Doctype
93 });
94 $self->{'parser'} = $parser;
95
96 $self->{'extra_blocks'} = {};
97
98 return bless $self, $class;
99}
100
101sub get_default_process_exp {
102 my $self = shift (@_);
103
104 return q^(?i)\.xml$^;
105}
106
107
108
109
110sub metadata_read {
111 my $self = shift (@_);
112 my ($pluginfo, $base_dir, $file, $metadata, $extrametakeys, $extrametadata, $processor, $maxdocs, $gli) = @_;
113
114 my $outhandle = $self->{'outhandle'};
115
116 my $filename = $file;
117 $filename = &util::filename_cat ($base_dir, $file) if $base_dir =~ /\w/;
118
119 if ($filename !~ /$self->{'process_exp'}/ || !-f $filename) {
120 return undef; # can't recognise
121 }
122 if (!$self->check_doctype($filename)) {
123 # this file is not for us
124 return undef;
125 }
126
127 $file =~ s/^[\/\\]+//; # $file often begins with / so we'll tidy it up
128
129 print $outhandle "LOMPlugin: extracting metadata from $file\n"
130 if $self->{'verbosity'} > 1;
131
132 my ($dir,$tail) = $filename =~ /^(.*?)([^\/\\]*)$/;
133 $self->{'output_dir'} = $dir;
134
135 eval {
136 $self->{'parser'}->parsefile($filename);
137 };
138
139 if ($@) {
140 print $outhandle "LOMPlugin: skipping $filename as not conformant to LOM syntax\n" if ($self->{'verbosity'} > 1);
141 print $outhandle "\n Perl Error:\n $@\n" if ($self->{'verbosity'}>2);
142 return 0;
143 }
144
145 $self->{'output_dir'} = undef;
146
147 my $file_re;
148 my $lom_srcdoc = $self->{'lom_srcdoc'};
149
150 if (defined $lom_srcdoc) {
151 my $dirsep = &util::get_re_dirsep();
152 $lom_srcdoc =~ s/^$base_dir($dirsep)//;
153 $self->{'extra_blocks'}->{$file}++;
154
155 $file_re = $lom_srcdoc;
156 }
157 else {
158 $file_re = $tail;
159 }
160 $file_re =~ s/\./\\\./g;
161
162 $self->{'lom_srcdoc'} = undef; # reset for next file to be processed
163
164 push(@$extrametakeys,$file_re);
165 $extrametadata->{$file_re} = $self->{'saved_metadata'};
166
167 return 1;
168}
169
170sub check_doctype {
171 $self = shift (@_);
172
173 my ($filename) = @_;
174
175 if (open(XMLIN,"<$filename")) {
176 my $doctype = $self->{'root_tag'};
177 ## check whether the doctype has the same name as the root element tag
178 while (defined (my $line = <XMLIN>)) {
179 ## find the root element
180 if ($line =~ /<([\w\d:]+)[\s>]/){
181 my $root = $1;
182 if ($root !~ $doctype){
183 close(XMLIN);
184 return 0;
185 }
186 else {
187 close(XMLIN);
188 return 1;
189 }
190 }
191 }
192 close(XMLIN);
193 }
194
195 return undef; # haven't found a valid line
196
197}
198
199sub read_file {
200 my $self = shift (@_);
201 my ($filename, $encoding, $language, $textref) = @_;
202
203 my $metadata_table = $self->{'metadata_table'};
204
205 my $rawtext = $metadata_table->{'rawtext'};
206
207 delete $metadata_table->{'rawtext'};
208
209 $$textref = $rawtext;
210}
211
212sub read {
213 my $self = shift (@_);
214 my ($pluginfo, $base_dir, $file, $metadata, $processor, $maxdocs, $total_count, $gli) = @_;
215
216 my $outhandle = $self->{'outhandle'};
217
218 return 0 if (defined $self->{'extra_blocks'}->{$file});
219
220 # need to check whether this file is for us
221 my ($block_status,$filename) = $self->read_block(@_);
222 return $block_status if ((!defined $block_status) || ($block_status==0));
223 if (!$self->check_doctype($filename)) {
224 # this file is not for us
225 return undef;
226 }
227
228 $self->{'metadata_table'} = $metadata;
229
230 my $lom_language = $metadata->{'lom_language'};
231
232 my $store_input_encoding;
233 my $store_extract_language;
234 my $store_default_language;
235 my $store_default_encoding;
236
237 if (defined $lom_language) {
238 delete $metadata->{'lom_language'};
239
240 $store_input_encoding = $self->{'input_encoding'};
241 $store_extract_language = $self->{'extract_language'};
242 $store_default_language = $self->{'default_language'};
243 $store_default_encoding = $self->{'default_encoding'};
244
245 $self->{'input_encoding'} = "utf8";
246 $self->{'extract_language'} = 0;
247 $self->{'default_language'} = $lom_language;
248 $self->{'default_encoding'} = "utf8";
249 }
250
251 my $rv = $self->SUPER::read(@_);
252
253 if (defined $lom_language) {
254 $self->{'input_encoding'} = $store_input_encoding;
255 $self->{'extract_language'} = $store_extract_language;
256 $self->{'default_language'} = $store_default_language;
257 $self->{'default_encoding'} = $store_default_encoding;
258 }
259
260 $self->{'metadata_table'} = undef;
261
262 return $rv;
263}
264
265# do plugin specific processing of doc_obj
266sub process {
267 my $self = shift (@_);
268 my ($textref, $pluginfo, $base_dir, $file, $metadata, $doc_obj, $gli) = @_;
269 my $outhandle = $self->{'outhandle'};
270
271 print STDERR "<Processing n='$file' p='LOMPlugin'>\n" if ($gli);
272
273 print $outhandle "LOMPLug: processing $file\n";
274
275 my $cursection = $doc_obj->get_top_section();
276 $doc_obj->add_utf8_text($cursection, $$textref);
277
278 return 1;
279}
280
281sub Doctype {
282 my ($expat, $name, $sysid, $pubid, $internal) = @_;
283
284 my $root_tag = $self->{'root_tag'};
285
286 if ($name !~ /$root_tag/) {
287 die "Root tag $name does not match regular expression $root_tag";
288 }
289}
290
291sub StartTag {
292 my ($expat, $element) = @_;
293
294 my %attr = %_;
295
296 my $raw_tag = "&lt;$element";
297 map { $raw_tag .= " $_=\"$attr{$_}\""; } keys %attr;
298 $raw_tag .= "&gt;";
299
300 if ($element =~ m/$self->{'root_tag'}/) {
301 $self->{'raw_text'} = $raw_tag;
302
303 $self->{'saved_metadata'} = {};
304 $self->{'metaname_stack'} = [];
305 $self->{'lom_datatype'} = "";
306 $self->{'lom_language'} = undef;
307 $self->{'metadatatext'} = "<table class=\"metadata\" width=\"_pagewidth_\" >\n";
308 }
309 else {
310 my $xml_depth = scalar(@{$self->{'metaname_stack'}});
311 $self->{'raw_text'} .= "\n";
312 $self->{'raw_text'} .= "&nbsp;&nbsp;" x $xml_depth;
313 $self->{'raw_text'} .= $raw_tag;
314
315 my $metaname_stack = $self->{'metaname_stack'};
316 push(@$metaname_stack,$element);
317 if (scalar(@$metaname_stack)==1) {
318 # top level LOM category
319 my $style = "class=\"metadata\"";
320 my $open_close
321 = "<a id=\"${element}opencloselink\" href=\"javascript:hideTBodyArea('$element')\">\n";
322 $open_close
323 .= "<img id=\"${element}openclose\" border=\"0\" src=\"_httpopenmdicon_\"></a>\n";
324
325 my $header_line = " <tr $style ><th $style colspan=\"3\">$open_close \u$element</th></tr>\n";
326 my $md_tbody = "<tbody id=\"$element\">\n";
327
328 $self->{'mdheader'} = $header_line;
329 $self->{'mdtbody'} = $md_tbody;
330 $self->{'mdtbody_text'} = "";
331 }
332 }
333}
334
335sub EndTag {
336 my ($expat, $element) = @_;
337
338 my $raw_tag = "&lt;/$element&gt;";
339
340 if ($element =~ m/$self->{'root_tag'}/) {
341 $self->{'raw_text'} .= $raw_tag;
342
343 my $metadatatext = $self->{'metadatatext'};
344 $metadatatext .= "</table>";
345
346 my $raw_text = $self->{'raw_text'};
347
348 $self->{'saved_metadata'}->{'MetadataTable'} = $metadatatext;
349 $self->{'metadatatext'} = "";
350
351 $self->{'saved_metadata'}->{'rawtext'} = $raw_text;
352 $self->{'raw_text'} = "";
353
354 if (defined $self->{'lom_language'}) {
355 $self->{'saved_metadata'}->{'lom_language'} = $self->{'lom_language'};
356 $self->{'lom_language'} = undef;
357 }
358 }
359 else {
360 my $metaname_stack = $self->{'metaname_stack'};
361
362 if (scalar(@$metaname_stack)==1) {
363 my $header_line = $self->{'mdheader'};
364 my $tbody_start = $self->{'mdtbody'};
365 my $tbody_text = $self->{'mdtbody_text'};
366 if ($tbody_text !~ m/^\s*$/s) {
367 my $tbody_end = "</tbody>\n";
368 my $table_chunk
369 = $header_line.$tbody_start.$tbody_text.$tbody_end;
370
371 $self->{'metadatatext'} .= $table_chunk;
372 }
373 $self->{'mdtheader'} = "";
374 $self->{'mdtbody'} = "";
375 $self->{'mdtbody_text'} = "";
376 }
377
378 pop(@$metaname_stack);
379
380 my $xml_depth = scalar(@{$self->{'metaname_stack'}});
381 $self->{'raw_text'} .= "\n";
382 $self->{'raw_text'} .= "&nbsp;&nbsp;" x $xml_depth;
383 $self->{'raw_text'} .= $raw_tag;
384 }
385}
386
387sub process_datatype_info
388{
389 my $self = shift(@_);
390 my ($metaname_stack,$md_content) = @_;
391
392 my @without_dt_stack = @$metaname_stack; # without datatype stack
393
394 my $innermost_element = $without_dt_stack[$#without_dt_stack];
395
396 # Loose last item if encoding datatype information
397 if ($innermost_element =~ m/^(lang)?string$/) {
398 $self->{'lom_datatype'} = $innermost_element;
399
400 pop @without_dt_stack;
401 $innermost_element = $without_dt_stack[$#without_dt_stack];
402 }
403 elsif ($innermost_element =~ m/^date(Time)?$/i) {
404 if ($innermost_element =~ m/^date$/i) {
405 $self->{'lom_datatype'} = "dateTime";
406 }
407 else {
408 $self->{'lom_datatype'} = $innermost_element;
409
410 pop @without_dt_stack;
411 $innermost_element = $without_dt_stack[$#without_dt_stack];
412 }
413
414 if ($md_content =~ m/^(\d{1,2})\s*(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)\w*\s*(\d{4})/i) {
415 my ($day,$mon,$year) = ($1,$2,$3);
416
417 my %month_lookup = ( 'jan' => 1, 'feb' => 2, 'mar' => 3,
418 'apr' => 4, 'may' => 5, 'jun' => 6,
419 'jul' => 7, 'aug' => 8, 'sep' => 9,
420 'oct' => 10, 'nov' => 11, 'dec' => 12 );
421
422 my $mon_num = $month_lookup{lc($mon)};
423
424 $md_content = sprintf("%d%02d%02d",$year,$mon_num,$day);
425 }
426
427 $md_content =~ s/\-//g;
428 }
429
430 if ($innermost_element eq "source") {
431 $self->{'lom_source'} = $md_content;
432 }
433 elsif ($innermost_element eq "value") {
434 $self->{'lom_value'} = $md_content;
435 }
436
437 return (\@without_dt_stack,$innermost_element,$md_content);
438}
439
440sub reset_datatype_info
441{
442 my $self = shift(@_);
443
444 $self->{'lom_datatype'} = "";
445}
446
447
448sub pretty_print_text
449{
450 my $self = shift(@_);
451
452 my ($pretty_print_text) = @_;
453
454## $metavalue_utf8 = &util::hyperlink_text($metavalue_utf8);
455 $pretty_print_text = &util::hyperlink_text($pretty_print_text);
456
457#### $pretty_print_text =~ s/(BEGIN:vCard.*END:vCard)/<pre>$1<\/pre>/sg;
458
459 if ($self->{'lom_datatype'} eq "dateTime") {
460 if ($pretty_print_text =~ m/^(\d{4})(\d{2})(\d{2})$/) {
461 $pretty_print_text = "$1-$2-$3";
462 }
463 }
464
465 return $pretty_print_text;
466}
467
468sub pretty_print_table_tr
469{
470 my $self = shift (@_);
471 my ($without_dt_stack) = @_;
472
473 my $style = "class=\"metadata\"";
474
475 my $innermost_element = $without_dt_stack->[scalar(@$without_dt_stack)-1];
476 my $outermost_element = $without_dt_stack->[0];
477
478 # Loose top level stack item (already named in pretty print table)
479 my @pretty_print_stack = @$without_dt_stack;
480 shift @pretty_print_stack;
481
482 if ($innermost_element eq "source") {
483 return if (!defined $self->{'lom_value'});
484 }
485
486 if ($innermost_element eq "value") {
487 return if (!defined $self->{'lom_source'});
488 }
489
490 my $pretty_print_text = "";
491
492 if (($innermost_element eq "value") || ($innermost_element eq "source")) {
493 my $source = $self->{'lom_source'};
494 my $value = $self->pretty_print_text($self->{'lom_value'});
495
496 $self->{'lom_source'} = undef;
497 $self->{'lom_value'} = undef;
498
499 pop @pretty_print_stack;
500
501 $pretty_print_text = "<td $style>$source</td><td $style>$value</td>";
502 }
503 else {
504 $pretty_print_text = $self->pretty_print_text($_);
505 $pretty_print_text = "<td $style colspan=2>$pretty_print_text</td>";
506 }
507 my $pretty_print_fmn = join(' : ',map { "\u$_"; } @pretty_print_stack);
508
509
510 # my $tr_attr = "id=\"$outermost_element\" style=\"display:block;\"";
511 my $tr_attr = "$style id=\"$outermost_element\"";
512
513 my $mdtext_line = " <tr $tr_attr><td $style><nobr>$pretty_print_fmn</nobr></td>$pretty_print_text</tr>\n";
514 $self->{'mdtbody_text'} .= $mdtext_line;
515}
516
517
518sub check_for_language
519{
520 my $self = shift(@_);
521 my ($innermost_element,$md_content) = @_;
522
523 # Look for 'language' tag
524 if ($innermost_element eq "language") {
525 my $lom_lang = $self->{'lom_language'};
526
527 if (defined $lom_lang) {
528 my $new_lom_lang = $md_content;
529 $new_lom_lang =~ s/-.*//; # remove endings like -US or -GB
530
531 if ($lom_lang ne $new_lom_lang) {
532 my $outhandle = $self->{'outhandle'};
533
534 print $outhandle "Warning: Conflicting general language in record\n";
535 print $outhandle " $new_lom_lang (previous value for language = $lom_lang)\n";
536 }
537 # otherwise, existing value OK => do nothing
538 }
539 else {
540 $lom_lang = $md_content;
541 $lom_lang =~ s/-.*//; # remove endings like -US or -GB
542
543 $self->{'lom_language'} = $lom_lang;
544 }
545 }
546}
547
548sub found_specific_identifier
549{
550 my $self = shift(@_);
551 my ($specific_id,$full_mname,$md_content) = @_;
552
553 my $found_id = 0;
554 if ($full_mname eq $specific_id) {
555 if ($md_content =~ m/^(http|ftp):/) {
556 $found_id = 1;
557 }
558 }
559
560 return $found_id;
561}
562
563sub download_srcdoc
564{
565 my $self = shift(@_);
566 my ($doc_url) = @_;
567
568 my $outhandle = $self->{'outhandle'};
569 my $output_dir = $self->{'output_dir'};
570
571 $output_dir = &util::filename_cat($output_dir,"_gsdldown.all");
572
573 if (! -d $output_dir) {
574 mkdir $output_dir;
575 }
576
577 my $re_dirsep = &util::get_re_dirsep();
578 my $os_dirsep = &util::get_dirsep();
579
580 my $file_url = $doc_url;
581 $file_url =~ s/$re_dirsep/$os_dirsep/g;
582 $file_url =~ s/^(http|ftp):\/\///;
583 $file_url .= "index.html" if ($file_url =~ m/\/$/);
584
585 my $full_file_url = &util::filename_cat($output_dir,$file_url);
586
587 my $check_timestamp = $self->{'check_timestamp'};
588 my $status;
589
590 if (($check_timestamp) || (!$check_timestamp && !-e $full_file_url)) {
591 if (!-e $full_file_url) {
592 print $outhandle "Mirroring $doc_url\n";
593 }
594 else {
595 print $outhandle "Checking to see if update needed for $doc_url\n";
596 }
597
598 # on linux, if we pass an absolute path as -P arg to wget, then it
599 # stuffs up the
600 # URL rewriting in the file. Need a relative path or none, so now
601 # we change working directory first.
602 my $changed_dir = 0;
603 my $current_dir = cwd();
604 my $wget_cmd = "";
605 if ($ENV{'GSDLOS'} ne "windows") {
606 $changed_dir = 1;
607
608 chdir "$output_dir";
609 $wget_cmd = "wget -nv --timestamping -k -p \"$doc_url\"";
610 } else {
611 $wget_cmd = "wget -nv -P \"$output_dir\" --timestamping -k -p \"$doc_url\"";
612 }
613 #my $wget_cmd = "wget -nv -P$output_dir --timestamping -k -p \"$doc_url\"";
614 ### my $full_dir_url = &File::Basename::dirname($full_file_url);
615
616 ## my $wget_cmd = "wget -O $full_file_url --timestamping -k \"$doc_url\"";
617 #my $wget_cmd = "wget -nv -P$output_dir --timestamping -x -k \"$doc_url\"";
618 print STDERR "**** wget = $wget_cmd\n";
619
620
621 $status = system($wget_cmd);
622 if ($changed_dir) {
623 chdir $current_dir;
624 }
625 if ($status==0) {
626 $self->{'lom_srcdoc'} = $full_file_url;
627 }
628 else {
629 $self->{'lom_srcdoc'} = undef;
630 print $outhandle "Error: failed to execute $wget_cmd\n";
631 }
632 }
633 else {
634 # not time-stamping and file already exists
635 $status=0;
636 $self->{'lom_srcdoc'} = $full_file_url;
637 }
638
639 return $status==0;
640
641}
642
643
644sub check_for_identifier
645{
646 my $self = shift(@_);
647 my ($full_mname,$md_content) = @_;
648
649 my $success = 0;
650
651 my $download_re = $self->{'download_srcdocs'};
652 if (($download_re ne "") && $md_content =~ m/$download_re/) {
653
654 if ($self->found_specific_identifier("general^identifier^entry",$full_mname,$md_content)) {
655 $success = $self->download_srcdoc($md_content);
656 }
657
658 if (!$success) {
659 if ($self->found_specific_identifier("technical^location",$full_mname,$md_content)) {
660 $success = $self->download_srcdoc($md_content);
661 }
662 }
663 }
664
665 return $success;
666}
667
668
669sub Text {
670 if ($_ !~ m/^\s*$/) {
671 #
672 # Work out indentations and line wraps for raw XML
673 #
674 my $xml_depth = scalar(@{$self->{'metaname_stack'}})+1;
675 my $indent = "&nbsp;&nbsp;" x $xml_depth;
676
677 my $formatted_text = "\n".$_;
678
679 # break into lines < 80 chars on space
680 $formatted_text =~ s/(.{50,80})\s+/$1\n/mg;
681 $formatted_text =~ s/^/$indent/mg;
682 ## $formatted_text =~ s/\s+$//s;
683
684 $self->{'raw_text'} .= $formatted_text;
685 }
686
687 my $metaname_stack = $self->{'metaname_stack'};
688 if (($_ !~ /^\s*$/) && (scalar(@$metaname_stack)>0)) {
689
690 my ($without_dt_stack,$innermost_element,$md_content)
691 = $self->process_datatype_info($metaname_stack,$_);
692
693 $self->pretty_print_table_tr($without_dt_stack);
694
695 my $full_mname = join('^',@{$without_dt_stack});
696 $self->set_filere_metadata(lc($full_mname),$md_content);
697
698 $self->check_for_language($innermost_element,$md_content);
699 $self->check_for_identifier($full_mname,$md_content); # source doc
700
701 $self->reset_datatype_info();
702 }
703}
704
705# This Char function overrides the one in XML::Parser::Stream to overcome a
706# problem where $expat->{Text} is treated as the return value, slowing
707# things down significantly in some cases.
708sub Char {
709 $_[0]->{'Text'} .= $_[1];
710 return undef;
711}
712
7131;
Note: See TracBrowser for help on using the repository browser.