Интерфейс EventDirContext
- Все суперинтерфейсы:
- Context, DirContext, EventContext
public interface EventDirContext extends EventContext, DirContext
Содержит методы для регистрации слушателей, которые будут уведомлены об событиях, срабатывающих при изменении объектов, именованных в контексте каталога.
Методы в этом интерфейсе поддерживают идентификацию объектов с помощью фильтров поиска RFC 2254.
Используя фильтр поиска, можно зарегистрировать интерес к объектам, которые не существуют на момент регистрации, но позже появятся и удовлетворят фильтру. Однако могут быть ограничения в отношении степени поддержки этого поставщиком услуг и базовым протоколом/службой. Если вызывающий передает фильтр, который не может быть поддержан таким образом, addNamingListener() выбрасывает InvalidSearchFilterException.
См. EventContext для описания источника и целевого объекта события, а также информацию о регистрации/снятии слушателей, которая также применима к методам в этом интерфейсе. См. описание пакета для информации о проблемах с потоками.
Объект SearchControls или массив, переданный в качестве параметра любому методу, принадлежит вызывающей стороне. Поставщик услуг не будет изменять объект или сохранять ссылку на него.
- С:
- 1.3
Поля
Поля, унаследованные от интерфейса javax.naming.event.EventContext
OBJECT_SCOPE, ONELEVEL_SCOPE, SUBTREE_SCOPE Поля, унаследованные от интерфейса javax.naming.directory.DirContext
ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE Поля, унаследованные от интерфейса javax.naming.Context
APPLET, AUTHORITATIVE, BATCHSIZE, DNS_URL, INITIAL_CONTEXT_FACTORY, LANGUAGE, OBJECT_FACTORIES, PROVIDER_URL, REFERRAL, SECURITY_AUTHENTICATION, SECURITY_CREDENTIALS, SECURITY_PRINCIPAL, SECURITY_PROTOCOL, STATE_FACTORIES, URL_PKG_PREFIXES Методы
| Модификатор и тип | Метод и описание |
|---|---|
void |
addNamingListener(Name target,
String filter,
Object[] filterArgs,
SearchControls ctls,
NamingListener l) Добавляет слушателя для получения событий именования, срабатывающих при изменении объектов, идентифицируемых фильтром поиска |
void |
addNamingListener(Name target,
String filter,
SearchControls ctls,
NamingListener l) Добавляет слушателя для получения событий именования, срабатывающих при изменении объектов, идентифицируемых фильтром поиска |
void |
addNamingListener(String target,
String filter,
Object[] filterArgs,
SearchControls ctls,
NamingListener l) Добавляет слушателя для получения событий именования, срабатывающих при изменении объектов, идентифицируемых фильтром поиска |
void |
addNamingListener(String target,
String filter,
SearchControls ctls,
NamingListener l) Добавляет слушателя для получения событий именования, срабатывающих при изменении объектов, идентифицируемых фильтром поиска |
Методы, унаследованные от интерфейса javax.naming.event.EventContext
addNamingListener, addNamingListener, removeNamingListener, targetMustExist Методы, унаследованные от интерфейса javax.naming.directory.DirContext
bind, bind, createSubcontext, createSubcontext, getAttributes, getAttributes, getAttributes, getAttributes, getSchema, getSchema, getSchemaClassDefinition, getSchemaClassDefinition, modifyAttributes, modifyAttributes, modifyAttributes, modifyAttributes, rebind, rebind, search, search, search, search, search, search, search, search Методы, унаследованные от интерфейса javax.naming.Context
addToEnvironment, bind, bind, close, composeName, composeName, createSubcontext, createSubcontext, destroySubcontext, destroySubcontext, getEnvironment, getNameInNamespace, getNameParser, getNameParser, list, list, listBindings, listBindings, lookup, lookup, lookupLink, lookupLink, rebind, rebind, removeFromEnvironment, rename, rename, unbind, unbind Методы
addNamingListener
void addNamingListener(Name target,
String filter,
SearchControls ctls,
NamingListener l)
throws NamingException Добавляет слушателя для получения событий именования, срабатывающих при изменении объектов, идентифицируемых фильтром поиска filter в объекте, именованном в качестве целевого.
Область, флаги returningObj и returningAttributes из параметров поиска ctls используются для управления выбором объектов, к которым слушатель проявляет интерес, и определяет, какая информация возвращается в конечном NamingEvent объекте. Обратите внимание, что запрошенная информация, которая должна возвращаться, может отсутствовать в NamingEvent объекте, если она недоступна или не может быть получена поставщиком услуг или службой.
- Параметры:
-
target- Имя объекта, разрешенного относительно этого контекста. -
filter- Строка фильтра (см. RFC2254). -
ctls- Возможные параметры поиска. Если null, используются параметры поиска по умолчанию. -
l- Слушатель. - Исключения:
-
NamingException- Если возникла проблема при добавлении слушателя. - См. также:
-
EventContext.removeNamingListener(javax.naming.event.NamingListener),DirContext.search(javax.naming.Name, java.lang.String, javax.naming.directory.SearchControls)
addNamingListener
void addNamingListener(String target,
String filter,
SearchControls ctls,
NamingListener l)
throws NamingException Добавляет слушателя для получения событий именования, срабатывающих при изменении объектов, идентифицируемых фильтром поиска filter в объекте, именованном в качестве целевого с именем. См. перегрузку, принимающую Name для получения подробностей о поведении этого метода.
- Параметры:
-
target- Строка имени объекта, разрешенного относительно этого контекста. -
filter- Строка фильтра (см. RFC2254). -
ctls- Возможные параметры поиска. Если null, используются параметры поиска по умолчанию. -
l- Слушатель. - Исключения:
-
NamingException- Если возникла проблема при добавлении слушателя. - См. также:
-
EventContext.removeNamingListener(javax.naming.event.NamingListener),DirContext.search(java.lang.String, java.lang.String, javax.naming.directory.SearchControls)
addNamingListener
void addNamingListener(Name target,
String filter,
Object[] filterArgs,
SearchControls ctls,
NamingListener l)
throws NamingException Добавляет слушателя для получения событий именования, срабатывающих при изменении объектов, идентифицируемых фильтром поиска filter и аргументами фильтра в объекте, именованном в качестве целевого.
Область, флаги returningObj и returningAttributes из параметров поиска ctls используются для управления выбором объектов, к которым слушатель проявляет интерес, и определяет, какая информация возвращается в конечном NamingEvent объекте. Обратите внимание, что запрошенная информация, которая должна возвращаться, может отсутствовать в NamingEvent объекте, если она недоступна или не может быть получена поставщиком услуг или службой.
- Параметры:
-
target- Имя объекта, разрешенного относительно этого контекста. -
filter- Строка фильтра (см. RFC2254). -
filterArgs- Возможный массив аргументов для фильтра. -
ctls- Возможные параметры поиска. Если null, используются параметры поиска по умолчанию. -
l- Слушатель. - Исключения:
-
NamingException- Если возникла проблема при добавлении слушателя. - См. также:
-
EventContext.removeNamingListener(javax.naming.event.NamingListener),DirContext.search(javax.naming.Name, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls)
addNamingListener
void addNamingListener(String target,
String filter,
Object[] filterArgs,
SearchControls ctls,
NamingListener l)
throws NamingException Добавляет слушателя для получения событий именования, срабатывающих при изменении объектов, идентифицируемых фильтром поиска filter и аргументами фильтра в объекте, именованном в качестве целевого с именем. См. перегрузку, принимающую Name для получения подробностей о поведении этого метода.
- Параметры:
-
target- Строка имени объекта, разрешенного относительно этого контекста. -
filter- Строка фильтра (см. RFC2254). -
filterArgs- Возможный массив аргументов для фильтра. -
ctls- Возможные параметры поиска. Если null, используются параметры поиска по умолчанию. -
l- Слушатель. - Исключения:
-
NamingException- Если возникла проблема при добавлении слушателя. - См. также:
-
EventContext.removeNamingListener(javax.naming.event.NamingListener),DirContext.search(java.lang.String, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls)
© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
