Az agent.xml Fájl

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.

Bevezetés

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.

Elemek és jellemzők

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
                            LaunchConfiguration

Jellemző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.

Példa: agent.xml fájl

<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.