Класс 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.

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