compact3

javax.management

Interface MBeanRegistration

所有已知实现类：

CounterMonitor， GaugeMonitor， JMXConnectorServer， MLet， Monitor， PrivateMLet， RelationService， RelationSupport， RequiredModelMBean， RMIConnectorServer， StandardEmitterMBean， StandardMBean， StringMonitor， Timer

public interface MBeanRegistration

可以通过为MBean来进行操作之前，注册或未注册的MBean服务器后。MBean还可以实现此接口，以在MBean服务器得到一个参考的MBean服务器和/或它的名字。

从以下版本开始：

一点五

方法摘要

Modifier and Type	Method and Description
void	postDeregister() 允许MBean执行任何操作在MBean服务器被注册后需要。
void	postRegister(Boolean registrationDone) 允许MBean执行任何操作在MBean服务器或注册后不需要注册后。
void	preDeregister() 允许MBean执行任何需要的操作之前被注册的MBean服务器。
ObjectName	preRegister(MBeanServer server, ObjectName name) 允许MBean执行任何操作之前，它需要在MBean服务器注册。

方法详细信息

preRegister

ObjectName preRegister(MBeanServer server,
                       ObjectName name)
                throws 异常

允许MBean执行任何操作之前，它需要在MBean服务器注册。如果未指定的MBean的名字，MBean可以登记为其提供一个名称。如果有异常抛出，MBean将不会在MBean服务器注册。

参数

server的MBean服务器中，MBean将注册。

name - MBean对象名称。如果Name参数中的一个 MBeanServer接口 createMBean或 registerMBean方法是零这个名字是空的。在这种情况下，该方法必须返回一个非空的新的MBean对象。

结果

的名义下，MBean是注册。此值不能为空。如果 name参数不为空，它通常但不返回值。

异常

异常这个例外将被重新抛出的MBean服务器作为一个 MBeanRegistrationException。

postRegister

void postRegister(Boolean registrationDone)

允许MBean执行任何操作在MBean服务器或注册后不需要注册后。

如果执行此方法抛出一个RuntimeException或Error MBean服务器对象，将里面的人RuntimeMBeanException或RuntimeErrorException，分别。然而，在postRegister抛出异常并不会改变MBean的状态：如果MBean已经注册（registrationDone是true），MBean将保持注册。

这可能是混乱的代码调用createMBean()或registerMBean()，这样的代码可能会认为MBean注册失败时抛出一个异常。因此建议实现postRegister不抛出运行时异常或错误，如果它是可以避免的。

参数

registrationDone -指示是否MBean已在MBean服务器注册成功。价值错误意味着注册阶段已经失败。

preDeregister

void preDeregister()
            throws 异常

允许MBean执行任何需要的操作之前被注册的MBean服务器。

异常

异常这个例外将被重新抛出的MBean服务器作为一个 MBeanRegistrationException。

postDeregister

void postDeregister()

允许MBean执行任何操作在MBean服务器被注册后需要。

如果执行此方法抛出一个RuntimeException或Error MBean服务器对象，将里面的人RuntimeMBeanException或RuntimeErrorException，分别。然而，在postDeregister抛出异常并不会改变MBean状态：MBean已成功注销，今后仍将如此。

这可能是混乱的代码调用unregisterMBean()，它可能认为MBean deregistration已经失败了。因此建议实现postDeregister不抛出运行时异常或错误，如果它是可以避免的。