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

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

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

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

public Binding getNewBinding()

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

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

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

public Object getChangeInfo()

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

public void dispatch(NamingListener listener)

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

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