org.springframework.jmx.export.assembler
Class InterfaceBasedMBeanInfoAssembler

java.lang.Object
  extended by org.springframework.jmx.export.assembler.AbstractMBeanInfoAssembler
      extended by org.springframework.jmx.export.assembler.AbstractReflectiveMBeanInfoAssembler
          extended by org.springframework.jmx.export.assembler.InterfaceBasedMBeanInfoAssembler
All Implemented Interfaces:
MBeanInfoAssembler

public class InterfaceBasedMBeanInfoAssembler
extends AbstractReflectiveMBeanInfoAssembler

Subclass of AbstractReflectiveMBeanInfoAssembler that allows for the management interface of a bean to be defined using arbitrary interfaces. Any methods or properties that are defined in those interfaces are exposed as MBean operations and attributes.

By default, this class votes on the inclusion of each operation or attribute based on the interfaces implemented by the bean class. However, you can supply an array of interfaces via the managedInterfaces property that will be used instead. If you have multiple beans and you wish each bean to use a different set of interfaces, then you can map bean keys (that is the name used to pass the bean to the MBeanExporter) to a list of interface names using the interfaceMappings property.

If you specify values for both interfaceMappings and managedInterfaces, Spring will attempt to find interfaces in the mappings first. If no interfaces for the bean are found, it will use the interfaces defined by managedInterfaces.

Since:
1.2
Author:
Rob Harrop, Juergen Hoeller
See Also:
setManagedInterfaces(java.lang.Class[]), setInterfaceMappings(java.util.Properties), MethodNameBasedMBeanInfoAssembler, SimpleReflectiveMBeanInfoAssembler, MBeanExporter

Field Summary
 
Fields inherited from class org.springframework.jmx.export.assembler.AbstractReflectiveMBeanInfoAssembler
ATTRIBUTE_OPERATION_VISIBILITY, FIELD_CLASS, FIELD_CURRENCY_TIME_LIMIT, FIELD_DEFAULT, FIELD_GET_METHOD, FIELD_LOG, FIELD_LOG_FILE, FIELD_PERSIST_LOCATION, FIELD_PERSIST_NAME, FIELD_PERSIST_PERIOD, FIELD_PERSIST_POLICY, FIELD_ROLE, FIELD_SET_METHOD, FIELD_VISIBILITY, ROLE_GETTER, ROLE_OPERATION, ROLE_SETTER
 
Constructor Summary
InterfaceBasedMBeanInfoAssembler()
           
 
Method Summary
protected  boolean includeOperation(Method method, String beanKey)
          Check to see if the Method is declared in one of the configured interfaces and that it is public.
protected  boolean includeReadAttribute(Method method, String beanKey)
          Check to see if the Method is declared in one of the configured interfaces and that it is public.
protected  boolean includeWriteAttribute(Method method, String beanKey)
          Check to see if the Method is declared in one of the configured interfaces and that it is public.
 void setInterfaceMappings(Properties mappings)
          Set the mappings of bean keys to a comma-separated list of interface names.
 void setManagedInterfaces(Class[] managedInterfaces)
          Set the array of interfaces to use for creating the management info.
 
Methods inherited from class org.springframework.jmx.export.assembler.AbstractReflectiveMBeanInfoAssembler
applyCurrencyTimeLimit, applyDefaultCurrencyTimeLimit, createModelMBeanOperationInfo, getAttributeDescription, getAttributeInfo, getClassForDescriptor, getDefaultCurrencyTimeLimit, getOperationDescription, getOperationInfo, getOperationParameters, isExposeClassDescriptor, isUseStrictCasing, populateAttributeDescriptor, populateMBeanDescriptor, populateOperationDescriptor, setDefaultCurrencyTimeLimit, setExposeClassDescriptor, setUseStrictCasing
 
Methods inherited from class org.springframework.jmx.export.assembler.AbstractMBeanInfoAssembler
checkManagedBean, getClassName, getClassToExpose, getClassToExpose, getConstructorInfo, getDescription, getMBeanInfo, getNotificationInfo, getTargetClass
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

InterfaceBasedMBeanInfoAssembler

public InterfaceBasedMBeanInfoAssembler()
Method Detail

setManagedInterfaces

public void setManagedInterfaces(Class[] managedInterfaces)
Set the array of interfaces to use for creating the management info. These interfaces will be used for a bean if no entry corresponding to that bean is found in the interfaceMappings property.

Parameters:
managedInterfaces - an array of classes indicating the interfaces to use. Each entry MUST be an interface.
See Also:
setInterfaceMappings(java.util.Properties)

setInterfaceMappings

public void setInterfaceMappings(Properties mappings)
Set the mappings of bean keys to a comma-separated list of interface names. The property key should match the bean key and the property value should match the list of interface names. When searching for interfaces for a bean, Spring will check these mappings first.

Parameters:
mappings - the mappins of bean keys to interface names

includeReadAttribute

protected boolean includeReadAttribute(Method method,
                                       String beanKey)
Check to see if the Method is declared in one of the configured interfaces and that it is public.

Specified by:
includeReadAttribute in class AbstractReflectiveMBeanInfoAssembler
Parameters:
method - the accessor Method.
beanKey - the key associated with the MBean in the beans Map.
Returns:
true if the Method is declared in one of the configured interfaces, otherwise false.

includeWriteAttribute

protected boolean includeWriteAttribute(Method method,
                                        String beanKey)
Check to see if the Method is declared in one of the configured interfaces and that it is public.

Specified by:
includeWriteAttribute in class AbstractReflectiveMBeanInfoAssembler
Parameters:
method - the mutator Method.
beanKey - the key associated with the MBean in the beans Map.
Returns:
true if the Method is declared in one of the configured interfaces, otherwise false.

includeOperation

protected boolean includeOperation(Method method,
                                   String beanKey)
Check to see if the Method is declared in one of the configured interfaces and that it is public.

Specified by:
includeOperation in class AbstractReflectiveMBeanInfoAssembler
Parameters:
method - the operation Method.
beanKey - the key associated with the MBean in the beans Map.
Returns:
true if the Method is declared in one of the configured interfaces, otherwise false.


Copyright (c) 2002-2007 The Spring Framework Project.