MBeanServerLocator.java |
/*************************************** * * * JBoss: The OpenSource J2EE WebOS * * * * Distributable under LGPL license. * * See terms of license at gnu.org. * * * ***************************************/ package org.jboss.mx.util; import java.util.Iterator; import javax.management.MBeanServer; import javax.management.MBeanServerFactory; /** * A helper class to locate an MBeanServer. * * MBeanServer lookup strategy enhanced to allow the explicit * setting of a particular instance to be returned. This is needed to * allow re-using the jdk5 ManagementFactory.getPlatformMBeanServer() * as our main MBeanServer. The DefaultDomain name of this server cannot * be set, and it seems to be "null" by default (probably a bug). * * @author <a href="mailto:jason@planet57.com">Jason Dillon</a> * @author Scott.Stark@jboss.org * @author <a href="mailto:dimitris@jboss.org">Dimitris Andreadis</a> * @version $Revision: 1.4.6.1 $ */ public class MBeanServerLocator { /** The MBeanServer to return, if set */ private static MBeanServer instance = null; /** * Private CTOR to disable instantiation */ private MBeanServerLocator() { // empty } /** * Optionally set the MBeanServer to be returned * by calls to locateJBoss(). Setting this back * to null reverts to the normal lookup strategy. * * @param server the main jboss MBeanServer or null */ public static void setJBoss(MBeanServer server) { synchronized (MBeanServerLocator.class) { instance = server; } } /** * Returns the first MBeanServer registered under the agentID * * @param agentID the id of the MBeanServer to look for * @return the first MBeanServer with an agentID */ public static MBeanServer locate(final String agentID) { MBeanServer server = (MBeanServer) MBeanServerFactory.findMBeanServer(agentID).iterator().next(); return server; } /** * Returns the first available MBeanServer * * @return the first available MBeanServer */ public static MBeanServer locate() { return locate(null); } /** * Returns the main jboss MBeanServer. * * If there is one set using setJBoss(), it will be returned. * Otherwise the strategy is to return the first MBeanServer * registered under the "jboss" id (or else, default domain name) * * @return the main jboss MBeanServer * @throws IllegalStateException when no MBeanServer can be found */ public static MBeanServer locateJBoss() { synchronized (MBeanServerLocator.class) { if (instance != null) { return instance; } } for (Iterator i = MBeanServerFactory.findMBeanServer(null).iterator(); i.hasNext(); ) { MBeanServer server = (MBeanServer) i.next(); if (server.getDefaultDomain().equals("jboss")) { return server; } } throw new IllegalStateException("No 'jboss' MBeanServer found!"); } }
MBeanServerLocator.java |