javax.management

Интерфейсный MBeanRegistration

Все Известные Классы с реализацией:

CounterMonitor, GaugeMonitor, JMXConnectorServer, MLet, Монитор, PrivateMLet, RelationService, RelationSupport, RequiredModelMBean, RMIConnectorServer, StandardEmitterMBean, StandardMBean, StringMonitor, Таймер

public interface MBeanRegistration

Может быть реализован MBean, чтобы выполнить операции прежде и будучи зарегистрированным или незарегистрированный от Сервера MBean. MBean может также реализовать этот интерфейс, чтобы получить ссылку на Сервер MBean и/или его имя в пределах этого Сервер MBean.

С тех пор:

1.5

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	postDeregister() Позволяет MBean выполнять любые операции, необходимые будучи незарегистрированным в сервере MBean.
void	postRegister(Boolean registrationDone) Позволяет MBean выполнять любые операции, необходимые, будучи зарегистрированным в сервере MBean или после того, как регистрация перестала работать.
void	preDeregister() Позволяет MBean выполнять любые операции, в которых он нуждается перед стать незарегистрированным сервером MBean.
ObjectName	preRegister(MBeanServer server, ObjectName name) Позволяет MBean выполнять любые операции, в которых он нуждается прежде, чем быть зарегистрированным в Сервере MBean.

Деталь метода

предварительный регистр

ObjectName preRegister(MBeanServer server,
                     ObjectName name)
                       throws Exception

Позволяет MBean выполнять любые операции, в которых он нуждается прежде, чем быть зарегистрированным в Сервере MBean. Если имя MBean не определяется, MBean может обеспечить имя для своей регистрации. Если какое-либо исключение будет повышено, то MBean не будет зарегистрирован в Сервере MBean.

Параметры:

server - Сервер MBean, в котором будет зарегистрирован MBean.

name - Имя объекта MBean. Это имя является нулем если параметр имени к одному из createMBean или registerMBean методы в MBeanServer интерфейс является нулем. В этом случае этот метод должен возвратить ненулевой ObjectName для нового MBean.

Возвраты:

Имя, под которым должен быть зарегистрирован MBean. Это значение не должно быть нулем. Если name параметр не является нулем, он обычно будет, но не обязательно быть возвращенным значением.

Броски:

Exception - Это исключение будет поймано Сервером MBean и повторно брошено как MBeanRegistrationException.

пострегистр

void postRegister(Boolean registrationDone)

Позволяет MBean выполнять любые операции, необходимые, будучи зарегистрированным в сервере MBean или после того, как регистрация перестала работать.

Если реализация этого метода бросает a RuntimeException или Error, Сервер MBean повторно бросит тех внутри a RuntimeMBeanException или RuntimeErrorException, соответственно. Однако, выдавая исключение в postRegister не будет изменять состояние MBean: если MBean был уже зарегистрирован (registrationDone true), MBean останется зарегистрированным.

Это могло бы сбить с толку вызов кода createMBean() или registerMBean(), как таковой кодируют, мог бы предположить, что регистрация MBean перестала работать, когда такое исключение повышается. Поэтому этому рекомендуют это реализации postRegister не бросайте Исключения на этапе выполнения или Ошибки, если этого можно избежать.

Параметры:

registrationDone - Указывает, был ли MBean успешно зарегистрирован в сервере MBean. Ложь значения означает, что регистрационная фаза перестала работать.

предварительно вычеркнуть из списка

void preDeregister()
                   throws Exception

Позволяет MBean выполнять любые операции, в которых он нуждается перед стать незарегистрированным сервером MBean.

Броски:

Exception - Это исключение будет поймано сервером MBean и повторно брошено как MBeanRegistrationException.

поствычеркнуть из списка

void postDeregister()

Позволяет MBean выполнять любые операции, необходимые будучи незарегистрированным в сервере MBean.

Если реализация этого метода бросает a RuntimeException или Error, Сервер MBean повторно бросит тех внутри a RuntimeMBeanException или RuntimeErrorException, соответственно. Однако, выдавая исключение в postDeregister не будет изменять состояние MBean: MBean был уже успешно вычеркнут из списка и останется так.

Это могло бы сбить с толку вызов кода unregisterMBean(), поскольку это могло бы предположить, что MBean deregistration перестал работать. Поэтому этому рекомендуют это реализации postDeregister не бросайте Исключения на этапе выполнения или Ошибки, если этого можно избежать.