Пакет javax.naming.event

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

См.: Описание

Сводка интерфейса

Интерфейс	Описание
EventContext	Содержит методы для того, чтобы регистрироваться/вычеркнуть из списка слушателей, чтобы быть уведомленным относительно событий, запущенных, когда объекты, названные в контексте, изменяются.
EventDirContext	Содержит методы для того, чтобы зарегистрировать слушателей, чтобы быть уведомленным относительно событий, запущенных, когда объекты, названные в контексте каталога, изменяются.
NamespaceChangeListener	Определяет методы, которые должен реализовать слушатель, заинтересованный изменениями пространства имен.
NamingListener	Этот интерфейс является корнем интерфейсов слушателя тот дескриптор NamingEvent s.
ObjectChangeListener	Определяет метод, который должен реализовать слушатель NamingEvent с типом события OBJECT_CHANGED.

Сводка класса

Класс	Описание
NamingEvent	Этот class представляет событие, запущенное именованием/службой каталогов.
NamingExceptionEvent	Этот class представляет событие, запущенное, когда процедуры/процессы, используемые, чтобы собрать информацию для того, чтобы уведомить слушателей NamingEvent s, бросили NamingException.

Пакет javax.naming.event Описание

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

Этот пакет определяет операции уведомления о событии Именования Java и Каталога ^InterfaceTM (JNDI). JNDI обеспечивает именование и функциональность каталога к приложениям, записанным в языке программирования Java. Это разрабатывается, чтобы быть независимым от любого определенного именования или реализации службы каталогов. Таким образом ко множеству служб - новый, появление, и уже развернутые - можно получить доступ в распространенном способе.

Именование Событий

Этот пакет определяет NamingEvent class, чтобы представить событие, которое сгенерировано именованием/службой каталогов. Это также определяет подынтерфейсы 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.

С тех пор:

1.3