19.6Eine eigene Standard-MBean 
Auf dem Weg zu einer eigenen Bean müssen wir erst aus den MBean-Typen wählen. Da eine Standard-MBean der einfachste Typ ist, wollen wir diesen nutzen und mit der Deklaration der MBean-Schnittstelle beginnen. Sie deklariert Setter/Getter, die später über die JConsole nutzbar sind, und Operationen, die wir ebenfalls über die JConsole anstoßen können.
19.6.1Management-Schnittstelle
Die Management-Schnittstelle im Fall einfacher Standard-MBeans definiert genau die Operationen, die der Client von außen nutzen kann. Der Name der Schnittstelle muss auf MBean enden, oder die Annotation @javax.management.MXBean muss an die Schnittstelle.
Listing 19.7com/tutego/insel/jmx/MazeMBean.java
public interface MazeMBean {
void setMaxNumberOfPlayers( int numberOfPlayers );
int getMaxNumberOfPlayers();
void dragonAlarm();
}
Die Schnittstelle beschreibt einen Irrgarten, der eine maximale Anzahl von Spielern über einfache Setter/Getter erlaubt. Außerdem sollte es möglich sein, von außen die Ankunft eines Drachens zu melden und so ein wenig Aufregung ins Spiel zu bringen.
19.6.2Implementierung der Managed-Ressource
Als Nächstes implementieren wir die Klasse, die die Management-Schnittstelle implementiert. (Eigentlich sollten die Geschäftsobjekte selbst keine MBeans sein, da sie »reine« Objekte sein sollten, ohne Bindung an eine Management-API wie JMX. In unserem kleinen Beispiel ist das jedoch in Ordnung.)
Listing 19.8com/tutego/insel/jmx/Maze.java
public class Maze implements MazeMBean {
private int numberOfPersons;
@Override
public void setMaxNumberOfPlayers( int numberOfPersons ) {
this.numberOfPersons = numberOfPersons;
}
@Override
public int getMaxNumberOfPlayers() {
return numberOfPersons;
}
@Override
public void dragonAlarm() {
System.out.println( "Heul. Huhuhuhu." );
}
}
19.6.3Anmeldung beim Server
Der letzte Teil ist der Server, der die MBean anmeldet. Die statische Methode ManagementFactory.getPlatformMBeanServer() liefert den vordefinierten Standardserver für Managed Beans. Unter einem ObjectName können wir dann eigene MBeans registrieren:
Listing 19.9com/tutego/insel/jmx/RegisterMazeMBean.java, main()
ObjectName name = new ObjectName( "com.tutego.insel.jmx:type=Maze" );
MazeMBean maze = new Maze();
server.registerMBean( maze, name );
JOptionPane.showMessageDialog( null, "Ende" );
System.exit( 0 );
19.6.4Eine eigene Bean in JConsole einbringen
Starten wir RegisterMazeMBean, zeigt die JConsole unser Programm an. Wir können einen Blick auf den Reiter MBeans werfen (siehe Abbildung 19.3). Dort lässt sich die Property MaxNumberOfPlayers einsehen und ändern. Zusätzlich lässt sich unsere Operation anstoßen, die dann auf der Konsole die gewünschte Ausgabe ergibt. Es ist schon erstaunlich, welche Möglichkeiten es für die Administration gibt, wenn die JConsole ein Remote-Programm überwacht und steuert.
Zur Anbindung an den JMX-Server dient nicht nur die JConsole, sondern es sind verschiedene andere Wege denkbar, etwa über HTTP oder über einen eigenen Client, der über RMI kommuniziert.
Abbildung 19.3Infos zu MaxNumberOfPlayers einsehen und ändern
JMXConnectorServer für den Server *
Für die Veröffentlichung der MBeans über RMI ist der JMXConnectorServer verantwortlich. Damit die MBeans an die RMI-Registry gebunden werden, wird eine besondere URL verwendet, die den Service genau beschreibt. Die JMXService-URL hat den allgemeinen Aufbau:
Vor dem Start des Programms muss die RMI-Registry für Anmeldungen bereit sein; da unser Programm auf dem gleichen Rechner arbeitet, starten wir den RMI-Namensdienst selbst:
Listing 19.10com/tutego/insel/jmx/RmiJMXConnectorServerDemo.java, main()
MBeanServer server = ManagementFactory.getPlatformMBeanServer();
String url = "service:jmx:rmi:///jndi/rmi://localhost/maze";
JMXConnectorServer connectorServer = JMXConnectorServerFactory.newJMXConnectorServer(
new JMXServiceURL( url ), null, server );
connectorServer.start();
ObjectName name = new ObjectName( "com.tutego.insel.jmx:type=Maze" );
MazeMBean maze = new Maze();
server.registerMBean( maze, name );
JOptionPane.showMessageDialog( null, "Ende" );
System.exit( 0 );
JConsole mit Remote-Connection *
Mit der JConsole könnten wir nun Verbindung aufnehmen, indem wir unter Remote Connection die URL service:jmx:rmi:///jndi/rmi://localhost/maze einsetzen (siehe Abbildung 19.4).
JMXConnector für den Client *
Auf der Client-Seite gibt es mit JMXConnector den Gegenspieler zum JMXConnectorServer. Der JMXConnector gibt uns mit getMBeanServerConnection() ein MBeanServerConnection-Objekt, das in gewisser Weise der Repräsentation des MBean-Servers MBeanServer auf der anderen Seite entspricht (genau genommen gilt für die Schnittstellen: MBeanServer extends MBeanServerConnection). Über getAttribute(…) lassen sich dann zum Beispiel Properties erfragen:
Listing 19.11com/tutego/insel/jmx/RmiJMXConnectorDemo.java, main()
JMXServiceURL u = new JMXServiceURL( url );
try ( JMXConnector c = JMXConnectorFactory.connect( u ) ) {
MBeanServerConnection mbsc = c.getMBeanServerConnection();
ObjectName name = new ObjectName( "com.tutego.insel.jmx:type=Maze" );
System.out.println( mbsc.getAttribute( name, "MaxNumberOfPlayers" ) );
}
Abbildung 19.4Verbindung mit der JConsole herstellen
