Methoden  

Die schon angesprochenen Methodengerüste sind die Folgenden:

• Methode init: Initialisierung einer Datenquelle. Je nach der zugrundeliegenden Struktur und Implementierung werden hierbei die Parameter auf Richtigkeit überprüft (indem eine für die weitere Funktionalität repräsentative Anfrage durchgeführt wird (vgl. SnmpDataProvider)) und/oder die für die Speicherung notwendigen Datenstrukturen werden erstellt.
  • Parameter: s (Source_ID): Eindeutige ID der Datenquelle.
  • Rückgabewert: TimeStamp
• Methode query: Diese Methode fordert ein Datum oder eine Datenreihe von der jeweiligen Datenquelle an.

  Der Benutzer spezifiziert eine Source_ID um den Bezug zu einer Datenquelle herzustellen. Des weiteren muß durch einen Start- und Endezeitpunkt ein Zeitfenster angegeben werden, welches die für die Abfrage relevanten Daten beinhaltet (vgl. Abb. ).

  
  

    

  Abbildung: Query Dialog eines (Snmp)DataProvider

  
  
  • Parameter:
    s (Source_ID): Eindeutige ID der Datenquelle .
    t_start (TimeStamp): Zeitstempel des frühesten gewünschten Datums.
    t_end (TimeStamp): Zeitstempel des spätesten gewünschten Datums.
  • Rückgabewert:
    TimeSeries
• Methode start: Diese dient dem Start einer Datenquelle. D.h. ein solcher Aufruf veranlasst die Datenquelle mit der Aufzeichnung von Informationen zu beginnen und im Erfolgfall einen TimeStamp zurückzuliefern, mit dem Zeitpunkt der Aufzeichnung des ersten Datums.
  • Parameter: s (Source_ID)

    Eindeutige Source_ID der Datenquelle.

  • Rückgabewert: TimeStamp

    Zeitstempel für den Beginn der Datenaufzeichnung.

• Methode stop: Dient zum Stoppen einer Datenquelle.
  • Parameter: s (Source_ID)

    Eindeutige Source_ID der Datenquelle.

• Methode quit: Entspricht einem umgekehrten Initialisierungsvorgang. Es werden bisher gesammelte Daten verworfen und die entsprechenden Strukturen freigegeben. Der Zustand wird wieder auf ,,configured`` gesetzt, was die Bearbeitung der Konfiguration ermöglicht.
  • Parameter: s (Source_ID)

    Eindeutige Source_ID der Datenquelle.

Im Fehlerfall stehen folgende Exceptions zur Disposition:

• AskAnotherException: Die gefragte Datenquelle hat das gewünschte Datum entweder nicht, oder aber es ist - zum Beispiel im Sinne einer dynamischen Lastverteilung - ratsam oder notwendig, eine andere Quelle gleichen Typs zu befragen.

  Hiermit verbunden ist die Rückgabe einer alternativen ID, zur weiteren Befragung. Hierbei handelt es sich jedoch nicht um die Source_ID einer anderen Datenquelle, sondern diejenige eines anderen Agenten.

  Das Modell einer Source_Id erlaubt hierbei die Beziehungen eines Agenten und einer Datenquelle strukturiert abzulegen. Dabei wird die ID einer Datenquelle an die ID eines Agenten angehängt: Lautet beispielsweise die ID eines Agenten de.uni.muc.mnm.cluster01, so könnten dessen Datenquellen IDs nach folgendem Schema haben: de.uni.muc.mnm.cluster01.websever07 oder de.uni.muc.mnm.cluster01.dbms03.

• IDNotSupportedException: Die angegebene Source_Id ist unkorrekt oder wird von der Datenquelle nicht unterstützt.

  Im Zuge der normalen Fehlerbehandlung gibt es hierfür keinen speziellen Rückgabewert.

• IDConfigException: Die angegebene Konfiguration ist unkorrekt. Dies kann auftreten beim Aufruf einer Konfiguration, welche nicht vorhanden ist, oder beim Einfügen einer neuen Konfiguration welche eine schon vorhandene ID verwendet.

  Im Zuge der normalen Fehlerbehandlung gibt es hierfür keinen speziellen Rückgabewert.

Die vom DataProvider implementierten Methoden für das Handling von Kofigurationen sind diese (vgl. Abb. ):

• Methode addConfig: Mit dieser Methode kann eine Konfiguration hinzugefügt werden. Hierbei wird ein neues Element an den Vektor der Konfigurationen angehängt.
  • Parameter: s (Source_ID)

    Eindeutige Source_ID der Datenquelle.

  • Parameter: config (String[])

    String-array der Parameter.

• Methode editConfig: Verändern einer Konfiguration. Es wird die der angegebenen Source_ID entsprechende Konfiguration mit einer neuen, den Parametern entsprechenden, überschrieben.
  • Parameter: s (Source_ID)

    Eindeutige Source_ID der Datenquelle.

  • Parameter: config (String[])

    String-array der Parameter.

• Methode clearConfig: Setzt die Parameter einer Konfiguration auf die vom Subagenten spezifizierten Default-Werte zurück.
  • Parameter: s (Source_ID)

    Eindeutige Source_ID der Datenquelle.

• Methode deleteConfig: Diese Methode löscht nicht mehr benötigte Konfigurationseinträge aus der Tabelle. Das entsprechende Element wird aus dem Vector der Konfigurationen gelöscht.
  • Parameter: s (Source_ID)

    Eindeutige Source_ID der Datenquelle.