Esimerkki uudelleenohjauksen teknisestä toteutuksesta

Transkriptio

1 Esimerkki uudelleenohjauksen teknisestä toteutuksesta Keskustelutilaisuus JHS-suositusluonnoksesta Paikkatiedon yksilöivät tunnisteet Marko Kauppi

2 Liite 2. Esimerkki tiedontuottajan URIpalvelun teknisestä toteutuksesta Sisällys 1 Johdanto 2 Tiedontuottajan URI-palvelun toimintaperiaate ja vastauskäytänteet 3 Tekniset vaatimukset 4 Tiedontuottajan URI-palvelun toteutusvaiheet 5 Tiedontuottajan URI-palvelun palauttaman RDF-tiedon rakennekuvaus 6 Esimerkkitiedostot 6.1 XSLT-muunnostiedosto 6.2 SPARQL-kysely 6.3 RDF-esimerkki 6.4 Apache.htaccess -tiedosto

3 URI-palvelun toteutus vaiheittain 1. Luodaan paikkatietokohteisiin liittyvän dokumentaation sisältävä, luvussa 5 esitetyn RDF-skeeman mukainen, SPARQL insert -lause. Lause voidaan muodostaa WFS:n GetFeature kohdetietokyselyn palauttamasta GML-dokumentista XSLT-muunnoksella. Muunnoksen määrittelyyn ja suorittamiseen on olemassa hyviä valmiita sovelluksia verkossa. Esimerkkitoteutuksessa käytettävä XSLT-muunnostiedosto on esitetty luvussa Ladataan paikkatietokohteisiin liittyvä dokumentaatio kohdassa 1 muodostetulla SPARQL insert -lauseella Apache Jena Fusekin RDFtietokantaan. 3. Tehdään SPARQL-kysely Apache Jena Fuseki tietokantaan luvun 6.2 mukaisesti. Kysely palauttaa luvussa 5 määritellyn RDF -skeeman mukaiset tiedot, joista esimerkki luvussa Luodaan.htaccess -tiedosto Apache HTTP -palvelimelle, joka näkyy verkkoon.

4 Käytännön esimerkki toteutuksesta:

