weblogic.management.mbeanservers
Interface MBeanTypeService

public interface MBeanTypeService

Provides operations for discovering the attributes and operations of an MBean type that has not yet been instantiated.

The javax.management.ObjectName of this MBean is "com.bea:Name=MBeanTypeService,Type=weblogic.management.mbeanservers.MBeanTypeService".

OBJECT_NAME

static final String OBJECT_NAME

This is the ObjectName under which this service is registered in the MBeanServer

getMBeanInfo

ModelMBeanInfo getMBeanInfo(String beanInterface)
                            throws OperationsException

Returns the MBean info object for the specified interface.

For example,
MBeanServerConnection.invoke(MBeanTypeServiceMBean, "getMBeanInfo",
new Object[] { "weblogic.security.providers.authorization.DefaultAuthorizationProviderMBean" }
new String[] { "java.lang.String" });

Parameters:

beanInterface - The fully-qualified interface name of the MBean.

Returns:

The javax.management.modelmbean.ModelMBeanInfo object for the specified interface

Throws:

OperationsException

getSubtypes

String[] getSubtypes(String baseInterface)

Returns the names of all MBean types that extend or implement the specified MBean.

Parameters:

baseInterface - The fully-qualified interface name of the base MBean.

Returns:

A java.lang.String[] array

validateAttribute

void validateAttribute(String beanInterface,
                       Attribute attribute)
                       throws AttributeNotFoundException,
                              InvalidAttributeValueException,
                              MBeanException,
                              ReflectionException

Validates that the specified attribute value complies with the contraints for that attribute.

This operation evaluates the following types of constraints:

• If the value you specify falls within an allowed minimum or maximum range.
• If the value you specify is one of a set of enumerated allowed values.
• If you pass a null value, this operation evaluates whether the attribute is allowed to contain a null value.

There are two signatures for this operation. One takes the interface name of an MBean type and the other takes the javax.management.ObjectName of an MBean instance.

Parameters:

beanInterface - The fully-qualified interface name of the MBean that contains the attribute.

attribute - The name of the attribute and a proposed value.

Throws:

AttributeNotFoundException - if the attribute is not specified for the interface.

InvalidAttributeValueException - if the value violates any of the constraints

MBeanException - if the interface is not recognized.

ReflectionException - if the attribute type or the bean interface cannot be loaded.

validateAttributes

AttributeList validateAttributes(String beanInterface,
                                 AttributeList attributes)
                                 throws MBeanException,
                                        ReflectionException

Validates a set of attributes with a single invocation.

If all of the attribute values are valid, this operation returns an empty AttributeList. For each invalid attribute value, operation stores an exception the AttributeList that is returned.

There are two signatures for this operation. One takes the interface name of an MBean type and the other takes the javax.management.ObjectName of an MBean instance.

Parameters:

beanInterface - The fully-qualified interface name of the MBean that contains the attributes.

attributes - The names of the attributes and proposed values.

Returns:

an AttributList that contains an entry for each invalid attribute value.

Throws:

MBeanException - if the interface is not recognized.

ReflectionException - if the attribute type or the bean interface cannot be loaded.

See Also:

MBeanTypeService.validateAttribute(java.lang.String, javax.management.Attribute)

validateAttribute

void validateAttribute(ObjectName beanInstance,
                       Attribute attribute)
                       throws AttributeNotFoundException,
                              InvalidAttributeValueException,
                              MBeanException,
                              ReflectionException

Validates that the specified attribute value complies with the contraints for that attribute.

This operation evaluates the following types of constraints:

• If the value you specify falls within an allowed minimum or maximum range.
• If the value you specify is one of a set of enumerated allowed values.
• If you pass a null value, this operation evaluates whether the attribute is allowed to contain a null value.

There are two signatures for this operation. One takes the interface name of an MBean type and the other takes the javax.management.ObjectName of an MBean instance.

Parameters:

beanInstance - An MBean instance.

attribute - The name of the attribute and a proposed value.

Throws:

AttributeNotFoundException - if the attribute is not specified for the interface.

InvalidAttributeValueException - if the value violates any of the constraints

MBeanException - if the interface is not recognized.

ReflectionException - if the attribute type or the bean interface cannot be loaded.

validateAttributes

AttributeList validateAttributes(ObjectName beanInstance,
                                 AttributeList attributes)
                                 throws MBeanException,
                                        ReflectionException

Validates a set of attributes with a single invocation.

If all of the attribute values are valid, this operation returns an empty AttributeList. For each invalid attribute value, operation stores an exception the AttributeList that is returned.

There are two signatures for this operation. One takes the interface name of an MBean type and the other takes the javax.management.ObjectName of an MBean instance.

Parameters:

beanInstance - An MBean instance.

attributes - the names of the attributes and a proposed values.

Throws:

MBeanException - if the interface is not recognized.

ReflectionException - if the attribute type or the bean interface cannot be loaded.

See Also:

MBeanTypeService.validateAttributes(String beanInterface, AttributeList)