X-Git-Url: http://git.indexdata.com/?p=irspy-moved-to-github.git;a=blobdiff_plain;f=lib%2FZOOM%2FIRSpy%2FUtils.pm;h=eeffccced7a12a29bb0fc2e363d1f393c525bf8e;hp=9c5f9517dfc294358ffe13e324f653d65d8da949;hb=70f35e9d28e4b25f763baee0602e2eac25264ebf;hpb=bbfd131d8f1de160bd3b1f4731eed59222f13d65 diff --git a/lib/ZOOM/IRSpy/Utils.pm b/lib/ZOOM/IRSpy/Utils.pm index 9c5f951..eeffccc 100644 --- a/lib/ZOOM/IRSpy/Utils.pm +++ b/lib/ZOOM/IRSpy/Utils.pm @@ -1,4 +1,3 @@ -# $Id: Utils.pm,v 1.38 2009-04-15 18:16:45 wosch Exp $ package ZOOM::IRSpy::Utils; @@ -6,8 +5,12 @@ use 5.008; use strict; use warnings; +use Scalar::Util; + use Exporter 'import'; our @EXPORT_OK = qw(utf8param + trimField + utf8paramTrim isodate xml_encode cql_quote @@ -19,7 +22,9 @@ our @EXPORT_OK = qw(utf8param modify_xml_document bib1_access_point render_record - calc_reliability); + validate_record + calc_reliability_string + calc_reliability_stats); use XML::LibXML; use XML::LibXML::XPathContext; @@ -80,7 +85,6 @@ sub utf8param { return $cooked; } - # Utility functions follow, exported for use of web UI sub utf8param_apache1 { my($r, $key, $value) = @_; @@ -102,6 +106,26 @@ sub isodate { $year+1900, $mon+1, $mday, $hour, $min, $sec); } +# strips whitespaces at start and ends of a field +sub trimField { + my $field = shift; + + $field =~ s/^\s+//; + $field =~ s/\s+$//; + + return $field; +} + +# utf8param() with trim +sub utf8paramTrim { + my $result = utf8param(@_); + + if (defined $result) { + $result = trimField($result); + } + + return $result; +} # I can't -- just can't, can't, can't -- believe that this function # isn't provided by one of the core XML modules. But the evidence all @@ -261,7 +285,7 @@ sub _irspy_identifier2target { if !defined $id; my($protocol, $target) = ($id =~ /(.*?):(.*)/); - if (uc($protocol) eq "Z39.50") { + if (uc($protocol) eq "Z39.50" || uc($protocol) eq "TCP") { return "tcp:$target"; } elsif (uc($protocol) eq "SRU") { return "sru=get,http:$target"; @@ -274,6 +298,11 @@ sub _irspy_identifier2target { } +# Modifies the XML document for which $xc is an XPath context by +# inserting or replacing the values specified in the hash %$data. The +# keys are fieldnames, which are looked up in the register +# $fieldsByKey to determine, among other things, what their XPath is. + sub modify_xml_document { my($xc, $fieldsByKey, $data) = @_; @@ -324,7 +353,7 @@ sub modify_xml_document { } } else { - next if !$value; # No need to create a new empty node + next if !defined $value; # No need to create a new empty node my($ppath, $selector) = $xpath =~ /(.*)\/(.*)/; dom_add_node($xc, $ppath, $selector, $value, @addAfter); #print "New $key ($xpath) = '$value'
\n"; @@ -771,16 +800,67 @@ sub render_record { } -sub calc_reliability { +sub calc_reliability_string { + my($xc) = @_; + + my($nok, $nall, $percent) = calc_reliability_stats($xc); + return "[untested]" if $nall == 0; + return "$nok/$nall = " . $percent . "%"; +} + + +sub calc_reliability_stats { my($xc) = @_; my @allpings = $xc->findnodes("i:status/i:probe"); my $nall = @allpings; - return "[untested]" if $nall == 0; + return (0, 0, 0) if $nall == 0; my @okpings = $xc->findnodes('i:status/i:probe[@ok = "1"]'); my $nok = @okpings; - return "$nok/$nall = " . int(100*$nok/$nall) . "%"; + my $percent = int(100*$nok/$nall + 0.5); + return ($nok, $nall, $percent); } +# +# validate_record( record, ( "port" => 1, "database" => 1, "country" => 0, ... )) +# +sub validate_record { + my $rec = shift; + my %args = @_; + + my %required = map { $_ => 1 } qw/port host database/; + my %optional = map { $_ => 1 } qw/country type hosturl contact language/; + my %tests = ( %required, %args ); + + my $xc = irspy_xpath_context($rec); + + my $protocol = $xc->findnodes("e:serverInfo/\@protocol") || ""; + my $port = $xc->findnodes("e:serverInfo/e:port") || ""; + my $host = $xc->findnodes("e:serverInfo/e:host") || ""; + my $dbname = $xc->findnodes("e:serverInfo/e:database") || ""; + + my $id = irspy_make_identifier($protocol, $host, $port, $dbname); + + my @errors = $id; + + if ($tests{'port'}) { + push(@errors, 'This port number is not valid') if $port !~ /^\d+$/; + } + + if ($tests{'host'}) { + push(@errors, 'This host name is not valid') if $host !~ /^[0-9a-z]+[0-9a-z\.\-]*\.[0-9a-z]+$/i; + } + + if ($tests{'database'}) { + push(@errors, 'This database name is not valid') if $dbname !~ /^[\w_\-\.]+$/i; + } + + if ($tests{'hosturl'}) { + my $hosturl = $xc->findnodes("i:status/i:hostURL") || ""; + push(@errors, 'This hosturl name is not valid') if $hosturl !~ /^\w+$/i; + } + + return ( !$#errors, \@errors ); +} 1;