X-Road ja WFS-rajapinnat, uudet APIt. Pekka Latvala , KaPA ja paikkatietoinfrastruktuurin kärkiteeman työpaja

Transkriptio

1 X-Road ja WFS-rajapinnat, uudet APIt Pekka Latvala , KaPA ja paikkatietoinfrastruktuurin kärkiteeman työpaja

2 Agenda Palveluväylä Oman palvelun liittäminen palveluväylään Sovitinpalvelu -sanomat WFS-kyselyt palveluväylässä Uudet APIt

3 Palveluväylä XML, JSON yms. Sovitinpalvelin #1 Sovitinpalvelin #2 Palveluväylä XML, JSON yms. Palvelin Sovitinpalvelu Tietojärjestelmä Liityntäpalvelin

4 Oman palvelun liittäminen palveluväylään Kun tietojärjestelmä liitetään osaksi palveluväylää, tulee tätä varten luoda sovitinpalvelu, joka muuntaa palvelun käyttämät viestit palveluväylässä käytettyyn -muotoon ja takaisin Omat esimerkkipalvelut tehty xrd4j-kirjaston pohjalta Java-pohjainen, avoimen lähdekoodin kirjasto Kehitteillä on myös avoimen lähdekoodin REST Gateway - komponentti REST-tuen toteuttamiseksi

5 Sovitinpalvelun vaatimukset Sovitinpalvelun tulee kyetä lähettämään ja vastaanottamaan -sanomia, jotka ovat X-Roadin tiedonsiirtoprotokollan mukaisia Tietojärjestelmien viestit pitää muuntaa kahteen suuntaan, palveluiden käyttämästä muodosta :iin ja takaisin X-Roadin kautta julkaistavilla palveluilla tulee olla luotuina WSDL-rajapintakuvaukset WSDL (Web Services Description Language) on XMLpohjainen kieli, jolla kuvataan verkkopalveluiden rajapinnat.

6 -viestit (Simple Object Access Protocol) XML-pohjainen tiedonvälitysprotokolla

7 -viestit - Header

8 -viestit - Body

9 WSDL-kuvauksen osia <wsdl:types> - Viestien kuvaus XML Schema muodossa <wsdl:message> - (wsdl 1.1) Viestin nimi <wsdl:porttype> - Operaatioiden input/output määrittelyt <wsdl:binding> - Operaatiot, -binding tyyli, siirtoprotokolla <wsdl:service> - Palvelun endpointin osoite

10 Sovitinpalvelun toteutusvaihtoehdot Palvelin Tietojärjestelmä Sovitinpalvelu Liityntäpalvelin Vaihtoehto 1 Sovitinpalvelu toteutetaan suoraan osaksi liitettävää järjestelmää Vaihtoehto 2 Sovitinpalvelu on erillinen komponentti samalla palvelimella Vaihtoehto 3 Sovitinpalvelu on erillinen komponentti omalla palvelimellaan

11 Palvelun lisääminen liityntäpalvelimelle Palvelun lisääminen liityntäpalvelimelle tapahtuu X-Roadin ylläpitoliittymän kautta Palvelut lisätään alijärjestelmiin WSDL-kuvaksen osoitteen määrittäminen Käyttöoikeuksien määrittäminen Käyttöoikeudet palveluihin annetaan alijärjestelmille

12

13

14

15 WFS-kyselyt palveluväylässä Sovitinpalvelin #1 Sovitinpalvelin #2 Palveluväylä FMI WFS WFS Get / Post GTK WFS Server-palvelu XML Client-palvelut WFS Get / Post 1. Käyttäjä lähettää WFS Get / Post kyselyjä client-palveluihin, joissa ne paketoidaan -viesteiksi 2. -kyselyt lähetetään palveluväylään liityntäpalvelimelle mmltest01 NLS WFS Käyttäjä Palvelin Tietojärjestelmä Sovitinpalvelu Liityntäpalvelin 3. Palveluväylä lähettää viestit eteenpäin mmltest02-liityntäpalvelimelle 4. Palveluväylä välittää -viestit sovitinpalveluun, jossa ne muunnetaan takaisin WFS Get / Post muotoon 5. WFS-muotoiset viestit lähetetään taustapalveluihin, ja niiden palauttamat vastaukset paketoidaan -viesteiksi. Kyselyjen vastausviestit kulkeutuvat takaisin client-palveluihin 6. Clienteissa -paketoinnit puretaan ja taustapalveluiden palauttamat XML-viestit lähetetään käyttäjälle

16 Uudet APIt Tarkoituksena WFS- ja WMS-kyselyjen yksinkertaistaminen ja geokoodauksen tuominen osaksi kyselyitä Käyttäjä tekee HTTP-kyselyt polkuparametrimuodossa WFS (esimerkki) /kohde/[kohdetyyppi]/[kunta]/[katunimi]/[katunumero]/[hakusäde]/[koordinaattijärjestelmä] WMS (esimerkki) /kartta/[tasonnimi]/[kunta]/[katunimi]/[katunumero]/[leveys_m]/[resoluutio]/[koordinaattijärjestelmä] Client-palveluiden eteen on luotu Apache-rewrite pohjaiset proxyt, joihin kyselyt tehdään polkuparametrimuodossa Proxyt uudelleenkirjoittavat kyselyt kyselyparametrimuotoon ja lähettävät ne clientpalveluun, joka geokoodaa osoitteen ja muodostaa -kyselyn, joka lähetetään palveluväylään

17 Uudet APIt Apache rewrite WFS vastausviesti Client WFS Post (osoite) Geokoodauspalvelu WFS vastausviesti (koordinaatit) Palveluväylä Sovitinpalvelin WFS XML

18 Kiitos