Komunikácia agenta s test frameworkom

Späť na Návod

Základy

Test framework beží ako server (štandardne na porte 8000), ku ktorému sa majú pripájať agenti. Na tomto spojení získava test framework od agenta správy o jeho stave, toto spojenie teda slúži ako akýsi monitor agenta. Toto slovné spojenie budem používať pre označenie tohto spojenia. Táto komunikácia je jednosmerná, tzn. agent správy len odosiela a test framework ich len prijíma.

Ďalšie spojenie medzi agentom a serverom je (nepovinný) TFTP server bežiaci na strane agenta. K tomuto sa pripája test framework a využíva ho na ovládanie agenta. Ak test framework pošle agentovi cez toto spojenie súbor s názvom ruby.exec, agent vykoná ruby kód obsiahnutý v tomto súbore.

Monitor agenta

Server (TestFramework)

Tento server je implementovaný triedou AgentMonitor (podobne ako u monitora robocup serveru týchto inštancií môže byť viacero, no v lokálnej implementácii sa používa vždu len jedna), ktorá sa stará o prijímanie nových spojení od agentov. Každé jedno takéto spojenie je reprezentované triedou AgentMonitorThread, ktorá má na starosti spracovanie správ prichádzajúcich od agenta pomocou triedy AgentMonitorMessage. V súčasnosti môžu existovať 4 rôzne typy takýchto správ:

• INIT - posiela agent pri pripojení, obsahuje jeho číslo, názov tímu a stranu na ktorej hrá, takisto či má hráč zapnutý TFTP server a na ktorom porte
• DESTROY - posiela agent pri odpojení
• HIGHSKILL - informuje test framework o začatí/skončení high skillu, obsahuje meno high skillu a čas kedy k akcii došlo
• WORLDMODEL - posiela model sveta agenta do test frameworku

Okrem tohoto "automatického" spracovania príchodzých správ ich môžu ďalej odchytávať a spracovávať iné triedy pomocou listeneru IAgentMonitorListener, ktorý sa registruje v triede AgentMonitor jednou z metód setMessageListener, buď len pre konkrétneho agenta, alebo pre všetkých. Tiež je možné registrovať len určité typy správ kombinované pomocou bitového OR operátora.

Klient (Jim)

Na komunikáciu s test frameworkom slúži v agentovi trieda TestFrameworkCommunication. V súčasnosti je implementovaná tak, že sa neinicializuje niekde na začiatku, ale až pri odoslaní prvej správy k test frameworku. Keďže test framework v prvej správe od agenta potrebuje mať uvedenú stranu na ktorej agent hrá, môže sa komunikácia začať až po tom ako agent dostal túto informáciu zo servera. To je uložené v AgentInfo.hasAssignedSide. Pri volaní niektorej z komunikačných metód v triede TestFrameworkCommunication skôr, agent túto komunikáciu jednoducho ignoruje.

Posielané správy sú reprezentované triedou Message. Typy správ sú rovnaké aké boli uvedené v predchádzajúcej sekcii.

TFTP - vykonávanie ruby príkazov zadávaných test frameworkom na strane agenta

TFTP server (Jim)

Celá logika, vrátanie špeciálneho spracovania súboru s názvom ruby.exec je implementovaná v triede TFTPServer. Jednoducho sa z kódu vytvorí Script objekt, ktorý sa vykoná.

TFTP klient (TestFramework)

Používané ruby príkazy sa nachádzajú v metódach ktorých názov začína na invoke v triede AgentJim.