# various variables
my ($HELM_LIB_PATH);
my $cgi_dir = "@HELM_CGI_DIR@";
-my (%map);
+my (%map, %rdf_map);
# First of all, let's load HELM configuration
use Env;
$HELM_LIB_PATH = $DEFAULT_HELM_LIB_DIR."/configuration.pl";
}
-# <ZACK>: TODO temporary, move this setting to configuration file
-# set the cache mode, may be "gzipped" or "normal"
-my $cachemode = $ENV{'HTTP_GETTER_CACHE_MODE'} || 'gzipped';
+# next require defines: $helm_dir, $html_link, $dtd_dir, $uris_dbm, $indexname
+require $HELM_LIB_PATH;
+
+# TEMP: TODO put these vars in configuration file configuration.xml
+# <move_to_conf_file>
+my $cachemode = $ENV{'HTTP_GETTER_CACHE_MODE'} ||
+ 'gzipped';
if (($cachemode ne 'gzipped') and ($cachemode ne 'normal')) {
die "Invalid HTTP_GETTER_CACHE_MODE environment variable, must be".
"'normal' or 'gzipped'\n";
}
-# </ZACK>
-
-# next require defines: $helm_dir, $html_link, $dtd_dir, $uris_dbm
-require $HELM_LIB_PATH;
+my $helm_rdf_dir = $ENV{'HTTP_GETTER_RDF_DIR'} ||
+ "/usr/local/helm/rdf_library";
+my $rdf_dbm = $ENV{'HTTP_GETTER_RDF_DBM'} ||
+ "/usr/local/helm/rdf_urls_of_uris";
+my $rdf_indexname = $ENV{'HTTP_GETTER_RDF_INDEXNAME'} ||
+ "rdf_index.txt";
+# </move_to_conf_file>
# Let's override the configuration file
$style_dir = $ENV{"HELM_STYLE_DIR"} if (defined ($ENV{"HELM_STYLE_DIR"}));
($myownurl) = gethostbyname($myownurl);
$myownurl = "http://".$myownurl.":".$myownport;
-tie(%map, 'DB_File', $uris_dbm.".db", O_RDONLY, 0664);
+tie(%map, 'DB_File', $uris_dbm.".db", O_RDWR, 0664); # open dbs
+tie(%rdf_map, 'DB_File', $rdf_dbm.".db", O_RDWR, 0664);
+
+print "\n";
+print "HTTP Getter $VERSION\n"; # print hello information
print "Please contact me at: <URL:", $myownurl."/", ">\n";
+print "\n";
print "helm_dir: $helm_dir\n";
+print "helm_rdf_dir: $helm_rdf_dir\n";
print "style_dir: $style_dir\n";
print "dtd_dir: $dtd_dir\n";
-print "urls_of_uris.db: $uris_dbm.db\n";
+print "urls_of_uris db: $uris_dbm.db\n";
+print "rdf db: $rdf_dbm.db\n";
print "cache mode: $cachemode\n";
+print "indexname: $indexname\n";
+print "rdf_indexname: $rdf_indexname\n";
+print "\n";
$SIG{CHLD} = "IGNORE"; # do not accumulate defunct processes
$SIG{USR1} = \&update; # sent by the child to make the parent update
+
while (my $c = $d->accept) {
if (fork() == 0) {
while (my $r = $c->get_request) {
my $inputuri = $cgi->param('uri');
print "\nRequest: ".$r->url."\n\n";
- print "\nUnescaped query: ".$http_query."\n";
+ print "\nUnescaped query: ".$http_query."\n";
+ # "getxml" works with rdf uris
if ($http_method eq 'GET' and $http_path eq "/getxml") {
# finds the uri, url and filename
- my $cicuri = $inputuri;
+
my $answerformat = $cgi->param('format');
my $patch_dtd = $cgi->param('patch_dtd');
$answerformat = "" if (not defined($answerformat));
- $patch_dtd = "" if (not defined($patch_dtd));
+ $patch_dtd = "yes" if (not defined($patch_dtd));
if (($answerformat ne "gz") and ($answerformat ne "normal")
and ($answerformat ne "")) {
die "Wrong output format: $answerformat, must be 'normal' ".
die "Wrong param, patch_dtd must be 'yes' or 'no'\n";
}
- my $cicfilename = $cicuri;
- $cicfilename =~ s/cic:(.*)/$1/;
- $cicfilename =~ s/theory:(.*)/$1/;
-
- my $cicurl = $map{$cicuri};
- if (not defined($cicurl)) {
- die "uri \"$cicuri\" can't be resolved\n";
- }
- my $extension;
- if ($cicurl =~ /\.xml$/) { # non gzipped file
- $extension = ".xml";
- } elsif ($cicurl =~ /\.xml\.gz$/) { # gzipped file
- $extension = ".xml.gz";
- } else { # error: unknown extension
- die "unexpected extension in url: $cicurl, might be '.xml'".
- "or '.xml.gz'";
+ my $filename = $inputuri;
+ my $prefix;
+ if (not isRdfUri($inputuri)) { # standad cic: or theory: uri
+ $filename =~ s/^cic:(.*)/$1/;
+ $filename =~ s/^theory:(.*)/$1/;
+ } else { # rdf uri
+ # The "helm:rdf/<<...>>//cic:" prefix is kept, but quoted
+ # (so that a "helm:rdf/<<...>>//cic:" dir is created
+ $prefix = $filename;
+ $filename =~ s/^(.*)\/\/cic:(.*)/$2/;
+ $filename =~ s/^(.*)\/\/theory:(.*)/$2/;
+ $prefix =~ s/\Q$filename\E//;
+ $prefix =~ s/_/__/g;
+ $prefix =~ s/\//_/g;
+ $filename = $prefix.$filename;
}
- $cicfilename = $helm_dir.$cicfilename.$extension;
- if (!defined($cicurl)) {
- print "\nNOT FOUND!!!!!\n";
+ my $url = resolve ($inputuri); # resolve uri in url
+ if (not defined($url)) { # uri not found in uri2url map
+ die "NOT FOUND: uri \"$inputuri\" can't be resolved\n";
$c->send_error(RC_NOT_FOUND)
- } else {
- print_request("cic",$cicuri,$cicurl,$cicfilename);
-
- # Retrieves the file
- my $ciccontent = download($patch_dtd,"cic",$cicurl,$cicfilename,$answerformat);
-
- # Answering the client
- if ($answerformat eq "normal") {
- answer($c,$ciccontent,"text/xml","");
- } else {
- answer($c,$ciccontent,"text/xml","x-gzip");
- }
+ } else { # uri found and mapped to url
+ my $extension; # file extension
+ if ($url =~ /\.xml$/) { # non gzipped file
+ $extension = ".xml";
+ } elsif ($url =~ /\.xml\.gz$/) { # gzipped file
+ $extension = ".xml.gz";
+ } else { # error: unknown extension
+ die "unexpected extension in url: $url, might be '.xml'".
+ "or '.xml.gz'";
+ }
+
+ if (not isRdfUri ($inputuri)) { # save in uri std cache dir
+ $filename = $helm_dir.$filename.$extension;
+ } else { # save in rdf metadata cache dir
+ $filename = $helm_rdf_dir."/".$filename.$extension;
+ }
+
+ print_request($inputuri,$url,$filename);
+
+ # Retrieves the file
+ my $ciccontent = download($patch_dtd,$url,$filename,$answerformat);
+
+ if ($answerformat eq "normal") { # answer the client in text/xml
+ answer($c,$ciccontent,"text/xml","");
+ } else { # answer the client in text/xml, gzip encoding
+ answer($c,$ciccontent,"text/xml","x-gzip");
+ }
}
+
+ # "/register" does not work with rdf uris
+ } elsif ($http_method eq 'GET' and $http_path eq "/register") {
+ my $inputurl = $cgi->param('url');
+ print "Register requested...\n";
+ $map{$inputuri}=$inputurl;
+
+ # Now let's clean the cache
+ my $cicfilename = $inputuri;
+ $cicfilename =~ s/cic:(.*)/$1/;
+ $cicfilename =~ s/theory:(.*)/$1/;
+
+ print "Unlinking ".$helm_dir.$cicfilename.".xml[.gz]\n";
+ unlink ($helm_dir.$cicfilename.".xml");
+ unlink ($helm_dir.$cicfilename.".xml.gz");
+
+ kill(USR1,getppid()); # signal changes to parent
+ untie %map;
+ print "done.\n";
+ html_nice_answer($c,"Register done");
+
+ # "/resolve" works with rdf uri
} elsif ($http_method eq 'GET' and $http_path eq "/resolve") {
- my $outputurl = $map{$inputuri};
+ #my $outputurl = $map{$inputuri};
+ my $outputurl = resolve($inputuri);
$outputurl = "" if (not defined($outputurl));
$cont = "<?xml version=\"1.0\" ?>\n\n";
if ($outputurl eq "") {
$cont .= "<url value=\"$outputurl\" />\n";
}
answer($c,$cont,"text/xml","");
+
} elsif ($http_method eq 'GET' and $http_path eq "/getdtd") {
my $filename = $inputuri;
$filename = $dtd_dir."/".$filename;
} else {
die "Could not find DTD!";
}
+
} elsif ($http_method eq 'GET' and $http_path eq "/getstyleconf") {
my $filename = $inputuri;
$filename = $style_dir."/config/".$filename;
} else {
die "Could not find Style Configuration File!";
}
+
} elsif ($http_method eq 'GET' and $http_path eq "/getxslt") {
my $filename = $inputuri;
$filename = $style_dir."/".$filename;
} else {
die "Could not find XSLT!";
}
+
+ # "/update" works with rdf uri
} elsif ($http_method eq 'GET' and $http_path eq "/update") {
- # rebuild urls_of_uris.db
+ # rebuild urls_of_uris db and rdf uris db
print "Update requested...\n";
- mk_urls_of_uris();
+ update_dbs();
kill(USR1,getppid()); # signal changes to parent
print " done\n";
html_nice_answer($c,"Update done");
+
+ # "/ls" does not work with rdf uris
} elsif ($http_method eq 'GET' and $http_path eq "/ls") {
# send back keys that begin with a given uri
my ($uritype,$uripattern,$uriprefix);
my $baseuri = $cgi->param('baseuri');
chop $baseuri if ($baseuri =~ /.*\/$/); # remove trailing "/"
- my $outype = $cgi->param('format'); # output type, might be 'txt' or 'xml'
+ # output type, might be 'txt' or 'xml':
+ my $outype = $cgi->param('format');
$uripattern = $baseuri;
$uripattern =~ s/^.*:(.*)/$1/;
if ($baseuri =~ /^cic:/) {
html_nice_answer($c,"Invalid uri , must begin with ".
"'cic:' or 'theory:'");
}
+
} elsif ($http_method eq 'GET' and $http_path eq "/help") {
+ # help request
print "Help requested!\n";
html_nice_answer($c,"HTTP Getter Version: $VERSION");
+
} elsif ($http_method eq 'GET' and $http_path =~ /\.cgi$/) {
+ # cgi handling
print "CGI requested!\n";
if ($http_path !~ /^\/[^\/]*\.cgi$/) {
html_nice_answer($c,"Invalid CGI name: $http_path, ".
html_nice_answer($c,"CGI '$http_path' not found ".
"in CGI dir '$cgi_dir'");
}
- } else {
+
+ } else { # unsupported request
print "\n";
print "INVALID REQUEST!!!!!\n";
print "(PATH: ",$http_path,", ";
print "QUERY: ",$http_query,")\n";
$c->send_error(RC_FORBIDDEN)
}
+
print "\nRequest solved: ".$r->url."\n\n";
}
+
$c->close;
undef($c);
print "\nCONNECTION CLOSED\n\n";
#================================
+sub isRdfUri { # return true if the uri is an rdf uri, false otherwise
+# typycal rdf uri:
+# helm:rdf/cic:www.cs.unibo.it/helm/rdf/foo_schema//cic:\
+# /Coq/Init/Logic/True_rec.con.types
+#
+# the format is "helm:rdf/<metadata_tree>:<metadata_scheme>//<xml_file_uri>"
+#
+ my ($uri) = @_;
+ if ($uri =~ /^helm:rdf(.*):(.*)\/\/(.*)/) {
+ return 1;
+ } else {
+ return 0;
+ }
+}
+
+sub resolve { # resolve an uri in a url, work both with standard cic: or theory:
+ # uris and rdf uris
+ print "RESOLVE subroutine\n";
+ my ($uri) = @_;
+ print "GIVEN URI: \"$uri\"\n";
+ if (isRdfUri ($uri)) { # rdf uri, resolve using rdf db
+ print "IS A RDF URI\n";
+ print "I WILL RETURN '$rdf_map{$uri}'\n";
+ return ($rdf_map{$uri});
+ } else { # standard cic: or theory: uri, resolve using std uri db
+ print "IS NOT A RDF URI\n";
+ print "I WILL RETURN '$map{$uri}'\n";
+ return ($map{$uri});
+ }
+}
+
sub finduris { # find uris for cic and theory trees generation
my ($uritype,$uripattern,$format) = @_;
my $content = "";
my ($uri,$localpart,$basepart,$dirname,$suffix,$flags,$key);
my (@itemz,@already_pushed_dir);
my (%objects,%dirs); # map uris to suffixes' flags
- #my $debug=1; # for debug
+ my $debug=1; # for debug
print "FINDURIS, uritype: $uritype, uripattern: $uripattern, ".
"format: $format\n\n" if defined($debug);
sub print_request
{
- my ($str,$uri,$url,$filename) = @_;
- print $str."uri: $uri\n";
- print $str."url: $url\n";
- print $str."filename: $filename\n\n";
+ my ($uri,$url,$filename) = @_;
+ print "<download_request>\n";
+ print "uri: $uri\n";
+ print "url: $url\n";
+ print "filename: $filename\n\n";
+ print "</download_request>\n";
}
sub callback
}
sub download {
- my ($patch_dtd,$str,$url,$filename,$format) = @_;
+ my ($patch_dtd,$url,$filename,$format) = @_;
my ($gz, $buffer);
- #my $debug=1; # for DEBUG only
+# print "DOWNLOAD subs receives url: \"$url\"\n";
+# print "DOWNLOAD subs receives filename: \"$filename\"\n";
my $resourcetype; # retrieve mode: "normal" (.xml) or "gzipped" (.xml.gz)
if ($filename =~ /\.xml$/) { # set retrieve mode
}
if ($localfname ne "") { # we already have local copy of requested file
# check both possible cache entry: gzipped or normal
- print "Using local copy for the $str file\n";
+ print "Using local copy.\n";
if ($localfname =~ /\.xml\.gz$/) { # deflating cached file and return it
$cont = gunzip($localfname);
} elsif ($localfname =~ /\.xml$/) { # just return cached file
."must end with '.gz' or '.xml.gz'\n";
}
} else { # download file from net
- print "Downloading the $str file\n"; # download file
+ print "Downloading file ...\n"; # download file
my $ua = LWP::UserAgent->new;
my $request = HTTP::Request->new(GET => "$url");
my $response = $ua->request($request, \&callback);
# cache retrieved file to disk
# <ZACK/> TODO: inefficent, I haven't yet undestood how to deflate
# in memory gzipped file, without call "gzopen"
- print "Storing the $str file\n";
- print "Making dirs ...\n" if (defined($debug));
+ print "Storing file ...\n";
+# print "Making dirs ...\n";
mkdirs($filename);
- print "Opening tmp file for writing ...\n" if (defined($debug));
+# print "Opening tmp file for writing ...\n";
open(FD, ">".$filename.".tmp") or die "Cannot open $filename.tmp\n";
- print "Writing on tmp file ...\n" if (defined($debug));
+# print "Writing on tmp file ...\n";
print FD $cont;
- print "Closing tmp file ...\n" if (defined($debug));
+# print "Closing tmp file ...\n";
close(FD);
# handle cache conversion normal->gzipped or gzipped->normal as user choice
- print "cachemode:$cachemode, resourcetype:$resourcetype\n" if (defined($debug));
+ print "cachemode:$cachemode, resourcetype:$resourcetype\n"
+ if (defined($debug));
if (($cachemode eq 'normal') and ($resourcetype eq 'normal')) {
# cache the file as is
rename "$filename.tmp", $filename;
unless ($contype eq "");
$res->push_header("Content-Encoding" => $contenc)
unless ($contenc eq "");
+ $res->push_header("Cache-Control" => "no-cache");
+ $res->push_header("Pragma" => "no-cache");
+ $res->push_header("Expires" => "0");
$c->send_response($res);
}
}
sub update {
+# retie dbs
untie %map;
- tie(%map, 'DB_File', $uris_dbm.".db", O_RDONLY, 0664);
+ tie(%map, 'DB_File', $uris_dbm.".db", O_RDWR, 0664);
+ untie %rdf_map;
+ tie(%rdf_map, 'DB_File', $rdf_dbm.".db", O_RDWR, 0664);
}
-sub mk_urls_of_uris {
-#rebuild $uris_dbm.db fetching resource indexes from servers
+sub update_dbs {
+# rebuild dbs fetching resource indexes from servers.
+# Rebuild urls_of_uris db (1) and rdf db (2)
my (
- $server, $idxfile, $uri, $url, $comp, $line,
+ $server, $idxfile, $rdf_idxfile, $uri, $url, $comp, $line,
@servers,
- %urls_of_uris
+ %urls_of_uris, %rdf # local proxy of $map and $rdf_map
);
untie %map;
- if (stat $uris_dbm.".db") { # remove old db file
- unlink($uris_dbm.".db") or
- die "cannot unlink old db file: $uris_dbm.db\n";
+ untie %rdf_map;
+ foreach my $file ($uris_dbm, $rdf_dbm) { # remove old db file
+ if (stat $file.".db") { # remove if exists
+ unlink ($file.".db") or die "can't unlink old db file: $file.db\n";
+ }
}
tie(%urls_of_uris, 'DB_File', $uris_dbm.".db", O_RDWR|O_CREAT, 0664);
+ tie(%rdf, 'DB_File', $rdf_dbm.".db", O_RDWR|O_CREAT, 0664);
open (SRVS, "< $servers_file") or
die "cannot open servers file: $servers_file\n";
- @servers = <SRVS>;
+ @servers = <SRVS>; # read all servers
close (SRVS);
- while ($server = pop @servers) { #cicle on servers in reverse order
+
+ while ($server = pop @servers) { # cicle on servers in _reverse_ order
print "processing server: $server ...\n";
chomp $server;
- helm_wget($tmp_dir, $server."/".$indexname); #get index
+ helm_wget($tmp_dir, $server."/".$indexname); # get index
+ helm_wget($tmp_dir, $server."/".$rdf_indexname); # get rdf index
$idxfile = $tmp_dir."/".$indexname;
- open (INDEX, "< $idxfile") or
+ $rdf_idxfile = $tmp_dir."/".$rdf_indexname;
+
+ open (INDEX, "< $idxfile") or # (1) REBUILD URLS_OF_URIS DB
die "cannot open temporary index file: $idxfile\n";
- while ($line = <INDEX>) { #parse index and add entry to urls_of_uris
+ while ($line = <INDEX>) { # parse index and add entry to urls_of_uris db
chomp $line;
($uri,$comp) = split /[ \t]+/, $line;
# build url:
$url =~ s/theory:/$server/;
$urls_of_uris{$uri} = $url;
}
- close INDEX;
- die "cannot unlink temporary file: $idxfile\n"
+
+ open (RDF_INDEX, "< $rdf_idxfile") or # (2) REBUILD RDF DB
+ die "cannot open temporary rdf index file: $rdf_idxfile\n";
+ while ($line = <RDF_INDEX>) { # parse index and add entry to rdf db
+ chomp $line;
+ ($uri,$comp) = split /[ \t]+/, $line; # comp is "gz" or nothing
+ # build url:
+ if ($comp =~ /gz/) {
+ $url = $uri . ".xml" . ".gz";
+ } else {
+ $url = $uri . ".xml";
+ }
+ $url =~ s/^helm:rdf(.*)\/\/cic:/$server/;
+ $url =~ s/^helm:rdf(.*)\/\/theory:/$server/;
+ $rdf{$uri} = $url;
+ }
+
+ close INDEX; # close indexes
+ close RDF_INDEX;
+ die "cannot unlink temporary file: $idxfile\n" # remove temp files
if (unlink $idxfile) != 1;
+ die "cannot unlink temporary file: $rdf_idxfile\n"
+ if (unlink $rdf_idxfile) != 1;
+
}
- untie(%urls_of_uris);
- tie(%map, 'DB_File', $uris_dbm.".db", O_RDONLY, 0664);
-}
+ untie(%urls_of_uris); # untie local proxies
+ untie(%rdf);
+ tie(%map, 'DB_File', $uris_dbm.".db", O_RDWR, 0664); # retie global ones
+ tie(%rdf_map, 'DB_File', $rdf_dbm.".db", O_RDWR, 0664);
+} # update_dbs
+
+# vim modline: do not remove!
+# vim: set ft=perl: