compact3

javax.naming.event

Класс NamingEvent

java.lang. Объект

java.util. EventObject

javax.naming.event. NamingEvent

Все Реализованные Интерфейсы:

Сериализуемый

public class NamingEvent
extends EventObject

Этот class представляет событие, запущенное именованием/службой каталогов.

Состояние NamingEvent состоит из

• Источник события: EventContext, который запустил это событие.
• Тип события.
• Новая привязка: информация об объекте после изменения.
• Старая привязка: информация об объекте перед изменением.
• Информация об изменении: информация об изменении, которое инициировало это событие; обычно специфичная для поставщика услуг или специфичная для сервера информация.

Отметьте, что источник события всегда является тем же самым экземпляром EventContext, в котором зарегистрировался слушатель. Кроме того имена привязки в NamingEvent всегда относительно того экземпляра. Например, предположите, что слушатель делает следующую регистрацию:

     NamespaceChangeListener listener = ...;
     src.addNamingListener("x", SUBTREE_SCOPE, listener);

Когда объект, названный "x/y", впоследствии удаляется, соответствующий NamingEvent (evt) должен содержать:

     evt.getEventContext() == src
     evt.getOldBinding().getName().equals("x/y")

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

С тех пор:

1.3

См. Также:

NamingListener, EventContext, Сериализированная Форма

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
protected Object	changeInfo Содержит информацию об изменении, которое генерировало это событие.
protected Binding	newBinding Содержит информацию об объекте после изменения.
static int	OBJECT_ADDED Именование события вводит для того, чтобы указать, что был добавлен новый объект.
static int	OBJECT_CHANGED Именование события вводит для того, чтобы указать, что объект был изменен.
static int	OBJECT_REMOVED Именование события вводит для того, чтобы указать, что объект был удален.
static int	OBJECT_RENAMED Именование события вводит для того, чтобы указать, что объект был переименован.
protected Binding	oldBinding Содержит информацию об объекте перед изменением.
protected int	ввести Содержит тип этого события.

Поля, наследованные от class java.util. EventObject

источник

Сводка конструктора

Конструкторы

Конструктор и Описание
NamingEvent(EventContext source, int type, Binding newBd, Binding oldBd, Object changeInfo) Создает экземпляр NamingEvent.

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

Модификатор и Тип	Метод и Описание
void	dispatch(NamingListener listener) Вызывает соответствующий метод слушателя на это событие.
Объект	getChangeInfo() Получает информацию об изменении для этого события.
EventContext	getEventContext() Получает источник события, который запустил это событие.
Привязка	getNewBinding() Получает привязку объекта после изменения.
Привязка	getOldBinding() Получает привязку объекта перед изменением.
int	getType() Возвращает тип этого события.

Методы, наследованные от class java.util. EventObject

getSource, toString

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Полевая Деталь

OBJECT_ADDED

public static final int OBJECT_ADDED

Именование события вводит для того, чтобы указать, что был добавлен новый объект. Значением этой константы является 0.

См. Также:

Постоянные Значения полей

OBJECT_REMOVED

public static final int OBJECT_REMOVED

Именование события вводит для того, чтобы указать, что объект был удален. Значением этой константы является 1.

См. Также:

Постоянные Значения полей

OBJECT_RENAMED

public static final int OBJECT_RENAMED

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

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

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

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

См. Также:

Постоянные Значения полей

OBJECT_CHANGED

public static final int OBJECT_CHANGED

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

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

См. Также:

Постоянные Значения полей

changeInfo

protected Object changeInfo

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

ввести

protected int type

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

См. Также:

OBJECT_ADDED, OBJECT_REMOVED, OBJECT_RENAMED, OBJECT_CHANGED

oldBinding

protected Binding oldBinding

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

newBinding

protected Binding newBinding

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

Деталь конструктора

NamingEvent

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

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

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

Параметры:

source - Ненулевой контекст, который запустил это событие.

type - Тип события.

newBd - Возможно нуль, связывающий перед изменением. См. описание метода.

oldBd - Возможно нуль, связывающий после изменения. См. описание метода.

changeInfo - Возможно нулевой объект, содержащий информацию об изменении.

См. Также:

OBJECT_ADDED, OBJECT_REMOVED, OBJECT_RENAMED, OBJECT_CHANGED

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

getType

public int getType()

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

Возвраты:

Тип этого события.

См. Также:

OBJECT_ADDED, OBJECT_REMOVED, OBJECT_RENAMED, OBJECT_CHANGED

getEventContext

public EventContext getEventContext()

Получает источник события, который запустил это событие. Это возвращает тот же самый объект как EventObject.getSource().

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

Возвраты:

Ненулевой контекст, который запустил это событие.

getOldBinding

public Binding getOldBinding()

Получает привязку объекта перед изменением.

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

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

Возвраты:

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

getNewBinding

public Binding getNewBinding()

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

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

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

Возвраты:

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

getChangeInfo

public Object getChangeInfo()

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

Возвраты:

Возможно нуль изменяют информацию этого события.

диспетчеризировать

public void dispatch(NamingListener listener)

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

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

Параметры:

listener - Ненулевой слушатель.