Registrierung

Um ein M-Bean innerhalb eines CMF verwenden zu können, muß dieses registriert werden. Es ist hierbei zu beachten, daß es keinerlei Code innerhalb des M-Bean bedarf, um diesen innerhalb eines CMF zu registrieren. Lediglich ein Manager oder Agent hat den Code zur Registrierung bereitzustellen. Dies bietet die Möglichkeit, temporär Agenten zu erzeugen, um andere Agenten um M-Beans zu erweitern. Unter JDMK bieten sich zwei Möglichkeiten, M-Beans zu registrieren:

• Registrierung einer bestehenden Instanz eines M-Beans
  Diese Operation wird mit der CMF Methode addObject durchgeführt. Es ist zu beachten, daß es sich um eine nichtpersistente Registrierung eines M-Bean handelt. Das bedeutet, daß der M-Bean nur für die Laufzeit des Agenten existiert. Soll der M-Bean dauerhaft dem Agenten zugeordnet werden, so ist die Methode addDBObject zu verwenden. Dauerhaft bedeutet in diesem Zusammenhang, daß das M-Bean bei Verwendung des Repository-Service (siehe Kap. 3.7.1) mit dessen aktuellem Status gespeichert wird. Die Verwendung der beiden Methoden ist nachfolgend zu ersehen.

  // I. nicht persistente Registrierung bestehender M-Beans
  // Irgendeine M-Bean Instanz
  mbeanText = new String("M-Bean (nichtpersistent)");
  
  // Aufbau des Objektbezeichners
  String domain = cmf.getDomain();
  mbeanName = new ObjectName(domain + ":" + mbeanKlasse.ident=1");
  
  //Registrierung des M-Bean im Core Management Framework
  cmf.addobject(mbeanText, mbeanName);
  
  // II. persistente Registrierung bestehender M-Beans
  // Irgendeine M-Bean Instanz
  mbeanText = new String("M-Bean (persistent)");
  
  // Aufbau des Objektbezeichners
  String domain = cmf.getDomain();
  mbeanName = new ObjectName(domain + ":" + mbeanKlasse.ident=1");
  
  //Registrierung des M-Bean im Core Management Framework
  cmf.addDBobject(mbeanText, mbeanName);

• Instantiierung und Registrierung eines M-Beans
  Ist keine Instanz eines M-Bean existent, so ist eine andere CMF Methode zu verwenden. Auch hier werden aufgrund der Persistenz des M-Bean zwei Varianten angeboten:
  • newObject für nicht persistente und
  • newDBObject für persistente Registrierung.
  Für die Instantiierung des M-Beans ermittelt das CMF die Java-Klasse des Beans und lädt sie mittels eines ``Class Loaders'' (vgl. Kapitel 3.7.2). Danach wird die Klasse von dem CMF instantiiert und registriert. Die Registrierung kann auf zwei unterschiedliche Arten geschehen:
  • Verwendung der M-Bean eigenen initCmf Methode
    Hierbei muß darauf geachtet werden, daß die Klassendefinition des M-Bean eine initCmf-Methode zur Verfügung stellt. Wenn die Klasse nun instantiiert wurde, so führt das CMF unter Zuhilfenahme des Metadata-Service (siehe Kap. 3.7.1) die initCmf-Methode des M-Beans aus. Dies bietet die Möglichkeit, bei Instantiierung und Registrierung Aktionen auszuführen, welche sonst auf der Manager-Seite realisiert werden müßten.
  • Verwendung des CMF
    Dieser Fall tritt ein, falls keine initCmf Methode innerhalb der M-Bean Klassendefinition festgelegt wurde. Die Registrierung kann bei dieser Variante jedoch nicht beeinflußt werden.
  Bei Durchführung der Operation addDBObject (bzw. newDBObject) durch das CMF wird zusätzlich eine Methode isPersistent ausgeführt. Diese Methode überprüft, ob eine persistente Speicherung für den Agenten vorgesehen ist. Ist dies nicht der Fall, so wird eine ServiceNotFoundException ausgelöst.