Sisäinen integraation ratkaisut 10.2.2012

Osa-alueet Integraatiokeskus Palvelurekisteri Palveluiden reititys Palveluiden versioiden hallinta Hajautetut transaktiot Transformaatiot (tarvittaessa) Synkronisuus/Asynkronisuus Tietoturva (Tunnistaminen ja roolit) Hallintajärjestelmä (Palvelurekisteri) Lokitus (Tapahtumaloki, vastaava kuin LUOVAssa käytössä oleva) Palvelurekisteri Palveluiden elinkaaren hallinta Palveluiden hallinta Palveluväylän hallinta Palvelun dokumentit Liittymä version- ja konfiguraationhallintaan

Ohjelmisto Linux version 2.6.32.13-0.5-default - ajoalusta Oracle 11g Standard Edition Release 1 - 11.1.0.7.0 – tapahtumalokin tietokantapalvelu DB2 v9.1 – palvelurekisterin tietokanta 32-bit SDK for Linux, Java 2 Technology Edition, v5.0 SR6 – ajoympäristön Java-versio IBM WebSphere Application Server Network Deployment 7.0 (32/64) bit - palvelinohjelmisto F5 kuormantasaus

Vaatimukset 1 Järjestelmät saatava integroitumaan keskenään Hallintajärjestelmä palveluiden versioiden ja järjestelmien välisille rajapinnoille Nopea integraatiototeutus, voitava tehdä yhdessä päivässä suurimmassa osassa tilanteita Järjestelmien kirjanpito ja palvelukutsujen tilastointi ja tilastoinnin hyödyntäminen Asynkroniset kutsut (esim. tulostusta varten) Hajautetut transaktiot Luotettava sanomanvälitys Monitorointi Systeemitilastot Lokitiedot

Vaatimukset 2 Geneeriset xml-rajapinnat Järjestelmien väliset kutsut aina integraatiojärjestelmän kautta Keskitetty palveluhakemisto Sanomakehys hallintaa ja reititystä varten Sanomien yksilöinti Autentikointi ja autorisointi Kutsurajapintojen määrä on rajallinen Järjestelmä mahdollistaa dynaamiset reititykset Systeemitilastot SLA n tarpeellisuutta on hieman kritisoitu, ehkä se mitä tuosta saataisiin irti on kutsukertoja, kutsujen kestoja, virheiden määrää per palvelu jne.

Miltä ratkaisu näyttää

Palvelurekisteri Kelassa rakennettu rekisteri Java-palveluille (vaihtoehtoina oli mm. WSRR ja UDDI). Toimii sekä teknisenä että informatiivisena rekisterinä Sisäinen integraatio käyttää rekisteriä dynaamisesti -> hakee palvelun osoitteen ym tiedot ajonaikaisesti Palvelun omistaja/vastuuhenkilö vie palvelun tiedot rekisteriin Palvelurekisterin ominaisuudet Palveluiden hallinta helpottuu -> kaikki yhdessä paikassa Versionti Palvelun tarjoama rajapinta näkyvissä sekä välitettävät tiedot Toimii teknisenä tukena palvelua kutsuvaa sovellusta rakentavalle kehittäjälle Antaa toimeksiantajalle/määrittelijällä tiedot olemassa olevista palveluista

- Dokumentti, palvelun osoite, skeeman juurielementti, nimiavaruus, nimiavaruuden etuliite olennaisia tietoja operaatioiden nimen ohella

Ohjelmoija tarvitsee TO- koodaukseen XML-esimerkkisanoman tai skeeman Jos liittyy jostain ei-java järjestelmästä skeema on tarpeen

Tapahtumaloki Sovellusloki tietokannassa Kaikki väylän kautta menevät sanomat Luovan lokin kopio Sanomien katselu tapahtuman kautta

Korrelaatiotunnisteella haetaan lokitietoja

Testaus SoapUI ”Kela-laajennuksin” Base64-koodaus/dekoodaus LTPA token muodostus Sanomakehyksen täydennys Käytetty Kanta-järjestelmän testauksessa Laajennukset helpottamaan testaamista Ohjelmoijan, palvelun vastuuhenkilön ja testaajan käyttöön samat testitapaukset

SoapUI-kutsuesimerkki soapUI:lla testaus, testit voidaan tehdä tässä esim. yksi steppit jossa laitetaan tiedot sanomakehykseen

…jatkuu Vaatii sen että integraatiokeskuksen wsdl haetaan soapUI:n palvelurekisteristä haetaan esimerkki- xml- sanoma kun halutaan että testit voi toistaa niin monistetaan testisteppejä ja vaihdetaan parametreja

…jatkuu - Tässä yksi esimerkkitulos

Palvelun kutsuminen Integraatiokeskuksen kautta (tapahtumat) Tässä vähän isompana kokonaisuutena

Ohjelmoinnista RAD pluginit Esimerkkikoodit wsdl ja skeema RADiin on tehty pari pluginia, voi alustaa client- projektin. Policy setit kopioi projektiin Toinen plugin generoi Java-luokista skeemoja ja esimerkki- XML-sanomia Esimerkkikoodeja löytyy CVS:stä ja Jasken palvelunteko-ohjeesta. Wsdl ja skeema on jätetty pois itse koodauksesta, koska sanomakehys mallissa niitä ei tarvita = Java-luokat on se mikä on tarpeellinen java-ympäristössä

