/* * JBoss, Home of Professional Open Source. * Copyright 2008, Red Hat Middleware LLC, and individual contributors * as indicated by the @author tags. See the copyright.txt file in the * distribution for a full listing of individual contributors. * * This is free software; you can redistribute it and/or modify it * under the terms of the GNU Lesser General Public License as * published by the Free Software Foundation; either version 2.1 of * the License, or (at your option) any later version. * * This software is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this software; if not, write to the Free * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA * 02110-1301 USA, or see the FSF site: http://www.fsf.org. */ package org.jboss.mx.util; import java.net.InetAddress; import java.security.AccessController; import java.security.PrivilegedExceptionAction; import java.security.PrivilegedActionException; import java.util.Random; import javax.management.MBeanServer; import javax.management.ObjectName; import EDU.oswego.cs.dl.util.concurrent.SynchronizedLong; import org.jboss.mx.server.ServerConstants; /** * Utility class for creating JMX agent identifiers. Also contains the * helper method for retrieving the <tt>AgentID</tt> of an existing MBean server * instance. * * @see javax.management.MBeanServerDelegateMBean * * @author <a href="mailto:juha@jboss.org">Juha Lindfors</a>. * @version $Revision: 81019 $ * */ public class AgentID implements ServerConstants { // Static ---------------------------------------------------- private static SynchronizedLong id = new SynchronizedLong(0); private static final Random rand = new Random(System.currentTimeMillis()); /** * Creates a new agent ID string. The identifier is of the form * <tt><ip.address>/<creation time in ms>/<VMID+(random int 0-100)>/<sequence #></tt>.<P> * * This AgentID string is globally unique. * * @return Agent ID string */ public static String create() { String ipAddress = null; try { ipAddress = (String) AccessController.doPrivileged( new PrivilegedExceptionAction() { public Object run() throws Exception { return InetAddress.getLocalHost().getHostAddress(); } } ); } catch(PrivilegedActionException e) { ipAddress = "127.0.0.1"; } // use the VMID to create a more unique ID that can be used to guarantee that this // MBeanServerID is unique across multiple JVMs, even on the same host String vmid = new java.rmi.dgc.VMID().toString().replace(':','x').replace('-','X') + rand.nextInt(100); return ipAddress + "/" + System.currentTimeMillis() + "/" + vmid + "/"+ (id.increment()); } /** * test * * @param args */ public static void main (String args[]) { for (int c=0;c<10;c++) System.out.println(AgentID.create()); } /** * Returns the agent identifier string of a given MBean server instance. * * @return <tt>MBeanServerId</tt> attribute of the MBean server delegate. */ public static String get(MBeanServer server) { try { ObjectName name = new ObjectName(MBEAN_SERVER_DELEGATE); String agentID = (String)server.getAttribute(name, "MBeanServerId"); return agentID; } catch (Throwable t) { throw new Error("Cannot find the MBean server delegate: " + t.toString()); } } }