Класс NamingEvent

public static final int OBJECT_ADDED

Тип события именования, указывающий на добавление нового объекта. Значение этой константы равно 0.

public static final int OBJECT_REMOVED

Тип события именования, указывающий на удаление объекта. Значение этой константы равно 1.

public static final int OBJECT_RENAMED

Тип события именования, указывающий на переименование объекта. Обратите внимание, что некоторые сервисы могут генерировать несколько событий для одной логической операции переименования. Например, операция переименования может быть реализована путем добавления привязки с новым именем и удаления старой привязки.

Старая/новая привязки в NamingEvent могут быть равны null, если старое или новое имя находятся вне области, на которую зарегистрирован слушатель.

Когда внутренний узел в дереве пространства имен был переименован, должен использоваться самый верхний узел, который входит в область слушателя, для генерации события переименования. Степень поддержки этого зависит от поставщика. Например, сервис может генерировать уведомления о переименовании для всех потомков изменённого внутреннего узла, и соответствующий поставщик может не иметь возможности предотвратить распространение этих уведомлений к слушателям.

Значение этой константы равно 2.

public static final int OBJECT_CHANGED

Тип события именования, указывающий на изменение объекта. Изменения могут включать атрибуты объекта или сам объект. Обратите внимание, что некоторые службы могут генерировать несколько событий для одного изменения. Например, изменение может быть реализовано путем сначала удаления старой привязки и добавления новой привязки с тем же именем, но другим объектом.

Значение этой константы равно 3.

protected Object changeInfo

Содержит информацию об изменении, которое сгенерировало это событие.

protected int type

Содержит тип этого события.

protected Binding oldBinding

Содержит информацию об объекте до изменения.

protected Binding newBinding

Содержит информацию об объекте после изменения.

public NamingEvent(EventContext source, int type, Binding newBd, Binding oldBd, Object changeInfo)

Создаёт экземпляр NamingEvent.

Имена в newBd и oldBd должны быть разрешены относительно источника события source. Для типа события OBJECT_ADDED newBd не должен быть null. Для типа события OBJECT_REMOVED oldBd не должен быть null. Для типа события OBJECT_CHANGED newBd и oldBd не должны быть null. Для типа события OBJECT_RENAMED один из newBd или oldBd может быть null, если новая или старая привязка находятся вне области, на которую зарегистрирован слушатель.

public int getType()

Возвращает тип этого события.

public EventContext getEventContext()

Возвращает источник события, сгенерировавший это событие. Это возвращает тот же объект, что и EventObject.getSource().

Если результат этого метода используется для доступа к источнику события, например, для поиска объекта или получения его атрибутов, то он должен быть заблокирован, поскольку реализации Context не гарантируют потокобезопасность (и EventContext является подинтерфейсом Context). См. описание пакета потоки для получения дополнительной информации о проблемах с потоками.

public Binding getOldBinding()

Возвращает привязку объекта до изменения.

Привязка должна быть не равна null, если объект существовал до изменения относительно контекста источника (getEventContext()). То есть, она должна быть не равна null для OBJECT_REMOVED и OBJECT_CHANGED. Для OBJECT_RENAMED, она равна null, если объект до переименования находится вне области, на которую слушатель зарегистрировал интерес; она не равна null, если объект находится в области до переименования.

Имя в привязке должно быть разрешено относительно источника события getEventContext(). Возвращаемый объектом Binding.getObject() может быть null, если такая информация недоступна.

public Binding getNewBinding()

Возвращает привязку объекта после изменения.

Привязка должна быть не равна null, если объект существовал после изменения относительно контекста источника (getEventContext()). То есть, она должна быть не равна null для OBJECT_ADDED и OBJECT_CHANGED. Для OBJECT_RENAMED, она равна null, если объект после переименования находится вне области, на которую слушатель зарегистрировал интерес; она не равна null, если объект находится в области после переименования.

Имя в привязке должно быть разрешено относительно источника события getEventContext(). Возвращаемый объектом Binding.getObject() может быть null, если такая информация недоступна.

public Object getChangeInfo()

Возвращает информацию об изменении для этого события. Значение информации об изменении зависит от службы. Например, это может быть идентификатор, который идентифицирует изменение в журнале изменений на сервере.

public void dispatch(NamingListener listener)

Вызывает соответствующий метод слушателя на этом событии. Реализация по умолчанию этого метода обрабатывает следующие типы событий: OBJECT_ADDED, OBJECT_REMOVED, OBJECT_RENAMED, OBJECT_CHANGED.

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