Obsah |
---|
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.
Kotva | ||||
---|---|---|---|---|
|
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
Kotva | ||||
---|---|---|---|---|
|
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
Kotva | ||||
---|---|---|---|---|
|
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
Kotva | ||||
---|---|---|---|---|
|
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
Kotva | ||||
---|---|---|---|---|
|
...
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
...
Kotva | ||||
---|---|---|---|---|
|
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 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
Kotva | ||||
---|---|---|---|---|
|
Pre jednoduchšie použitie D2000 JAPI vznikli tieto utility triedy:
sk.ipesoft.d2000.d2japi.D2SessionUtils
Kotva | ||||
---|---|---|---|---|
|
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(...)
Kotva | ||||
---|---|---|---|---|
|
Manažment licencií a runtime license info je dostupné pomocou metód D2Session
getLicenseStatus(...)
consoleInfo(...)
changeConsoleInfo(...)
Kotva | ||||
---|---|---|---|---|
|
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(...)