Пакет javax.naming.event

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

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

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

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

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

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

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());
    }
}

Вопросы многопоточности

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

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

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