Palvelun kutsuesimerkki Kutsuva sovellus Integraatiokeskuksen rajapinnan WSDL-kuvauksen sekä IntegraatiokeskusClient.jar –paketin - Kutsuvaan ei generoida WSDL:stä client javaluokkia, ne on IntegraatiokeskusClient.jar –paketissa - Exceptionit otetaan kiinni

Palvelun WS-rajapinta esimerkki -Web-service rakennetaan esimerkiksi EJB- palvelun päälle tekemällä uusi Web- projekti ja lisäämällä sinne Java-luokka, johon tehdään metodit, joista muodostuvat WS- operaatiot. - Konstruktoriin rajoitukset, millä roolilla tullaan sisään – riippuu sovelluksen ja palvelun käyttöoikeuksista

…jatkuu metodit annotoidaan annotaatiolla @WebMethod, jolloin niistä generoituu automaattisesti wsdl ja skeemat - @WebMethod annotaatio kertoo että luokka on WebService. - @WebResult kertoo että palautetaan ArkkiI- kehyksen mukainen Source- tyyppinen vastaussanoma. Tämä on ns. tyypittämätön rajapinta, jota suositellaan käytettäväksi. - @WebParam parametrina source-tyyppiset oliot Muunnetaan source:n sisältämä xml -> TO luokaksi ja poistetaan syötteestä tietoturvaongelmia (injektiot jne.) Haetaan tiedot ja muunnetaan ne takaisin xml-muotoon ja palautetaan source-tyyppisenä

SOA-toimisto Palveluluettelon ylläpitäminen Varmistaa, että olemassa olevat palvelut saadaan projektien yhteydessä käytettäväksi väylän kautta Projektien ja hankkeiden SOA- palveluiden käytön katselmointi SOA- palvelukuvausten katselmointi ja hyväksyntä Palveluiden toteutus- ja muutosaikataulujen viestintä ja aikataulujen ylläpito Palveluiden toteutus- ja muutosaikataulujen toteutumisen seuranta Projektien tukeminen SOA- palveluiden käyttöä suunniteltaessa SOA- palvelukuvausten ja palveluluettelon sisällön laadun valvonta 1-2 kertaa vuodessa tehtävä vertailu SOA- palveluiden käyttötilaston ja SOA- palvelukuvausten suorituskyky / käytettävyystietojen välillä Palautteen ja ideoiden vastaanotto

Ohjeet Palvelun kutsuminen ja tekeminen Palvelun testaaminen Y:\JAVA\Jaske\Julkaisut\versio1.0\Ohjeet\Jaske_palvelun_teko-ohje.pdf Palvelun testaaminen Y:\JAVA\Jaske\Julkaisut\versio1.0\Ohjeet\soapUIohje.pdf http://wiki.kela.fi/w/TukiWiki/ETUAintegraatio

LISÄMATSKUA: SOA-palveluiden kutsu 1 Järjestelmän A client kutsuu Apurekisteripalvelun versiota 2.0 metodia getKielitiedot saadakseen kielten aukikirjoituksen 2 Integraatiokeskus vastaanottaa kutsun, hakee Palvelurekisteristä kutsua vastaavan palvelun osoitteen (tekee muut toimenpiteensä) vastaanottaa ApurekisteriPalvelun palauttamat tiedot ja palauttaa sen kutsuvalle 3 Palvelurekisteri sisältää Apurekisteripalvelusta versiot 2.0, 3.0 (4.0) ja 5.0 4 ApurekisteriPalvelu v2.0 palauttaa vastaussanoman. Huomioi että ApurekisteriPalvelu 2.0 ja 3.0 ovat sama sovellus, jossa palvelun sisältöä ja rajapintaa on muutettu siten että muutokset eivät riko versiota 2.0 kutsuvia sovelluksia! 5 Järjestelmän B client kutsuu Apurekisteripalvelun versiota 3.0 metodia getKielitiedotUudet saadakseen kielten aukikirjoituksen kielitietoihin ja kielitiedon voimassaolon. 6 Järjestelmän C client kutsuu Apurekisteripalvelun versiota 5.0 metodia getKielet saadakseen kielten aukikirjoituksen kielitietoihin ja kielitiedon voimassaolon sekä muita lisättyjä tietoja. 7 ApurekisteriPalvelu 5.0 on Java 8 kehitetty sovellus, jossa palvelun sisältöä ja rajapintaa on muutettu siten että muutokset rikkovat version 2.0 ja 3.0 toiminnallisuuden ja rajapinnan!   Kun client 1 ja 2 haluavat kutsua ApurekisteriPalvelu v5.0 ne joutuvat koodaamaan operaation getKielitiedot -> getKielet nimellä. Milloin teen muutokset nykyiseen versioon palvelusta? - muutan palvelun eri tekniikalle eri palvelimelle, ei näy muuten kutsuvalle - muutan palvelun ulkoiseksi palveluksi - lisään operaation rajapintaan tietoja - poistan tai muutan operaatioista tietoja, joita kukaan ei käytä - lisään operaatioita - poistan tai uudelleen nimeän operaatioita, joita kukaan ei käytä - muutan palvelun logiikkaa siten että se ei vaikuta kutsuvien koodiin Milloin teen uuden version palvelusta? - poistan rajapinnasta tietoja, joita muut käyttävät tai nimeän niitä uudelleen - muutan sen ulkoiseksi palveluksi (toistaiseksi näin selkeyden vuoksi) - poistan palvelusta operaatioita tai nimeän niitä uudelleen - muutan palvelun logiikkaa siten että se vaikuttaa kutsuvien koodiin (rikkoo kutsuvat asiallisesti)