Agent.xml-tiedosto

Huomautus

Näissä ohjeissa olevissa tiedosto- ja hakemistosijaintien viittauksissa <install-home> on hakemisto, johon agentin ohjaimen paketti on purettu.

Johdanto

Agentin aloituksen kokoonpanotiedosto (agent.xml) sisältää kiinteitä tietoja, joita agentin ohjain tarvitsee agentin aloituksessa ja hallinnassa. Näitä kiinteitä tietoja ovat muun muassa seuraavat tiedot:

Agent.xml-tiedoston on oltava agenttia varten nimetyn hakemiston alihakemistossa. Agentille nimetyn hakemiston on oltava serviceconfig.xml-tiedoston Agent-elementissä määritetyssä hakemistossa. Jos agentin nimi on esimerkiksi org.eclipse.tptp.TimeCollector, kokoonpanotiedoston hakemisto on <install-home>/agents/org.eclipse.tptp.TimeCollector/agent.xml. Agentin ohjain tunnistaa nimellä pyydetyt agentit hakemiston nimen perusteella. Agent.xml-kokoonpanotiedoston sisältämät tiedot ovat agentin metatietoja.

Huomaa, että agentin ohjain lukee kaikkien agenttien agent.xml-tiedostot vain kerran, oman aloituksensa aikana. Jos muokkaat näitä tiedostoja tai lisäät uusia agenttihakemistoja, muutokset tulevat voimaan vasta, kun aloitat agentin ohjaimen uudelleen.

Elementit ja määritteet

Elementti: Agent
Tämä on agentin kokoonpanotiedoston juurielementti. Se määrittää agentin metatiedot. Objekti voi pyytää agentin metatietoja ja käyttää niitä vapaasti. Agentin ohjain käyttää alla lueteltuja alielementtejä agentin aloituksessa ja hallinnassa. Agentin sovelluskehittäjät voivat määrittää muita alielementtejä halutessaan määrittää lisää metatietoina palautettavia tietoja. Työasemaohjelmat, jotka tekevät päätöksen tehtävässä käytettävästä agentista ajonaikaisesti, voivat käyttää metatietoja.

Alielementit:     Interface
                            SingleInstance
                            Bound
                            MaxControllers
                            MaxObservers
                            ConfigFile
                            LaunchConfiguration

Määritteet:

Name
Tämä merkkijonomuotoinen arvo on agentin yksilöllinen nimi. Tämän arvon pitäisi olla sama, jota agentti käyttää agentin ohjaimeen rekisteröityessään. Jos nämä arvot ovat erilaiset, nimen perusteella tehdyt agentin pyynnöt toimivat eri lailla sen mukaan, onko agentti jo ajossa vai ei.

Elementti:Interface
Tämän elementin merkkijonomuotoinen arvo on sen rajapinnan nimi, jota tämä agentti tukee. Interface-elementti ei ole pakollinen Agent-elementissä, mutta niitä voi määrittää halutun määrän. Rajapinta on yksilöllinen nimi sille komentojoukolle, jota agentti tukee.

Käyttöelementti:       Agent

Elementti:SingleInstance
Tämän elementin kokonaislukumuotoinen arvo voi olla joko 0 tai 1. Arvo 0 (epätosi) määrittää, että tästä agentista voi olla ajossa useita ilmentymiä samanaikaisesti. Arvo 1 (tosi) määrittää, että tästä agentista voi olla ajossa vain yksi ilmentymä. Jos arvo on 1, agentin ohjain hylkää kaikki agentin uudet ilmentymäpyynnöt, jos yksi agentin ilmentymä on jo ajossa.

Käyttöelementti:       Agent

Elementti: Bound
Tämän elementin kokonaislukumuotoinen arvo voi olla joko 0 tai 1. Arvo 0 (epätosi) määrittää, ettei tätä agenttia ole sidottu sovellukseen. Arvo (tosi) määrittää, että agentti on sidottu sovellukseen. Sovellukseen sidotun agentin voi aloittaa vain kyseinen sovellus, joten agentin ohjain ei hyväksy agentin aloituspyyntöä, jos sen Bound-arvo on 1.

Käyttöelementti:       Agent

Elementti: MaxControllers
Tämän elementin kokonaislukumuotoinen arvo voi olla joko -1, 0 tai jokin positiivinen arvo. Arvo -1 määrittää, ettei rajoituksia ole. Agentin ohjain hylkää tämän agentin hallintaoikeuksien myöntöpyynnöt, jos pyyntöjen määrä ylittää tämän arvon. Agentin sovelluskehittäjä määrittää hallintaoikeudet. Tätä elementtiä on tarkoitettu käytettäväksi niiden objektien määrän rajoittamiseen, jotka voivat tehdä ristiriitaisia toimintopyyntöjä (esimerkiksi tietokokoelman aloitus- ja lopetuspyyntöjä).

Käyttöelementti:       Agent

Elementti: MaxObservers
Tämän elementin kokonaislukumuotoinen arvo voi olla joko -1, 0 tai jokin positiivinen arvo. Arvo -1 määrittää, ettei rajoituksia ole. Agentin ohjain hylkää tämän agentin tarkkailuoikeuksien myöntöpyynnöt, jos pyyntöjen määrä ylittää tämän arvon. Agentin sovelluskehittäjä määrittää tarkkailuoikeudet. Tätä elementtiä on tarkoitettu käytettäväksi niiden objektien määrän rajoittamiseen, jotka voivat pyytää kyselyjen kaltaisia toimintopyyntöjä, kuten staattisten tai kerättävien tietojen selvityspyyntöjä (esimerkiksi ohjaimen pyynnön täyttämiseksi).