5 XSLT-muunnin ja aineisto Voidaan hyödyntää ilmaisia verkosta löytyviä XSLT-muuntimia ( tai kaupallisia tuotteita esim. Altovan XMLSpy Esimerkissä käytetään Tampereen kaupungin bussipysäkki aineistoa ora/ows?service=wfs&version=1.0.0&request=getfeature &typename=tampere_ora:bussipysakit_wb

6 XSLT-muunnoslause esimerkki (6.1) <?xml version="1.0" encoding="utf-8"?> <xsl:stylesheet version="1.0" xmlns:xsl=" xmlns:fo=" xmlns:tampere_ora=" xmlns:gml=" > <xsl:output method="text" indent="yes"/> <xsl:template match="/"> PREFIX rdf: < PREFIX rdfs: < PREFIX dc: < PREFIX jhs: < <!-- Muodostetaan SPARQL INSERT -lause. INSERT-lauseessa RDF-kolmikot esitetään Turtle-formaatissa. --> INSERT DATA { <xsl:for-each select="//tampere_ora:bussipysakit_wb"> <!-- Paikkatietokohteeseen liittyvä dokumentaatio --> < select="tampere_ora:tunniste"/>> rdf:type jhs:doc; jhs:so < select="tampere_ora:tunniste"/>>; jhs:id < select="tampere_ora:digiroad_id"/>>; rdfs:seealso < select="tampere_ora:digiroad_id"/>>; dc:hasformat < select="tampere_ora:tunniste"/>/epsg:3067.json>; dc:hasformat < select="tampere_ora:tunniste"/>/epsg:3067.gml2>; dc:hasformat < select="tampere_ora:tunniste"/>/epsg:3878.json>; dc:hasformat < select="tampere_ora:tunniste"/>/epsg:3878.gml2>; dc:subject < <!-- Paikkatietokohteen esitysmuodot --> < select="tampere_ora:tunniste"/>/epsg:3067.json> rdf:type jhs:data; jhs:so < select="tampere_ora:tunniste"/>>; jhs:crs < dc:format "application/json". < select="tampere_ora:tunniste"/>/epsg:3067.gml2> rdf:type jhs:data; jhs:so < select="tampere_ora:tunniste"/>>; jhs:crs < dc:format "application/gml". < select="tampere_ora:tunniste"/>/epsg:3878.json> rdf:type jhs:data; jhs:so < select="tampere_ora:tunniste"/>>; jhs:crs < dc:format "application/json". < select="tampere_ora:tunniste"/>/epsg:3878.gml2> rdf:type jhs:data; jhs:so < select="tampere_ora:tunniste"/>>; jhs:crs < dc:format "application/gml". </xsl:for-each> } </xsl:template> </xsl:stylesheet> RDF-skeeman mukainen SPARQL insert -lause Dokumentaatio RDFtietokantaan SPARQL-kysely RDF-tietokantaan.htaccess -tiedosto Apache HTTP - palvelimelle

7 Apache Jena Fuseki esimerkki Lisätään muunnoksella tuotettu insert-lause Fuseki-tietokantaan RDF-skeeman mukainen SPARQL insert -lause Dokumentaatio RDF-tietokantaan SPARQL-kysely RDF-tietokantaan.htaccess -tiedosto Apache HTTP - palvelimelle

8 SPARQL-kysely Apache Jena Fuseki tietokantaan (6.2) PREFIX rdf: < PREFIX rdfs: < PREFIX dc: < PREFIX jhs: < CONSTRUCT { < jhs:so?so; rdf:type?a; jhs:id?h; rdfs:seealso?g; dc:subject?b; dc:hasformat?c.?c jhs:crs?d.?c dc:format?e.?c rdf:type?f } WHERE { < jhs:so?so; rdf:type?a; jhs:id?h; rdfs:seealso?g; dc:subject?b; dc:hasformat?c.?c jhs:crs?d.?c dc:format?e.?c rdf:type?f }

9 <rdf:rdf xmlns:jhs=" xmlns:rdf=" xmlns:dc=" xmlns:rdfs=" <jhs:doc rdf:about=" <dc:hasformat> <jhs:data rdf:about=" <dc:format>application/json</dc:format> <jhs:crs rdf:resource=" </jhs:data> </dc:hasformat> <dc:hasformat> <jhs:data rdf:about=" <dc:format>application/gml</dc:format> <jhs:crs rdf:resource=" </jhs:data> </dc:hasformat> <dc:hasformat> <jhs:data rdf:about=" <dc:format>application/json</dc:format> <jhs:crs rdf:resource=" </jhs:data> </dc:hasformat> <dc:hasformat> <jhs:data rdf:about=" <dc:format>application/gml</dc:format> <jhs:crs rdf:resource=" </jhs:data> </dc:hasformat> <dc:subject rdf:resource=" <rdfs:seealso rdf:resource=" <jhs:id rdf:resource=" <jhs:so rdf:resource=" </jhs:doc> </rdf:rdf> Identifioi paikkatietokohteen sisällön, sen ominaisuudet ja arvot. Fyysinen aineisto URIen kautta, ohjaa tiedontuottajan WFS-rajapinnalle Suhde toisen tiedontuottajan aineistoon

10 Luodaan.htaccess -tiedosto Apache HTTP -palvelimelle <IfModule mod_rewrite.c> RewriteEngine On Rewritebase /uri/ # RewriteRule uudelleenohjaa doc-polkukomponentin muuttujat ([a-za-z0-9]+)/([a-za-z0-9:]+).([a-za-z0-9]+) wfs-kohdekyselyyn $1,$2,$3. Huomaa, että RewriteRule tulee olla yhdellä rivillä, ei niin kuin alla esitetty. RewriteRule ^doc/ /([a-za-z0-9_]+)/([a-za-z0-9:]+).([a-za-z0-9]+)$ ce=wfs&version=1.0.0&request=getfeature&typename=tampere_ora:b USSIPYSAKIT_WB&outputformat=$3&srsName=$2&Filter=<Filter><Prope rtyisequalto><propertyname>tunniste</propertyname><literal>$1</l iteral></propertyisequalto></filter>

11 RewriteRule ^doc/ /([a-za-z0-9_-]+)$ 99/02/22-rdf-syntax-ns#>PREFIX+rdfs:+< atiedot.fi/jhsskeema#>construct+{< ;rdf:type+?f;jhs:id+?h;rdfs:seealso+?g;dc:subject+?a;dc:hasformat+?b.?b+jhs:crs +?c.?b+dc:format+?d.?b+rdf:type+?e}+where{< 0358/$1>+jhs:so+?jep;rdf:type+?f;jhs:id+?h;rdfs:seeAlso+?g;dc:subject+?a;dc:hasF ormat+?b.?b+jhs:crs+?c.?b+dc:format+?d.?b+rdf:type+?e}+&output=xml </IfModule>

12 DEMO - URI -tunnisteiden hyödyntämisestä Bussipysäkkidatan linkittyminen URI - hackathon