Dátová časť D2000 JAPI slúži na prenos dáta a event-ov medzi klientskou aplikáciou a D2000 aplikáciou v oboch smeroch komunikácie. Podrobný popis API je dostupný vo forme javadoc.
6.1.1. ObjectInfo a OpenObject
Klientská aplikácia môže získavať informácie o objektoch D2000 a ich hodnoty pomocou metód D2Session:
getObjectInfo(...)
openObject(...)
Referenčná implementácia:
sk.ipesoft.d2000.d2japi.tests.ObjectInfoTest
sk.ipesoft.d2000.d2japi.tests.OpenObjectTest
6.1.2. Prístup k STRUCTDEF dátam
Klientská aplikácia môže získavať informácie o definícii štruktúr D2000 pomocou metódy D2Session:
getStructDefInfo(...)
Referenčná implementácia:
sk.ipesoft.d2000.d2japi.tests.StructDefInfoTest
6.1.3. Prístup k archívnym dátam
Klientská aplikácia môže získavať archívne dáta D2000 pomocou metódy D2Session:
getArchiveValues(...)
Referenčná implementácia:
sk.ipesoft.d2000.d2japi.tests.ArchiveTests
6.1.4. Volanie D2000 RPC procedúr
Klientská aplikácia môže volať RPC procedúry existujúcich Event objektov D2000 pomocou metód D2Session:
callRPC(..)
callRPCNoreply(...)
Referenčná implementácia:
sk.ipesoft.d2000.d2japi.tests.RPCTest
6.1.5. Send Byte Array z klientskej aplikácie
Jedná sa o komunikáciu medzi klientskou aplikáciou a RPC procedúrou Event objektu, ktorá musí byť implementovaná v prostredí D2000 Java. Klientská aplikácia vie poslať objekt typu byte[] RPC procedúre a získať návratovú hodnotu rovnakého typu byte[] ako odpoveď. Objekty typu byte[] slúžia napríklad na netypový prenos IN/OUT parametrov medzi klientskou aplikáciou a prostredím D2000 Java v prípade že trasformácia na objekty typu Unival nie je možná. Pri použití tohto typu komunikácie je dôležité aby obe strany rozumeli IN/OUT byte[] dátam na aplikačnej úrovni.
Metódy D2Session:
sendByteArray(…)
sendByteArrayNoreply(…)
Referenčná implementácia:
-
sk.ipesoft.d2000.d2japi.tests.SBATest
6.1.6. JAPI event listeners
Klientská aplikácia využívajúca JAPI si dokáže zaregistrovať listener objekty a reagovať tak na SBA alebo RPC volania event procesov D2000. Jedná sa o obsluhu volaní CALL … ASYNC ON, CALL … SYNC ON, sendByteArraySync, sendByteArrayAsync, callESLSync a callESLAsync. Registrácia listener objektov klientskej aplikácie prebieha pomocou metód D2Session:
setRPCListener(…)
setSBAListener(…)
6.1.6.1. Send Byte Array z prostredia D2000 Java
Táto časť JAPI slúži na asynchrónne prijímanie objektov typu byte[]
z prostredia D2000 Java (z bežiaceho D2000 Event procesu) klientskou aplikáciou. Klientská aplikácia si zaregistuje listener na odoberanie sendByteArraySync
a sendByteArrayAsync
volaní. D2000 aplikácia vie poslať z prostredia procedúry Event objektu implementovanej v D2000 Jave request, ktorý bude obslúžený klientskou aplikáciou.
Referenčná implementácia:
-
sk.ipesoft.d2000.d2japi.tests.SBAEventsTest
6.1.6.2. Volanie RPC procedúr z prostredia D2000 Java
Táto časť JAPI slúži na asynchrónne prijímanie eventov z prostredia D2000 Java alebo ESL, klientskou aplikáciou. Klientská aplikácia si zaregistuje listener na odoberanie RPC volaní CALL … ASYNC ON
, CALL … SYNC ON
, callESLSync
a callESLAsync
. D2000 aplikácia vie poslať z prostredia RPC procedúry Event objektu (Java alebo ESL) request, ktorý bude obslúžený klientskou aplikáciou.
Referenčná implementácia:
sk.ipesoft.d2000.d2japi.tests.RPCEventsTest
6.2. D2000 JAPI Utility
Pre jednoduchšie použitie D2000 JAPI vznikli tieto utility triedy:
sk.ipesoft.d2000.d2japi.D2SessionUtils
6.3. Management API
Táto časť D2000 JAPI slúži na management D2000 runtime prostredia a týka sa predovšetkým infraštruktúry D2000 Servera. Táto časť JAPI nie je primárne určená pre aplikčných programátorov. Hlavná funkcionalita management API je:
- Sledovanie stavu procesov D2000 servera
openProcessList(...)
- Komunikácia s procesmi D2000 servera pomocou TellCommands
getSupportedTellCommands(...)
tellCommand(...) - Nastavovanie debug informácií procesov D2000 servera
getDebugInfoCategories(...)
setDebugInfo(...) - Real Time Info komunikácia s procesmi D2000
getRTIProviders(...)
execRTICommand(...) - Monitoring Console Output D2000 procesov
openCono(...)
6.3.1. License Managent API
Manažment licencií a runtime license info je dostupné pomocou metód D2Session
getLicenseStatus(...)
consoleInfo(...)
changeConsoleInfo(...)
6.3.2. Audit Management API
Táto časť slúži na získanie dát o všetkých aktivitách a zmenách konfigurácie objektov typu Užívateľ a Skupina objektov. Dáta sú k dispozícii iba v prípade, že je aktívne úplné monitorovanie – viď konfiguračnú príručku systému D2000, kapitola Užívateľa prístupové práva v systéme/Monitorovanie zmien v konfigurácii objektu Užívateľ a Monitorovanie zmien v konfigurácii objektu Skupina Objektov.
K načítaniu záznamov z databázy slúžia operácie
getAuditUserOperations(...)
getAuditResourceGroupOperations(...)
K načítaniu zoznamu možností pre filtrovacie podmienky týchto dvoch volaní slúži metóda
getAuditData(...)
Pridať komentár