AMETAS.agentdev
Interface AMETASAgentDriverIf

All Superinterfaces:

AMETASPlaceUserDriverIf

public interface AMETASAgentDriverIf

extends AMETASPlaceUserDriverIf

Schnittstelle zum Agententreiber. Dieses Interface stellt die Schnittstelle eines Agenten zur Stelle dar. Es enthält die Methoden, die nur Agenten zugänglich sind. Alle anderen Methoden befinden sich im Vater-Interface AMETASPlaceUserDriverIf.

Method Summary

java.lang.String	getLastPlace() Liefert die Stelle, an der der Agent zuletzt war.
void	go(java.lang.String sPlaceName) Verschickt den Agenten an die Stelle mit dem symbolischen Namen sPlaceName.
void	go(java.lang.String sPlaceName, long nRelayTime) Verschickt den Agenten an die Stelle mit dem symbolischen Namen sPlaceName.

Methods inherited from interface AMETAS.place.AMETASPlaceUserDriverIf

addPUType, createTypeForString, createTypeForString, deleteMessage, depositMessage, depositMessage, depositRemoteMessage, fullPrivileges, getClass, getDestinationPlace, getDestinationPlace, getFile, getHostName, getLeavingTime, getLeavingTime, getMediatorInfo, getMessages, getMessages, getMessagesAsVector, getMessagesAsVector, getPermissionList, getPlaceName, getPlaceUserID, getPrivileges, getPUTypes, getSecurityFeature, getStarterID, getTypesOf, getTypesOf, idle, killPlaceUser, output, privilegeGranted, registerEventListener, registerEventListener, registerEventListener, registerServiceResponseListener, request, request, requestPUStartup, requestPUStartup, requestService_WaitAndUnregister, requestService_WaitAndUnregister, setSecurityFeature, spawnAgent, stillPresent, stillPresent, stopDriver, stopPlace, suitableForMediator, trace, unknownPrivileges, unregisterEventListener, updateRegistration, useRequestedService, useRequestedService, wakeup

Method Detail

getLastPlace

public java.lang.String getLastPlace()

Liefert die Stelle, an der der Agent zuletzt war.

Returns:

Vollqualifizierter Stellenname

go

public void go(java.lang.String sPlaceName)
        throws MigrationAbortedException,
               NoActiveDestinationException,
               UnknownDestinationException,
               RejectedException,
               AccountExpiredException

Verschickt den Agenten an die Stelle mit dem symbolischen Namen sPlaceName. Der Stellenname wird über den PNS zu einem Rechner mit Adresse aufgelöst, zu der die aktuelle Stelle Verbindung aufnimmt und versucht, den Agenten dorthin zu schicken. Der Agent verbietet das Senden an eine Ersatzstelle.

Parameters:

sPlaceName - Name der Zielstelle des Aufrufers

Throws:

MigrationAbortedException - wenn die Migration abgebrochen wurde (unvorhergesehen)

NoActiveDestinationException - wenn der Agent zu keiner der angegebenen Stellen migrieren kann

RejectedException - wenn die Migration abgelehnt wurde (vorhersehbar, etwa wegen Sicherheitsbedenken)

AccountExpiredException - wenn die Migration nicht bezahlt werden kann

UnknownDestinationException - wenn das Ziel im PNS nicht gefunden wird.

See Also:

AMETASPlaceNameService

go

public void go(java.lang.String sPlaceName,
               long nRelayTime)
        throws MigrationAbortedException,
               NoActiveDestinationException,
               UnknownDestinationException,
               RejectedException,
               AccountExpiredException

Verschickt den Agenten an die Stelle mit dem symbolischen Namen sPlaceName. Der Stellenname wird über den PNS zu einem Rechner mit Adresse aufgelöst, zu der die aktuelle Stelle Verbindung aufnimmt und versucht, den Agenten dorthin zu schicken.

Parameters:

sPlaceName - Name der Zielstelle des Aufrufers

nRelayTime - Zeit in Millisekunden, während welcher der Agent an der Ersatzstelle passiv aufbewahrt werden darf. Danach wird er gestartet. Ist DONT_RELAY oder eine negative Zeit angegeben, verbietet der Agent das Schicken zu einer Ersatzstelle.

Throws:

MigrationAbortedException - wenn die Migration abgebrochen wurde (unvorhergesehen)

NoActiveDestinationException - wenn der Agent zu keiner der angegebenen Stellen migrieren kann

RejectedException - wenn die Migration abgelehnt wurde (vorhersehbar, etwa wegen Sicherheitsbedenken)

AccountExpiredException - wenn die Migration nicht bezahlt werden kann

UnknownDestinationException - wenn das Ziel im PNS nicht gefunden wird.

See Also:

AMETASPlaceNameService