Skip navigation links

com.tangosol.net.management
Interface MBeanServerFinder

public interface MBeanServerFinder

MBeanServerFinder represents a facility that allows a pluggable run-time selection of an MBeanServer to be used by the Coherence JMX framework.

Since:

Coherence 3.6

Author:

gg 2009.06.22

Method Summary

MBeanServer

findMBeanServer(String sDefaultDomain) Find an MBeanServer that should be used by the Coherence JMX framework to register new or locate existing MBeans.

Method Detail

findMBeanServer

MBeanServer findMBeanServer(String sDefaultDomain)

Find an MBeanServer that should be used by the Coherence JMX framework to register new or locate existing MBeans. <p/> Under some circumstances, there could exist more tham one MBeanServer and the default domain name parameter is used to identify which MBeanServer should be returned by this method. <p/> When standard Coherence MBeans are need to be registered with an MBeanServer, this method is passed the value of the "management-config/default-domain-name" element in the operational configuration descriptor (empty string by default). When a platform or custom MBeans are to be queried using the "mbean/mbean-query" configuration element, the value of the "mbean/mbean-server-domain" element is passed as this parameter. <p/> Note: Returning null will result in Coherence using the standard MBeanServer discovery algorithm (see MBeanHelper.findMBeanServer(String)).

Parameters:

sDefaultDomain - the default domain name; empty string indicates that the caller does not have any preferences and MBeanServerFinder could return any MBeanServer it deems fit

Returns:

an existing or new MBeanServer with the specified default domain name (if specified) or null

Skip navigation links