Käyttöelementti:       Agent

Elementti: ConfigFile
Tämän elementin merkkijonomuotoinen arvo määrittää sen lisäkokoonpanotiedoston täydellisen polun ja tiedostonimen, joka sisältää dynaamiset kokoonpanotiedostot. Tämä lisätiedosto on valinnainen tiedosto, jonka käyttötavan ja sisällön agentin sovelluskehittäjä määrittää. Tämä elementti on tarkoitettu käytettäväksi siihen, että agentti voi lukea omat kokoonpanotietonsa tästä tiedostosta joko aloituksen aikana tai muulloin.

Käyttöelementti:       Agent

Elementti: LaunchConfiguration
Tämä elementti määrittää tämän agentin aloituskokoonpanon parametrit.

Käyttöelementti:       Agent
                   
Alielementit:     launchInfo
 

Elementti: launchInfo
Tämä elementti sisältää ohjelmatiedoston aloituksessa käytettävät tiedot.

Käyttöelementti:       LaunchConfiguration

Alielementit:     Application

Elementti: Application
Application-elementti määrittää sovelluksen aloituksessa käytettävät tiedot. Sen executable-määritteen arvo määrittää joko sovelluksen valenimen (katso serviceconfig.xml-tiedoston ApplicationAliases-elementin kuvaus) tai varsinaisen aloitettavan ohjelmatiedoston polun nimen. Järjestelmä etsii ensin arvolle vastinetta serviceconfig.xml-tiedostosta, kun agentin ohjain aloitetaan. Jos vastinetta ei löydy, järjestelmä käyttää Application-elementin aloitustietoja sellaisenaan. Jos vastine löytyy, järjestelmä käyttää tälle valenimelle määritettyjä aloitustietoja tässä elementissä määritettyjen tietojen kanssa alla kuvatulla tavalla.

Käyttöelementti:       LaunchConfiguration
                   
Alielementit:     Variable
                            Parameter                          

Määritteet:

executable

Tämä merkkijonomuotoinen arvo määrittää aloitettavan sovelluksen nimen. Se voi olla joko valenimi tai varsinaisen aloitettavan ohjelmatiedoston polun nimi. Jos arvo on valenimi, ohjelmatiedoston nimi korvautuu kyseiselle valenimelle määritetyllä polun nimellä.

location

(Valinnainen) Tämä merkkijonomuotoinen arvo määrittää hakemiston, josta ohjelmatiedosto aloitetaan. Tätä hakemistoa kutsutaan joissakin tilanteissa ohjelmatiedoston työhakemistoksi, kun ohjelmatiedosto on ajossa. Jos tätä määritettä ei ole määritetty eikä ohjelmatiedostoa vastaavaa valenimeä löydy, järjestelmä ajaa sovelluksen agentin ohjaimen hakemistosta. Jos tätä määritettä ei ole määritetty mutta ohjelmatiedostoa vastaava valenimi löytyy, järjestelmä käyttää valenimelle määritettyä sijaintia.

Elementti: Variable
Tämä Variable-elementti määrittää ympäristömuuttujan ja sen, miten se on sijoitettava käytössä olevaan ympäristöön. Application-elementissä tämä elementti muuttaa sovelluksen aloituksessa käytettävää ympäristöä. Voit määrittää näitä elementtejä haluamasi määrän Application-elementtiin. Jos Application-elementin executable-määritteen arvona on valenimi, järjestelmä lisää oletusympäristöön valenimen mukaiset ympäristömuuttujien asetukset ja tässä määritetyt ympäristömuuttujat.

Käyttöelementti:     Application

Määritteet:

name

Tämä merkkijonomuotoinen arvo määrittää ympäristömuuttujan nimen.

value

Tämä merkkijonomuotoinen arvo määrittää ympäristömuuttujan arvon.

position

(Valinnainen) Tämä merkkijonomuotoinen arvo, joka voi olla "append" (liitä loppuun), "prepend" (liitä alkuun) tai "replace" (korvaa), määrittää, mihin tämä ympäristömuuttuja sijoitetaan suhteessa käytössä olevaan ympäristöön. Jos tätä arvoa ei ole määritetty, järjestelmä liittää muuttujan ympäristön loppuun.

Elementti: Parameter
Parameter-elementti määrittää aloitettavaan sovellukseen välitettävän komentorivin argumentin. Voit määrittää näitä elementtejä haluamasi määrän Application-elementtiin. Jos Application-elementin executable-määritteen arvona on valenimi, järjestelmä käyttää valenimen mukaisia komentorivin argumentteja ja lisää niihin tässä määritetyt komentorivin argumentit.

Käyttöelementti:     Application

Määritteet:

value

Tämä merkkijonomuotoinen arvo määrittää komentorivin argumentin.

position

(Valinnainen) Tämä merkkijonomuotoinen arvo, joka voi olla  "append" (liitä loppuun), "prepend" (liitä alkuun) tai "replace" (korvaa), määrittää, mihin tämä argumentti sijoitetaan suhteessa aiemmin määritettyihin komentorivin argumentteihin. Jos tätä arvoa ei ole määritetty, järjestelmä liittää argumentin komentorivin loppuun.

Agent.xml-esimerkkitiedosto

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


Aiheeseen liittyviä ohjeita

Agentin ja agentin ohjaimen yleiskuvaukset


Copyright (C) 2005, 2006 Intel Corporation.