Back to index...

	/*
	* Copyright (c) 2002, 2006, Oracle and/or its affiliates. All rights reserved.
	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
	*
	* This code is free software; you can redistribute it and/or modify it
	* under the terms of the GNU General Public License version 2 only, as
	* published by the Free Software Foundation. Oracle designates this
	* particular file as subject to the "Classpath" exception as provided
	* by Oracle in the LICENSE file that accompanied this code.
	*
	* This code 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 General Public License
	* version 2 for more details (a copy is included in the LICENSE file that
	* accompanied this code).
	*
	* You should have received a copy of the GNU General Public License version
	* 2 along with this work; if not, write to the Free Software Foundation,
	* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
	*
	* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
	* or visit www.oracle.com if you need additional information or have any
	* questions.
	*/
	package com.sun.jmx.mbeanserver;

	import java.util.logging.Level;

	import javax.management.Attribute;
	import javax.management.AttributeList;
	import javax.management.AttributeNotFoundException;
	import javax.management.DynamicMBean;
	import javax.management.InvalidAttributeValueException;
	import javax.management.JMRuntimeException;
	import javax.management.MBeanAttributeInfo;
	import javax.management.MBeanException;
	import javax.management.MBeanInfo;
	import javax.management.MBeanRegistration;
	import javax.management.MBeanServer;
	import javax.management.MBeanServerDelegate;
	import javax.management.ObjectName;
	import javax.management.ReflectionException;
	import javax.management.RuntimeOperationsException;

	import static com.sun.jmx.defaults.JmxProperties.MBEANSERVER_LOGGER;

	/**
	* This class is the MBean implementation of the MBeanServerDelegate.
	*
	* @since 1.5
	*/
	final class MBeanServerDelegateImpl
	extends MBeanServerDelegate
	implements DynamicMBean, MBeanRegistration {

	final private static String[] attributeNames = new String[] {
	"MBeanServerId",
	"SpecificationName",
	"SpecificationVersion",
	"SpecificationVendor",
	"ImplementationName",
	"ImplementationVersion",
	"ImplementationVendor"
	};

	private static final MBeanAttributeInfo[] attributeInfos =
	new MBeanAttributeInfo[] {
	new MBeanAttributeInfo("MBeanServerId","java.lang.String",
	"The MBean server agent identification",
	true,false,false),
	new MBeanAttributeInfo("SpecificationName","java.lang.String",
	"The full name of the JMX specification "+
	"implemented by this product.",
	true,false,false),
	new MBeanAttributeInfo("SpecificationVersion","java.lang.String",
	"The version of the JMX specification "+
	"implemented by this product.",
	true,false,false),
	new MBeanAttributeInfo("SpecificationVendor","java.lang.String",
	"The vendor of the JMX specification "+
	"implemented by this product.",
	true,false,false),
	new MBeanAttributeInfo("ImplementationName","java.lang.String",
	"The JMX implementation name "+
	"(the name of this product)",
	true,false,false),
	new MBeanAttributeInfo("ImplementationVersion","java.lang.String",
	"The JMX implementation version "+
	"(the version of this product).",
	true,false,false),
	new MBeanAttributeInfo("ImplementationVendor","java.lang.String",
	"the JMX implementation vendor "+
	"(the vendor of this product).",
	true,false,false)
	};

	private final MBeanInfo delegateInfo;

	public MBeanServerDelegateImpl () {
	super();
	delegateInfo =
	new MBeanInfo("javax.management.MBeanServerDelegate",
	"Represents the MBean server from the management "+
	"point of view.",
	MBeanServerDelegateImpl.attributeInfos, null,
	null,getNotificationInfo());
	}

	final public ObjectName preRegister (MBeanServer server, ObjectName name)
	throws java.lang.Exception {
	if (name == null) return DELEGATE_NAME;
	else return name;
	}

	final public void postRegister (Boolean registrationDone) {
	}

	final public void preDeregister()
	throws java.lang.Exception {
	throw new IllegalArgumentException(
	"The MBeanServerDelegate MBean cannot be unregistered");
	}

	final public void postDeregister() {
	}

	/**
	* Obtains the value of a specific attribute of the MBeanServerDelegate.
	*
	* @param attribute The name of the attribute to be retrieved
	*
	* @return The value of the attribute retrieved.
	*
	* @exception AttributeNotFoundException
	* @exception MBeanException
	* Wraps a <CODE>java.lang.Exception</CODE> thrown by the
	* MBean's getter.
	*/
	public Object getAttribute(String attribute)
	throws AttributeNotFoundException,
	MBeanException, ReflectionException {
	try {
	// attribute must not be null
	//
	if (attribute == null)
	throw new AttributeNotFoundException("null");

	// Extract the requested attribute from file
	//
	if (attribute.equals("MBeanServerId"))
	return getMBeanServerId();
	else if (attribute.equals("SpecificationName"))
	return getSpecificationName();
	else if (attribute.equals("SpecificationVersion"))
	return getSpecificationVersion();
	else if (attribute.equals("SpecificationVendor"))
	return getSpecificationVendor();
	else if (attribute.equals("ImplementationName"))
	return getImplementationName();
	else if (attribute.equals("ImplementationVersion"))
	return getImplementationVersion();
	else if (attribute.equals("ImplementationVendor"))
	return getImplementationVendor();

	// Unknown attribute
	//
	else
	throw new AttributeNotFoundException("null");

	} catch (AttributeNotFoundException x) {
	throw x;
	} catch (JMRuntimeException j) {
	throw j;
	} catch (SecurityException s) {
	throw s;
	} catch (Exception x) {
	throw new MBeanException(x,"Failed to get " + attribute);
	}
	}

	/**
	* This method always fail since all MBeanServerDelegateMBean attributes
	* are read-only.
	*
	* @param attribute The identification of the attribute to
	* be set and the value it is to be set to.
	*
	* @exception AttributeNotFoundException
	*/
	public void setAttribute(Attribute attribute)
	throws AttributeNotFoundException, InvalidAttributeValueException,
	MBeanException, ReflectionException {

	// Now we will always fail:
	// Either because the attribute is null or because it is not
	// accessible (or does not exist).
	//
	final String attname = (attribute==null?null:attribute.getName());
	if (attname == null) {
	final RuntimeException r =
	new IllegalArgumentException("Attribute name cannot be null");
	throw new RuntimeOperationsException(r,
	"Exception occurred trying to invoke the setter on the MBean");
	}

	// This is a hack: we call getAttribute in order to generate an
	// AttributeNotFoundException if the attribute does not exist.
	//
	Object val = getAttribute(attname);

	// If we reach this point, we know that the requested attribute
	// exists. However, since all attributes are read-only, we throw
	// an AttributeNotFoundException.
	//
	throw new AttributeNotFoundException(attname + " not accessible");
	}

	/**
	* Makes it possible to get the values of several attributes of
	* the MBeanServerDelegate.
	*
	* @param attributes A list of the attributes to be retrieved.
	*
	* @return The list of attributes retrieved.
	*
	*/
	public AttributeList getAttributes(String[] attributes) {
	// If attributes is null, the get all attributes.
	//
	final String[] attn = (attributes==null?attributeNames:attributes);

	// Prepare the result list.
	//
	final int len = attn.length;
	final AttributeList list = new AttributeList(len);

	// Get each requested attribute.
	//
	for (int i=0;i<len;i++) {
	try {
	final Attribute a =
	new Attribute(attn[i],getAttribute(attn[i]));
	list.add(a);
	} catch (Exception x) {
	// Skip the attribute that couldn't be obtained.
	//
	if (MBEANSERVER_LOGGER.isLoggable(Level.FINEST)) {
	MBEANSERVER_LOGGER.logp(Level.FINEST,
	MBeanServerDelegateImpl.class.getName(),
	"getAttributes",
	"Attribute " + attn[i] + " not found");
	}
	}
	}

	// Finally return the result.
	//
	return list;
	}

	/**
	* This method always return an empty list since all
	* MBeanServerDelegateMBean attributes are read-only.
	*
	* @param attributes A list of attributes: The identification of the
	* attributes to be set and the values they are to be set to.
	*
	* @return The list of attributes that were set, with their new values.
	* In fact, this method always return an empty list since all
	* MBeanServerDelegateMBean attributes are read-only.
	*/
	public AttributeList setAttributes(AttributeList attributes) {
	return new AttributeList(0);
	}

	/**
	* Always fails since the MBeanServerDelegate MBean has no operation.
	*
	* @param actionName The name of the action to be invoked.
	* @param params An array containing the parameters to be set when the
	* action is invoked.
	* @param signature An array containing the signature of the action.
	*
	* @return The object returned by the action, which represents
	* the result of invoking the action on the MBean specified.
	*
	* @exception MBeanException Wraps a <CODE>java.lang.Exception</CODE>
	* thrown by the MBean's invoked method.
	* @exception ReflectionException Wraps a
	* <CODE>java.lang.Exception</CODE> thrown while trying to invoke
	* the method.
	*/
	public Object invoke(String actionName, Object params[],
	String signature[])
	throws MBeanException, ReflectionException {
	// Check that operation name is not null.
	//
	if (actionName == null) {
	final RuntimeException r =
	new IllegalArgumentException("Operation name cannot be null");
	throw new RuntimeOperationsException(r,
	"Exception occurred trying to invoke the operation on the MBean");
	}

	throw new ReflectionException(
	new NoSuchMethodException(actionName),
	"The operation with name " + actionName +
	" could not be found");
	}

	/**
	* Provides the MBeanInfo describing the MBeanServerDelegate.
	*
	* @return The MBeanInfo describing the MBeanServerDelegate.
	*
	*/
	public MBeanInfo getMBeanInfo() {
	return delegateInfo;
	}

	}

Back to index...