Megjegyzés
Ha a dokumentumban egy fájl- vagy könyvtárhelyre hivatkozik, akkor az <install-home> az a könyvtár, amelyben az ügynökvezérlő csomag kibontásra került.
Az ügynök indítási konfigurációs fájl (agent.xml) statikus információkat tartalmaz, amelyekre az ügynökvezérlőnek szüksége van az ügynök indításához és kezeléséhez. Ez a statikus információ a következőket tartalmazza:
A agent.xml fájlnak az ügynökhöz megnevezett könyvtár alatt kell elhelyezkednie. Az ügynök nevű könyvtárnak a serviceconfig.xml fájl Agent eleme által megadott könyvtárban kell lennie.A org.eclipse.tptp.TimeCollector nevű ügynök konfigurációs fájljának például az <install-home>/agents/org.eclipse.tptp.TimeCollector/agent.xml könyvtárban kell lennie. Az ügynökvezérlő a könyvtár nevét a név szerint kért ügynökök azonosításához használja. Az agent.xml konfigurációs fájl információi az ügynök metaadatai.
Megjegyezzük, hogy az ügynökvezérlő az összes ügynök agent.xml fájlját csak egyszer, az indításkor olvassa be. Ezután a fájlok tartalmának módosítása vagy új ügynökkönyvtárak felvétele esetén az ügynökvezérlőt újra kell indítani, mielőtt hatályba lépnének.
Elem: Agent
Ez az ügynök konfigurációs fájljának gyökéreleme. Az ügynök metaadatait
határozza meg. Az objektum kérheti egy ügynök metaadatait, majd tetszés szerint használja
fel ezeket az információkat. Az alább felsorolt részelemeket az ügynökvezérlő az
ügynök indításához és kezeléséhez használja. Az ügynökfejlesztők
további részelemeket is meghatározhatnak, ha további információk visszaadására van
szükség metaadatként. A metaadatok azon ügyfél számára hasznosak, amely megpróbál
a futási környezetről döntéseket hozni attól függően, hogy az adott feladathoz melyik ügynök használható.
Részelemek: Interface
SingleInstance
Bound
MaxControllers
MaxObservers
ConfigFile
LaunchConfigurationJellemzők:
- Name
- Ez a karaktersorozat érték az ügynök egyedi neve. Ennek az értéknek meg kell egyeznie az ügynök által használt névvel, amellyel az ügynökvezérlővel regisztrálta magát. Ha ezek az értékek eltérnek, akkor az ügynökhöz érkező név szerinti kérések megváltoztatják az eredményeket attól függően, hogy az ügynök már fut-e vagy nem.
Elem:Interface
Az elem karaktersorozat értéke az ügynök által támogatott felület
neve. Az Ügynök elemben nulla vagy több Felület elem is lehet.
A felület egy egyedi név az ügynök által támogatott parancskészlethez.
- Használó: Agent
Elem:SingleInstance
Az elem integer (egész szám) értéke 0 vagy 1. A 0 (hamis)
azt jelzi, hogy az ügynök több párhuzamosan futó példánnyal is rendelkezhet. Az
1 (igaz) azt jelzi, hogy az ügynökhöz csak egy példány engedélyezett. Ha az
érték 1, akkor az ügynökvezérlő megtagadja az ügynök új példányaihoz érkező kéréseket, ha egy
példány már fut.
Használó: Agent
Elem: Bound
Az elem integer (egész szám) értéke 0 vagy 1. A 0 (hamis)
azt jelzi, hogy az ügynök nincs alkalmazáshoz kötve. Az 1 (igaz) azt jelzi, hogy az
ügynök kötve van egy alkalmazáshoz. Azt az ügynököt, amely kötve van egy
alkalmazáshoz, csak az az adott alkalmazás indíthatja el, ezért az ügynökvezérlő
visszautasítja az ügynök indítását, ha a Bound értéke 1.
Használó: Agent
Elem: MaxControllers
Az elem integer (egész szám) értéke -1, 0 vagy egy pozitív érték. A -1
azt jelzi, hogy "nincs korlát". Az ügynökvezérlő visszautasítja az ügynökhöz küldött
vezérlőjog kéréseket, ha a kérések száma meghaladja ezt az értéket. A vezérlő
jogait az ügynökfejlesztő határozza meg. Az elvárt használat azon
objektumok számának korlátozása, amelyek olyan konfliktusműveleteket kérhetnek, mint például az
adatgyűjtés elindítása és leállítása.
Használó: Agent
Elem: MaxObservers
Az elem integer (egész szám) értéke -1, 0 vagy egy pozitív érték. A -1
azt jelzi, hogy "nincs korlát". Az ügynökvezérlő visszautasítja az ügynökhöz küldött
megfigyelési jog kéréseket, ha a kérések száma meghaladja ezt az értéket. A megfigyelő
jogait az ügynökfejlesztő határozza meg. Az elvárt használat azon
objektumok számának korlátozása, amelyek lekérdezés típusú műveleteket kérnek, mint például
statikus vagy összegyűjtött adatok biztosítása (vezérlő kérésére
például).
Használó: Agent
Elem: ConfigFile
Az elem karaktersorozat értéke meghatározza egy további konfigurációs fájl
teljes elérési útját és fájlnevét, amely az ügynökhöz elérhető dinamikus
konfigurációs információkat tartalmazza. Ez egy elhagyható fájl, a célját és a
tartalmát az ügynökfejlesztő határozza meg. Az elvárt használat, hogy az ügynök
a fájlból beolvassa a saját konfigurációs információit az indításkor vagy egy másik
időpontban.
Használó: Agent
Elem:
LaunchConfiguration
Az ügynök indítási konfigurációs paramétereit azonosítja.
Használó: Agent
Részelemek: launchInfo
Elem:
launchInfo
A befoglalt információk egy végrehajtható fájl indításakor kerülnek felhasználásra.
Használó: LaunchConfiguration
Részelemek: Application
Elem: Application
Ez az Application elem határozza meg az alkalmazás indításához használt
információkat. A végrehajtható fájl
attribútum értéke megadhat egy alkalmazást az álneve alapján (tekintse meg a
ApplicationAliases elemet a serviceconfig.xml fájlban) vagy az indítandó aktuális
végrehajtható fájl útvonalnevét. Az álnevek listájához megfelelő első érték, amelyet
az ügynökvezérlő indításkor a serviceconfig.xml fájlról kérdez le. Ha nem található
egyező érték, akkor az Application elemben tartalmazott indítási információk
kerülnek felhasználásra. Ha található egyezés, akkor az álnévhez meghatározott
indítási információk összekapcsoltan kerülnek felhasználásra az itt meghatározott információkkal, az alább
bemutatottak alapján.
Használó:
LaunchConfiguration
Részelemek: Variable
Parameter
Jellemzők:
- executable
Ez a karaktersorozat érték határozza meg az indítandó alkalmazás nevét. Ez lehet az indítandó aktuális végrehajtható fájl álneve vagy útvonalneve. Ha ez egy álnév, akkor a végrehajtható fájl neve felülírásra kerül az álnévben megadott elérési út értékével.
- location
(elhagyható) Ez a karaktersorozat érték meghatározza a könyvtárat, amelyből a végrehajtható fájlt indítani kell, néha pedig a végrehajtható fájlhoz a futása során munkakönyvtárként kerül felhasználásra. Ha kihagyásra kerül és a végrehajtható fájl nem egyezik meg egy álnévvel sem, akkor az alkalmazás abból a könyvtárból kerül futtatásra, amelyben az ügynökvezérlő található. Ha kihagyásra kerül és a végrehajtható fájl nem egyezik meg egy álnévvel sem, akkor az álnévhez megadott hely kerül felhasználásra.
Elem: Variable
Ez a Variable elem határozza meg a környezeti változót és annak elhelyezési módját a
meglévő környezetben. Ha egy
Application elemben található, akkor módosítja az alkalmazás indításakor használt
környezetet. Egy alkalmazáshoz nulla vagy több ilyen elem is
meghatározható.Ha az alkalmazás
végrehajtható fájl attribútuma adja meg az álnevet, akkor az álnév környezeti változójának
beállításai kerülnek alkalmazásra az alapértelmezett környezethez, majd az itt meghatározott
környezeti változók ezeken felül kerülnek alkalmazásra.
Használó: Application
Jellemzők:
- name
Ez a karaktersorozat érték határozza meg a környezeti változó nevét.
- value
Ez a karaktersorozat érték határozza meg a környezeti változó értékét.
- position
(elhagyható) Ez a karaktersorozat érték az "append", "prepend" vagy a "replace" egyike, amely azt jelzi, hogy hova kell elhelyezni ezt az argumentumot relatívan a meglévő parancssori argumentumokhoz. Ha kihagyja, akkor a változó hozzáfűzésre kerül a környezethez.
Elem: Parameter
A Parameter elem egy az alkalmazás indításakor hozzáadandó
parancssori paramétert határoz meg. Az alkalmazáshoz nulla vagy több ilyen elem is
meghatározható. Ha az alkalmazás
végrehajtható fájl attribútuma egy álnevet határoz meg, akkor az álnév parancssori paraméterei
kerülnek felhasználásra, és az itt meghatározott parancssori paraméterek ezeken felül kerülnek
alkalmazásra.
Használó: Application
Jellemzők:
- value
Ez a karaktersorozat érték határozza meg parancssori paramétert.
- position
(elhagyható) Ez a karaktersorozat érték az "append", "prepend" vagy a "replace" egyike, amely azt jelzi, hogy hova kell elhelyezni ezt az argumentumot relatívan a meglévő parancssori argumentumokhoz. Ha kihagyja, akkor az argumentum hozzáfűzésre kerül a parancssorhoz.
<Agent Name="org.eclipse.tptp.TimeCollector">
<Interface>org.eclipse.tptp.agent</Interface>
<Interface>org.eclipse.tptp.collector</Interface>
<SingleInstance>0</SingleInstance>
<Bound>0</Bound>
<MaxControllers>-1</MaxControllers>
<MaxObservers>-1</MaxObservers>
<ConfigFile>c:\tptp\agents\org.eclipse.tptp.TimeCollector\config\agentconfig.xml</ConfigFile>
<LaunchConfiguration>
<launchInfo>
<Application executable=".\TimeCollector.exe">
<Parameter value="-serviceconfig ..\config\serviceconfig.xml" />
</Application>
</launchInfo>
</LaunchConfiguration>
</Agent>
Kapcsolódó leírás
Ügynök és ügynökvezérlő konfiguráció áttekintése
Copyright (C) 2005, 2006 Intel Corporation.