...
Príručka aplikačného programátora
Rozhranie D2000 Java API (JAPI) implementuje prístup k systému D2000 z prostredia externej Java aplikácie. S využitím JAPI je možné vytvoriť klient proces systému D2000, alebo prepojiť externú aplikáciu s aplikáciou implementovanou na platforme D2000. Rozhranie JAPI je tvorené knižnicou v jazyku JAVA distribuovanou vo forme JAR súboru (d2japi-<verzia>.jar).
Tento dokument popisuje predovšetkým architektúru knižnice JAPI z nadhľadu a hoci obsahuje aj niektoré praktické ukážky, jeho hlavným cieľom je vytvoriť všeobecný obraz o knižnici. Je preto odporúčané, aby ho budúci používatelia knižnice čítali ako prvý, avšak viac príkladov použitia ako aj podrobná technická dokumentácia jednotlivých tried a metód je umiestnená v ďalších zdrojoch.
Podrobná technická dokumentácia jednotlivých tried a metód knižnice je tvorená vo formáte javadoc a je distribuovaná vo forme JAR súboru (d2japi-javadoc-<verzia>.jar). Je odporúčané, aby si používatelia knižnice asociovali vo svojom vývojovom prostredí knižnicu JAPI s jej javadoc dokumentáciou.
Konkrétne príklady použitia jednotlivých volaní knižnice JAPI sú distribuované vo forme JAR súboru (d2japi-tests-<verzia>-sources.jar). Súbory, ktoré sa tu nachádzajú sú zároveň aj testovacie predpisy regresných testov knižnice JAPI. Table of Contents
1. Úvod
2. Architektúra riešenia
3. Nadviazanie spojenia medzi klientskou aplikáciou a D2000
3.1. Parametre pre spustenie D2Connector-a
3.2. Základný spôsob pripojenia
3.3. Vytvorenie Session
3.4. Nadviazanie reverzného spojenia
3.5. Nadviazanie zabezpečeného spojenia
3.5.1. Vytvorenie certifikátu pre účely zabezpečeného spojenia
3.6. Spojenie riadené triedou RedundantConnectionManager
4. Typ D2000 Unival
4.1. Štruktúrovaný Unival
4.2. Zobrazovanie hodnoty D2000 objektov na UI podľa konfigurácie
4.3. Preklad textu, ktorý obsahuje slovníkové kľúče
5. Anotácie JAPI pre pokročilé mapovanie na objekty D2000
5.1. Mapovanie typu D2000 Unival
5.1.1. Mapovanie hodnoty a platnosti hodnoty unival-u
5.1.2. Mapovanie unival atribútu
5.2. Mapovanie štruktúrovaných Unival hodnôt
5.2.1. Príklad s vysvetlivkami
5.2.2. Priame použitie triedy UnivalConvertor pre využitie mapovania
5.3. Definícia mapovania RPC volaní
5.3.1. Zoznam parametrov pre volanie RPC
5.3.2. Volanie z JAPI do ESL – príklad s komentármi
5.3.3. Volanie z ESL do JAPI – príklad s komentármi
5.3.4. Použitie anotácie CallerInformation
5.4. Použitie anotovaných objektov
5.4.1. Príklad volania z JAPI do ESL
5.4.2. Príklad volania z ESL do JAPI
6. Praktické použite JAPI v príkladoch
6.1. Test správnosti adresovania RPC alebo SBA
6.2. Čítanie dát z archívu
7. Data API
7.1.1. ObjectInfo a OpenObject
7.1.2. Prístup k STRUCTDEF dátam
7.1.3. Prístup k archívnym dátam
7.1.4. Volanie D2000 RPC procedúr
7.1.5. Send Byte Array z klientskej aplikácie
7.1.6. JAPI event listeners
7.2. D2000 JAPI Utility
7.3. Management API
7.3.1. License Managent API
7.3.2. Audit Management API
8. Neskoršie rozšírenia rozhraní pre spracovanie udalostí
8.1. D2ConnectorEventsListener
8.2. D2SessionEventsListener
8.3. D2ObjectEventsListener
9. Zmeny verejného API medzi verziami 10.0.37 a 10.1.39
9.1. Odčlenenie balíčka sk.ipesoft.d2000.async
9.2. Zabezpečené a reverzné pripojenie JAPI
9.3. Zdieľané zdroje systému D2000
9.4. Použitie konkrétnych Table tried namiesto AnonymousTable
9.5. Podpora odľahčenej verzie štruktúrovanej UNIVAL hodnoty
9.6. Rozšírenie čítania dát z archívu o ArchiveObjectDescription
9.6.1. Rozšírenie rozhrania ArchiveDataListener
9.6.2. Rozšírenie rozhrania ArchiveDataProvider
9.7. Výpočet archívnej štatistickej funkcie
9.8. Rozšírenie rozhrania AuditDataListener
9.9. Úprava logiky operácie close v rozhraniach D2Object, D2Cono, D2ProcessList, D2Session
9.10. Rozšírenie rozhrania D2SessionEventsListener
9.11. Volanie RPC implementujúcej ESL rozhranie
9.12. Test existencie RPC a SBA volania
9.13. Informácie o prihlásenom používateľovi a zmena hesla používateľa
9.14. Zmena správania pri neúspešnom vytvorení D2Session
9.15. Volanie D2Session.getIndirectInfo
9.16. Volanie D2Session.getObjectInfo vráti aktuálnu hodnotu objektu
9.17. Volanie D2Session.openObject vráti informácie o objekte
9.18. Zmena rozhrania RPCReturnContext
9.19. Zmena rozhrania SBAReturnContext
9.20. Zastaraná D2SessionUtils.getObjectHOBJByName