Пакет javax.naming.event

Обеспечивает оповещение об событиях при доступе к службам именования и каталогов.

Этот пакет определяет операции оповещения об событиях для Java Naming and Directory Interface (JNDI). JNDI предоставляет приложениям, написанным на языке программирования Java, функциональность именования и каталогов. Он разработан независимо от любой конкретной реализации службы именования или каталогов. Таким образом, к различным службам — новым, появляющимся и уже развернутым — можно получить доступ стандартным способом.

События именования

Этот пакет определяет класс NamingEvent для представления события, генерируемого службой именования/каталогов. Он также определяет подинтерфейсы Context и DirContext, называемые EventContext и EventDirContext, с помощью которых приложения могут зарегистрировать свой интерес к событиям, генерируемым контекстом.

NamingEvent представляет собой событие, которое происходит в службе именования или каталогов. Существует две категории событий именования:

• Те, которые влияют на пространство имен (добавление/удаление/переименование объекта)
• Те, которые влияют на содержимое объектов.

Каждая категория событий обрабатывается соответствующим слушателем: NamespaceChangeListener, ObjectChangeListener.

Приложение, например, может зарегистрировать свой интерес к изменениям объектов в контексте следующим образом:

EventContext src = 
    (EventContext)(new InitialContext()).lookup("o=wiz,c=us");
src.addNamingListener("ou=users", EventContext.ONELEVEL_SCOPE,
    new ChangeHandler());
...
class ChangeHandler implements ObjectChangeListener {
    public void objectChanged(NamingEvent evt) {
        System.out.println(evt.getNewBinding());
    }
    public void namingExceptionThrown(NamingExceptionEvent evt) {
        System.out.println(evt.getException());
    }
}

Вопросы потоков

Когда событие отправляется слушателю, метод слушателя (например, objectChanged()) может быть выполнен в потоке, отличном от того, в котором был выполнен вызов addNamingListener(). Выбор потока выполняется поставщиком службы. Когда событие отправляется нескольким слушателям, поставщик службы может выбрать (и обычно рекомендуется) выполнение методов слушателей одновременно в отдельных потоках.

Когда экземпляр слушателя вызывает NamingEvent.getEventContext(), он должен учитывать возможность одновременной работы с этим контекстом в других потоках. Аналогично, когда слушатель регистрируется через addNamingListener(), регистрирующий поток должен учитывать вероятность того, что поставщик службы позже вызовет слушателей в вновь созданных потоках. Поскольку экземпляры Context не гарантируют общую потокобезопасность, все операции контекста должны синхронизироваться по мере необходимости.

Обработка исключений

Когда слушатель регистрируется для событий в контексте, контексту может потребоваться выполнить некоторую внутреннюю обработку для сбора информации, необходимой для генерации событий. Например, контекст может потребоваться отправить запрос на сервер, чтобы зарегистрировать интерес к изменениям на сервере, которые в конечном итоге будут преобразованы в события. Если произойдет исключение, которое предотвратит сбор информации о событиях, слушатель никогда не будет уведомлен об этих событиях. При возникновении такого исключения генерируется NamingExceptionEvent, чтобы уведомить слушателя. Метод слушателя namingExceptionThrown() вызывается, как показано в примере кода выше, и слушатель автоматически отключается.

Спецификация пакета

Спецификация API JNDI и связанные документы можно найти в документации JNDI.