Пакет 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 в общем случае не гарантированно являются потокобезопасными, все операции с контекстом при необходимости необходимо синхронизировать.

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

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