org.jboss.mx.util.AgentID Maven / Gradle / Ivy
/*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt 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 AgentID of an existing MBean server
* instance.
*
* @see javax.management.MBeanServerDelegateMBean
*
* @author Juha Lindfors.
* @version $Revision: 37459 $
*
*/
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
* <ip.address>/<creation time in ms>/<VMID+(random int 0-100)>/<sequence #>.
*
* 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 MBeanServerId 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());
}
}
}