capitex.integration (api för plugin-implementationer)

Boendekalkylen har inga egna färdiga funktioner för att hämta/spara eller importera. Det är upp till anroparen att implementera de klasser som behövs för detta.

För att implementera dessa funktioner så skapar man ett Java Class Library och lägger in en reference till capitex.integration.jar. I denna jar finns interface för logiken och DTO's för som används vid kommunkation med Boendekalkylen. Med DTO's så menar vi Data Transfer Objects, objekt utan logik med bara setters och getters som används för att skicka information mellan plugin-funktionerna och boendekalkylen.

Implementationsklasserna kan placeras i classpath, tänk på att capitex.integration.jar också måste placeras där i så fall för att det ska fungera. Tänk också på att denna måste bytas ut om en ny version av boendekalkylen tex lagt till ett fält i någon av dataklasserna som finns i jar'en. Vi informerar om vilka ändringar som görs i denna för varje version av Boendekalkylen. Den senaste capitex.integration.jar kan alltid extraheras ut från installationspaketet (EAR'en). Detta behöver dock inte betyda att plugin-klasserna måste kompileras om.

Ett godtyckligt säkerhetstoken kan skickas med från den webbsidan som integrerar boendekalkylen så att plugin-klasserna får de rättigheter som behövs för att kommunicera med anroparens egen databas/datalager.

I konfigurationsfilen anger man namnet på de klasser som implementerar respektive gränssnitt. Exempel:

<Impcapitex_integration_dataadaptrar_IListaEnHandlaeggaresKalkyler>capitex.boendekalkyl.datalager.testimpl.ListaEnHandlaeggaresKalkyler</Impcapitex_integration_dataadaptrar_IListaEnHandlaeggaresKalkyler>
<Impcapitex_integration_dataadaptrar_IHaemtaKalkyl>capitex.boendekalkyl.datalager.testimpl.HaemtaKalkyl</Impcapitex_integration_dataadaptrar_IHaemtaKalkyl>
<Impcapitex_integration_dataadaptrar_IListaAllaKalkylerFoerEnPerson>capitex.boendekalkyl.datalager.testimpl.ListaAllaKalkylerFoerEnPerson</Impcapitex_integration_dataadaptrar_IListaAllaKalkylerFoerEnPerson>
<Impcapitex_integration_dataadaptrar_IRaderaKalkyl>capitex.boendekalkyl.datalager.testimpl.RaderaKalkyl</Impcapitex_integration_dataadaptrar_IRaderaKalkyl>
<Impcapitex_integration_dataadaptrar_ISoekKalkyler>capitex.boendekalkyl.datalager.testimpl.SoekKalkyler</Impcapitex_integration_dataadaptrar_ISoekKalkyler>
<Impcapitex_integration_dataadaptrar_ISparaKalkyl>capitex.boendekalkyl.datalager.testimpl.SparaKalkyl</Impcapitex_integration_dataadaptrar_ISparaKalkyl>
<Impcapitex_integration_imp_dataadaptrar_IPersonImport>capitex.boendekalkyl.datalager.testimpl.PersonImport</Impcapitex_integration_imp_dataadaptrar_IPersonImport>
<Impcapitex_integration_imp_dataadaptrar_IKreditImport>capitex.boendekalkyl.datalager.testimpl.KreditImport</Impcapitex_integration_imp_dataadaptrar_IKreditImport>
<Impcapitex_integration_imp_dataadaptrar_IFastighetsImport>capitex.boendekalkyl.datalager.testimpl.FastighetsImport</Impcapitex_integration_imp_dataadaptrar_IFastighetsImport>

Exemplet ovan är testimplementationen som ingår i Boendekalkylen som sparar kalkyler lokalt på hårddisken i katalogen c:\boendekalkyl (katalogen måste skapas manuellt, plugin'et fungerar bara i Windows). Denna bör inte flyttas till classpath för att testa hur detta fungerar, eftersom den är beroende av fler jar-filer än capitex.integration.jar. Det är inte lämpligt att flytta ut alla jar-filer som denna är beroende av.

För mer info se API-beskrivningen