Roblet®-Development-Kit
1.3 (11Sep10)
API für Anwendungen

org.roblet
Interface Robot


public interface Robot

Stellt den Kontext eines Roblets® dar und ermöglicht das Erfragen von Einheiten (Unit) eines Roblet®-Servers.  Der Name dieser Schnittstelle ist historisch bedingt - ein Roblet®-Server kann auch ganz allgemeine Dinge, wie Datei-Systeme, Algorithmen u.v.a.m. mit Hilfe von Einheiten darstellen.

Jedem Roblet® wird bei seiner Ausführung eine Instanz dieses Typs übergeben (vgl. Roblet.execute(Robot)).  Es muß sich dabei nicht immer um die gleiche Instanz handeln.

See Also:
getUnit(Class), Roblet, Unit

Method Summary
 Unit getUnit(Class rClass)
          Zu einer Einheitendefinition wird eine zugehörige Instanz zurückgegeben.
 

Method Detail

getUnit

public Unit getUnit(Class rClass)
Zu einer Einheitendefinition wird eine zugehörige Instanz zurückgegeben.

Die Einheitendefinition (vgl. Unit) wird als Klasse übergeben.  Die Klasse bekommt man durch Anhängen von .class.  Z.B.:

 MyUnit.class
 

Man erhält bei Aufruf diese Methode eine Instanz der zugehörigen Einheitenimplementierung zurück.  Da jede Einheitendefinition die Schnittstelle Unit erweitert, paßt der Typ der zurückgegebenen Instanz.

Ein Roblet® muß stets prüfen, ob eine erfragte Einheit im Roblet®-Server auch wirklich vorhanden ist.  Ist dies nämlich nicht der Fall, so wird null zurückgegeben.  Hier ein beispielhafte Verwendung

 public Object  execute (org.roblet.Robot robot)
     throws Exception
 {
     MyUnit  myUnit = (MyUnit) robot. getUnit (MyUnit.class);
     if (myUnit == null)
         throw new Exception ("MyUnit not available");
     // ...
 }
 

Parameters:
rClass - Klasse der Einheitendefinition
Returns:
Instanz der Einheitenimplementierung oder null
See Also:
Roblet

Roblet®-Development-Kit
1.3 (11Sep10)
API für Anwendungen

Copyright © 2001-2010, roblet®.org, Hagen Stanek, http://roblet.org/rdk