compact3

javax.naming

Контекст интерфейса

Все Известные Подынтерфейсы:

DirContext, EventContext, EventDirContext, LdapContext

Все Известные Классы с реализацией:

InitialContext, InitialDirContext, InitialLdapContext

public interface Context

Этот интерфейс представляет контекст именования, который состоит из ряда привязки имени к объекту. Это содержит методы для исследования и обновления этой привязки.

Имена

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

Большинство методов перегрузило версии с одним взятием a Name параметр и одно взятие a String. Эти перегруженные версии эквивалентны в этом если Name и String параметры являются только различными представлениями того же самого имени, тогда перегруженные версии тех же самых методов ведут себя то же самое. В описаниях метода ниже, полностью документируется только одна версия. У второй версии вместо этого есть ссылка к первому: та же самая документация применяется к обоим.

Для систем, которые поддерживают федерацию, параметрами имени String методам Context являются составные имена. Параметры имени, которые являются экземплярами CompositeName, обрабатываются, как составной объект называет, в то время как параметры Name, которые не являются экземплярами CompositeName, обрабатываются, как составной объект называет (который мог бы быть экземплярами CompoundName или другими реализациями составных имен). Это позволяет результатам NameParser.parse() использоваться в качестве параметров методам Context. До JNDI 1.2, все параметры имени были обработаны как составные имена.

Кроме того, для систем, которые поддерживают федерацию, все имена, возвращенные в NamingEnumeration из list() и listBindings(), являются составными именами, представленными как строки. См. CompositeName для строкового синтаксиса имен.

Для систем, которые не поддерживают федерацию, параметрами имени (или в Name или в формах String) и имена, возвращенные в NamingEnumeration, могут быть имена в своем собственном пространстве имен, а не имена в составном пространстве имен, на усмотрение поставщика услуг.

Исключения

Все методы в этом интерфейсе могут бросить NamingException или любой из его подклассов. См. NamingException и их подклассы для деталей о каждом исключении.

Параллельный Доступ

Экземпляр Контекста, как гарантируют, не будет синхронизироваться против параллельного доступа многократными потоками. Потоки, которые должны получить доступ к единственному экземпляру Контекста одновременно, должны синхронизироваться среди себя и обеспечить необходимую блокировку. Многократные потоки каждое управление различным экземпляром Контекста не должны синхронизироваться. Отметьте что lookup метод, когда передано пустое название, возвратит новый экземпляр Контекста, представляющий тот же самый контекст именования.

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

Параметры

Параметр Name, который передают к любому методу интерфейса Context или одному из его подынтерфейсов, не будет изменен поставщиком услуг. Поставщик услуг может сохранить ссылку на это для продолжительности работы, включая любое перечисление результатов метода и обработку любых отсылок сгенерированной. Вызывающая сторона не должна изменить объект в это время. Name, возвращенный любым таким методом, принадлежит вызывающей стороне. Вызывающая сторона может впоследствии изменить это; поставщик услуг не может.

Свойства среды

Приложения JNDI нуждаются в способе передать различное предпочтение и свойства, которые определяют среду, в которой получают доступ к именованию и службы каталогов. Например, контекст мог бы потребовать спецификации учетных данных безопасности, чтобы получить доступ к службе. Другой контекст мог бы потребовать, чтобы конфигурационная информация сервера была предоставлена. Они упоминаются как среда контекста. Интерфейс Context обеспечивает методы для получения и обновления этой среды.

Среда наследована от родительского контекста, поскольку методы контекста продолжаются от одного контекста до следующего. Изменения к среде одного контекста непосредственно не влияют на таковые из других контекстов.

Это является зависящим от реализации, когда свойства среды используются и/или проверяются для законности. Например, некоторые из связанных с безопасностью свойств используются поставщиками услуг, чтобы "войти в систему" к каталогу. Этот процесс входа в систему мог бы произойти в то время, когда контекст создается, или в первый раз, когда метод вызывается на контекст. Когда, и происходит ли это вообще, является зависящим от реализации. Когда свойства среды добавляются или удаляются из контекста, проверяя, что законность изменений является снова зависящей от реализации. Например, проверка некоторых свойств могла бы произойти в то время, когда изменение производится, или в то время, когда следующая работа выполняется на контексте, или нисколько.

Любой объект со ссылкой на контекст может исследовать среду того контекста. Уязвимая информация, такая как пароли в виде открытого текста не должна быть сохранена там, если реализация, как не известно, защищает ее.

Файлы ресурсов

Чтобы упростить задачу установки среды, требуемой приложением JNDI, компоненты приложения и поставщики услуг могут быть распределены наряду с файлами ресурсов. Файл ресурсов JNDI является файлом в формате файла свойств (см. java.util.Properties), содержа список пар ключ/значение. Ключ является именем свойства (например, "java.naming.factory.object"), и значение является строкой в формате, определенном для того свойства. Вот пример файла ресурсов JNDI:

 java.naming.factory.object=com.sun.jndi.ldap.AttrsToCorba:com.wiz.from.Person
 java.naming.factory.state=com.sun.jndi.ldap.CorbaToAttrs:com.wiz.from.Person
 java.naming.factory.control=com.sun.jndi.ldap.ResponseControlFactory
 

Библиотека class JNDI читает файлы ресурсов и делает значения свойств в свободном доступе. Таким образом файлы ресурсов JNDI, как должны полагать, являются "миром, читаемым", и уязвимая информация, такая как пароли в виде открытого текста не должна быть сохранена там.

Есть два вида файлов ресурсов JNDI: провайдер и приложение.

Файлы ресурсов провайдера

У каждого поставщика услуг есть дополнительный ресурс, который перечисляет свойства, определенные для того провайдера. Имя этого ресурса:

[снабдите префиксом/] jndiprovider.properties

где префикс является именем пакета реализации (й) контекста провайдера с каждым периодом (". ") преобразованный в наклонную черту (" / "). Например, предположите, что поставщик услуг определяет реализацию контекста с помощью имени class com.sun.jndi.ldap.LdapCtx. Ресурс провайдера для этого провайдера называют com/sun/jndi/ldap/jndiprovider.properties. Если class не находится в пакете, именем ресурса является просто jndiprovider.properties.

Определенные методы в библиотеке class JNDI используют стандартные свойства JNDI, которые определяют списки фабрик JNDI:

• java.naming.factory.object
• java.naming.factory.state
• java.naming.factory.control
• java.naming.factory.url.pkgs

Библиотека JNDI будет консультироваться с файлом ресурсов провайдера, определяя значения этих свойств. Свойства кроме них могут быть установлены в файле ресурсов провайдера на усмотрение поставщика услуг. Документация поставщика услуг должна ясно утвердить, какие свойства позволяются; другие свойства в файле будут проигнорированы.

Файлы ресурсов приложения

Когда приложение будет развернуто, у него обычно будет несколько каталогов кодовой базы и JAR в ее пути к классу. Точно так же, когда апплет развертывается, у него будут кодовая база и архивы, определяющие, где найти классы апплета. JNDI располагается (использование ClassLoader.getResources()) все файлы ресурсов приложения под названием jndi.properties в пути к классу. Кроме того, если Java home/lib/jndi.properties файла существует и читаем, JNDI обрабатывает его как дополнительный файл ресурсов приложения. (java.home указывает на каталог, названный системным свойством java.home.) Все свойства, содержавшиеся в этих файлах, помещаются в среду начального контекста. Эта среда тогда наследована другими контекстами.

Для каждого свойства, найденного больше чем в одном файле ресурсов приложения, JNDI использует первое найденное значение или в нескольких случаях, где имеет смысл делать так, это связывает все значения (детали даются ниже). Например, если "java.naming.factory.object" свойство находится в трех файлах ресурсов jndi.properties, список объектных фабрик является связью значений свойств от всех трех файлов. Используя эту схему, каждый развертываемый компонент ответственен за перечисление фабрик, которые это экспортирует. JNDI автоматически собирает и использует все эти списки экспорта, ища классы фабрики.

Алгоритм поиска для Свойств

Когда JNDI создает начальный контекст, среда контекста инициализируется со свойствами, определенными в параметре среды, который передают конструктору, системным свойствам, параметрам апплета, и файлам ресурсов приложения. См. InitialContext для деталей. Эта начальная среда тогда наследована другими экземплярами контекста.

Когда библиотека class JNDI должна определить значение свойства, это делает так, объединяя значения из следующих двух источников в порядке:

1. Среда контекста, управляемого на.
2. Файл ресурсов провайдера (jndiprovider.properties) для контекста, управляемого на.

Для каждого свойства, найденного в обоих из этих двух источников, JNDI определяет значение свойства следующим образом. Если свойство является одним из стандартных свойств JNDI, которые определяют список (упомянутых выше) фабрик JNDI, значения связываются в единственный разделенный от двоеточия список. Для других свойств только используется первое найденное значение.

Когда поставщик услуг должен будет определить значение свойства, это обычно примет что значение непосредственно от среды. Поставщик услуг может определить специфичные для провайдера свойства, которые будут помещены в его собственный файл ресурсов провайдера. В этом случае это должно объединить значения как описано в предыдущем абзаце.

Таким образом каждый разработчик поставщика услуг может определить список фабрик, чтобы использовать с тем поставщиком услуг. Они могут быть изменены ресурсами приложения, определенными deployer приложения или апплета, который поочередно может быть изменен пользователем.

С тех пор:

1.3

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static String	АППЛЕТ Постоянный, который содержит имя свойства среды для того, чтобы определить апплет для начального конструктора контекста, чтобы использовать, ища другие свойства.
static String	АВТОРИТЕТНЫЙ Постоянный, который содержит имя свойства среды для того, чтобы определить авторитетность службы, которую требуют.
static String	BATCHSIZE Постоянный, который содержит имя свойства среды для того, чтобы определить пакетный размер, чтобы использовать, возвращая данные через протокол службы.
static String	DNS_URL Постоянный, который содержит имя свойства среды для того, чтобы определить имена хоста DNS и доменные имена, чтобы использовать для контекста URL JNDI (например, "dns://somehost/wiz.com").
static String	INITIAL_CONTEXT_FACTORY Постоянный, который содержит имя свойства среды для того, чтобы определить начальную фабрику контекста, чтобы использовать.
static String	ЯЗЫК Постоянный, который содержит имя свойства среды для того, чтобы определить привилегированный язык, чтобы использовать со службой.
static String	OBJECT_FACTORIES Постоянный, который содержит имя свойства среды для того, чтобы определить список объектных фабрик, чтобы использовать.
static String	PROVIDER_URL Постоянный, который содержит имя свойства среды для того, чтобы определить конфигурационную информацию для поставщика услуг, чтобы использовать.
static String	ОТСЫЛКА Постоянный, который содержит имя свойства среды для того, чтобы определить, как должны быть обработаны отсылки, с которыми встречается поставщик услуг.
static String	SECURITY_AUTHENTICATION Постоянный, который содержит имя свойства среды для того, чтобы определить уровень безопасности, чтобы использовать.
static String	SECURITY_CREDENTIALS Постоянный, который содержит имя свойства среды для того, чтобы определить учетные данные принципала для того, чтобы аутентифицировать вызывающую сторону к службе.
static String	SECURITY_PRINCIPAL Постоянный, который содержит имя свойства среды для того, чтобы определить идентификационные данные принципала для того, чтобы аутентифицировать вызывающую сторону к службе.
static String	SECURITY_PROTOCOL Постоянный, который содержит имя свойства среды для того, чтобы определить протокол системы защиты, чтобы использовать.
static String	STATE_FACTORIES Постоянный, который содержит имя свойства среды для того, чтобы определить список фабрик состояния, чтобы использовать.
static String	URL_PKG_PREFIXES Постоянный, который содержит имя свойства среды для того, чтобы определить список префиксов пакета, чтобы использовать, загружаясь на фабриках контекста URL.

Сводка метода

Модификатор и Тип	Метод и Описание
Объект	addToEnvironment(String propName, Object propVal) Добавляет новое свойство среды к среде этого контекста.
void	bind(Name name, Object obj) Связывает имя к объекту.
void	bind(String name, Object obj) Связывает имя к объекту.
void	close() Завершения этот контекст.
Имя	composeName(Name name, Name prefix) Составляет имя этого контекста с именем относительно этого контекста.
Строка	composeName(String name, String prefix) Составляет имя этого контекста с именем относительно этого контекста.
Контекст	createSubcontext(Name name) Создает и ограничивает новый контекст.
Контекст	createSubcontext(String name) Создает и ограничивает новый контекст.
void	destroySubcontext(Name name) Уничтожает именованный контекст и удаляет это из пространства имен.
void	destroySubcontext(String name) Уничтожает именованный контекст и удаляет это из пространства имен.
Hashtable<?,?>	getEnvironment() Получает среду в действительности для этого контекста.
Строка	getNameInNamespace() Получает полное имя этого контекста в пределах его собственного пространства имен.
NameParser	getNameParser(Name name) Получает синтаксический анализатор, связанный с именованным контекстом.
NameParser	getNameParser(String name) Получает синтаксический анализатор, связанный с именованным контекстом.
NamingEnumeration<NameClassPair>	list(Name name) Перечисляет имена, связанные в именованном контексте, наряду с именами class объектов, связанных с ними.
NamingEnumeration<NameClassPair>	list(String name) Перечисляет имена, связанные в именованном контексте, наряду с именами class объектов, связанных с ними.
NamingEnumeration<Binding>	listBindings(Name name) Перечисляет имена, связанные в именованном контексте, наряду с объектами, связанными с ними.
NamingEnumeration<Binding>	listBindings(String name) Перечисляет имена, связанные в именованном контексте, наряду с объектами, связанными с ними.
Объект	lookup(Name name) Получает именованный объект.
Объект	lookup(String name) Получает именованный объект.
Объект	lookupLink(Name name) Получает именованный объект, ссылки за исключением терминального атомарного компонента имени.
Объект	lookupLink(String name) Получает именованный объект, ссылки за исключением терминального атомарного компонента имени.
void	rebind(Name name, Object obj) Связывает имя к объекту, перезаписывая любую существующую привязку.
void	rebind(String name, Object obj) Связывает имя к объекту, перезаписывая любую существующую привязку.
Объект	removeFromEnvironment(String propName) Удаляет свойство среды из среды этого контекста.
void	rename(Name oldName, Name newName) Связывает новое имя к объекту, связанному со старым названием, и развязывает старое название.
void	rename(String oldName, String newName) Связывает новое имя к объекту, связанному со старым названием, и развязывает старое название.
void	unbind(Name name) Развязывает именованный объект.
void	unbind(String name) Развязывает именованный объект.

Полевая Деталь

INITIAL_CONTEXT_FACTORY

static final String INITIAL_CONTEXT_FACTORY

Постоянный, который содержит имя свойства среды для того, чтобы определить начальную фабрику контекста, чтобы использовать. Значение свойства должно быть полностью определенным именем class фабрики class, который создаст начальный контекст. Это свойство может быть определено в параметре среды, который передают начальному конструктору контекста, параметру апплета, системному свойству, или файлу ресурсов приложения. Если это не определяется ни в одном из этих источников, NoInitialContextException бросается, когда начальный контекст обязан завершать работу.

Значение этой константы является "java.naming.factory.initial".

См. Также:

InitialContext, InitialDirContext, NamingManager.getInitialContext(java.util.Hashtable<?, ?>), InitialContextFactory, NoInitialContextException, addToEnvironment(String, Object), removeFromEnvironment(String), APPLET, Постоянные Значения полей

OBJECT_FACTORIES

static final String OBJECT_FACTORIES

Постоянный, который содержит имя свойства среды для того, чтобы определить список объектных фабрик, чтобы использовать. Значение свойства должно быть разделенным от двоеточия списком полностью определенных имен class классов фабрики, которые создадут объект, данный информацию об объекте. Это свойство может быть определено в среде, параметре апплета, системном свойстве, или одном или более файлах ресурсов.

Значение этой константы является "java.naming.factory.object".

См. Также:

NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>), ObjectFactory, addToEnvironment(String, Object), removeFromEnvironment(String), APPLET, Постоянные Значения полей

STATE_FACTORIES

static final String STATE_FACTORIES

Постоянный, который содержит имя свойства среды для того, чтобы определить список фабрик состояния, чтобы использовать. Значение свойства должно быть разделенным от двоеточия списком полностью определенных имен class классов фабрики состояния, которые будут использоваться, чтобы получить состояние объекта, данное объект непосредственно. Это свойство может быть определено в среде, параметре апплета, системном свойстве, или одном или более файлах ресурсов.

Значение этой константы является "java.naming.factory.state".

С тех пор:

1.3

См. Также:

NamingManager.getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>), StateFactory, addToEnvironment(String, Object), removeFromEnvironment(String), APPLET, Постоянные Значения полей

URL_PKG_PREFIXES

static final String URL_PKG_PREFIXES

Постоянный, который содержит имя свойства среды для того, чтобы определить список префиксов пакета, чтобы использовать, загружаясь на фабриках контекста URL. Значение свойства должно быть разделенным от двоеточия списком префиксов пакета для имени class фабрики class, который создаст фабрику контекста URL. Это свойство может быть определено в среде, параметре апплета, системном свойстве, или одном или более файлах ресурсов. Префиксный com.sun.jndi.url всегда добавляется к возможно пустому списку префиксов пакета.

Значение этой константы является "java.naming.factory.url.pkgs".

См. Также:

NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>), NamingManager.getURLContext(java.lang.String, java.util.Hashtable<?, ?>), ObjectFactory, addToEnvironment(String, Object), removeFromEnvironment(String), APPLET, Постоянные Значения полей

PROVIDER_URL

static final String PROVIDER_URL

Постоянный, который содержит имя свойства среды для того, чтобы определить конфигурационную информацию для поставщика услуг, чтобы использовать. Значение свойства должно содержать строку URL (например, "ldap://somehost:389"). Это свойство может быть определено в среде, параметре апплета, системном свойстве, или файле ресурсов. Если это не определяется ни в одном из этих источников, конфигурация значения по умолчанию определяется поставщиком услуг.

Значение этой константы является "java.naming.provider.url".

См. Также:

addToEnvironment(String, Object), removeFromEnvironment(String), APPLET, Постоянные Значения полей

DNS_URL

static final String DNS_URL

Постоянный, который содержит имя свойства среды для того, чтобы определить имена хоста DNS и доменные имена, чтобы использовать для контекста URL JNDI (например, "dns://somehost/wiz.com"). Это свойство может быть определено в среде, параметре апплета, системном свойстве, или файле ресурсов. Если это не будет определено ни в одном из этих источников, и программа пытается использовать URL JNDI, содержащий имя DNS, то ConfigurationException будет брошен.

Значение этой константы является "java.naming.dns.url".

См. Также:

addToEnvironment(String, Object), removeFromEnvironment(String), Постоянные Значения полей

АВТОРИТЕТНЫЙ

static final String AUTHORITATIVE

Постоянный, который содержит имя свойства среды для того, чтобы определить авторитетность службы, которую требуют. Если значение свойства является строкой "истина", это означает, что доступ к наиболее авторитетному источнику (то есть обойдите любой кэш или копии). Если значение - что-либо еще, источник не должен быть (но может быть), авторитетный. Если неуказанный, значения по умолчанию значения ко "лжи".

Значение этой константы является "java.naming.authoritative".

См. Также:

addToEnvironment(String, Object), removeFromEnvironment(String), Постоянные Значения полей

BATCHSIZE

static final String BATCHSIZE

Постоянный, который содержит имя свойства среды для того, чтобы определить пакетный размер, чтобы использовать, возвращая данные через протокол службы. Это - подсказка к провайдеру, чтобы возвратить результаты операций в пакетах указанного размера, таким образом, провайдер может оптимизировать свою производительность и использование ресурсов. Значение свойства является строковым представлением целого числа. Если неуказанный, пакетный размер определяется поставщиком услуг.

Значение этой константы является "java.naming.batchsize".

См. Также:

addToEnvironment(String, Object), removeFromEnvironment(String), Постоянные Значения полей

ОТСЫЛКА

static final String REFERRAL

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

"следовать"

следуйте за отсылками автоматически

"проигнорировать"

проигнорируйте отсылки

"бросок"

бросьте ReferralException, когда с отсылкой встречаются.

Если это свойство не определяется, значение по умолчанию определяется провайдером.

Значение этой константы является "java.naming.referral".

См. Также:

addToEnvironment(String, Object), removeFromEnvironment(String), Постоянные Значения полей

SECURITY_PROTOCOL

static final String SECURITY_PROTOCOL

Постоянный, который содержит имя свойства среды для того, чтобы определить протокол системы защиты, чтобы использовать. Его значение является строкой, определенной поставщиком услуг (например, "ssl"). Если это свойство является неуказанным, поведение определяется поставщиком услуг.

Значение этой константы является "java.naming.security.protocol".

См. Также:

addToEnvironment(String, Object), removeFromEnvironment(String), Постоянные Значения полей

SECURITY_AUTHENTICATION

static final String SECURITY_AUTHENTICATION

Постоянный, который содержит имя свойства среды для того, чтобы определить уровень безопасности, чтобы использовать. Его значение является одной из следующих строк: "ни один", "простой", "strong". Если это свойство является неуказанным, поведение определяется поставщиком услуг.

Значение этой константы является "java.naming.security.authentication".

См. Также:

addToEnvironment(String, Object), removeFromEnvironment(String), Постоянные Значения полей

SECURITY_PRINCIPAL

static final String SECURITY_PRINCIPAL

Постоянный, который содержит имя свойства среды для того, чтобы определить идентификационные данные принципала для того, чтобы аутентифицировать вызывающую сторону к службе. Формат принципала зависит от схемы аутентификации. Если это свойство является неуказанным, поведение определяется поставщиком услуг.

Значение этой константы является "java.naming.security.principal".

См. Также:

addToEnvironment(String, Object), removeFromEnvironment(String), Постоянные Значения полей

SECURITY_CREDENTIALS

static final String SECURITY_CREDENTIALS

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

Значение этой константы является "java.naming.security.credentials".

См. Также:

addToEnvironment(String, Object), removeFromEnvironment(String), Постоянные Значения полей

ЯЗЫК

static final String LANGUAGE

Постоянный, который содержит имя свойства среды для того, чтобы определить привилегированный язык, чтобы использовать со службой. Значение свойства является разделенным от двоеточия списком тегов языка как определено в RFC 1766. Если это свойство является неуказанным, предпочтение языка определяется поставщиком услуг.

Значение этой константы является "java.naming.language".

См. Также:

addToEnvironment(String, Object), removeFromEnvironment(String), Постоянные Значения полей

АППЛЕТ

static final String APPLET

Постоянный, который содержит имя свойства среды для того, чтобы определить апплет для начального конструктора контекста, чтобы использовать, ища другие свойства. Значение этого свойства является экземпляром java.applet.Applet, который выполняется. Это свойство может быть определено в параметре среды, который передают начальному конструктору контекста. Когда это свойство устанавливается, каждое свойство, которое начальный конструктор контекста ищет в системных свойствах, сначала разыскивается в списке параметров апплета. Если это свойство будет неуказанным, то начальный конструктор контекста будет искать свойства только в параметре среды, который передают к нему, системных свойствах, и файлах ресурсов приложения.

Значение этой константы является "java.naming.applet".

С тех пор:

1.3

См. Также:

addToEnvironment(String, Object), removeFromEnvironment(String), InitialContext, Постоянные Значения полей

Деталь метода

поиск

Object lookup(Name name)
       throws NamingException

Получает именованный объект. Если name пуст, возвращает новый экземпляр этого контекста (который представляет тот же самый контекст именования как этот контекст, но его среда может быть изменена независимо, и к этому можно получить доступ одновременно).

Параметры:

name - имя объекта искать

Возвраты:

объект, связанный с name

Броски:

NamingException - если с исключением именования встречаются

См. Также:

lookup(String), lookupLink(Name)

поиск

Object lookup(String name)
       throws NamingException

Получает именованный объект. См. lookup(Name) для деталей.

Параметры:

name - имя объекта искать

Возвраты:

объект, связанный с name

Броски:

NamingException - если с исключением именования встречаются

связать

void bind(Name name,
          Object obj)
   throws NamingException

Связывает имя к объекту. Все промежуточные контексты и целевой контекст (названное всеми кроме терминального атомарного компонента имени) должны уже существовать.

Параметры:

name - имя, чтобы связать; возможно, не пусто

obj - объект связать; возможно нуль

Броски:

NameAlreadyBoundException - если имя уже связывается

InvalidAttributesException - если объект не предоставлял все обязательные атрибуты

NamingException - если с исключением именования встречаются

См. Также:

bind(String, Object), rebind(Name, Object), DirContext.bind(Name, Object, javax.naming.directory.Attributes)

связать

void bind(String name,
          Object obj)
   throws NamingException

Связывает имя к объекту. См. bind(Name, Object) для деталей.

Параметры:

name - имя, чтобы связать; возможно, не пусто

obj - объект связать; возможно нуль

Броски:

NameAlreadyBoundException - если имя уже связывается

InvalidAttributesException - если объект не предоставлял все обязательные атрибуты

NamingException - если с исключением именования встречаются

снова переплести

void rebind(Name name,
            Object obj)
     throws NamingException

Связывает имя к объекту, перезаписывая любую существующую привязку. Все промежуточные контексты и целевой контекст (названное всеми кроме терминального атомарного компонента имени) должны уже существовать.

Если объектом является DirContext, любые существующие атрибуты, связанные с именем, заменяются таковыми из объекта. Иначе, любые существующие атрибуты, связанные с именем, остаются неизменными.

Параметры:

name - имя, чтобы связать; возможно, не пусто

obj - объект связать; возможно нуль

Броски:

InvalidAttributesException - если объект не предоставлял все обязательные атрибуты

NamingException - если с исключением именования встречаются

См. Также:

rebind(String, Object), bind(Name, Object), DirContext.rebind(Name, Object, javax.naming.directory.Attributes), DirContext

снова переплести

void rebind(String name,
            Object obj)
     throws NamingException

Связывает имя к объекту, перезаписывая любую существующую привязку. См. rebind(Name, Object) для деталей.

Параметры:

name - имя, чтобы связать; возможно, не пусто

obj - объект связать; возможно нуль

Броски:

InvalidAttributesException - если объект не предоставлял все обязательные атрибуты

NamingException - если с исключением именования встречаются

развязать

void unbind(Name name)
     throws NamingException

Развязывает именованный объект. Удаляет терминальное атомарное имя в name от целевого контекста - названное всеми кроме терминальной атомарной части name.

Этот метод является идемпотентом. Это успешно выполняется, даже если терминальное атомарное имя не связывается в целевом контексте, но бросает NameNotFoundException, если какой-либо из промежуточных контекстов не существует.

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

Параметры:

name - имя, чтобы развязать; возможно, не пусто

Броски:

NameNotFoundException - если промежуточный контекст не существует

NamingException - если с исключением именования встречаются

См. Также:

unbind(String)

развязать

void unbind(String name)
     throws NamingException

Развязывает именованный объект. См. unbind(Name) для деталей.

Параметры:

name - имя, чтобы развязать; возможно, не пусто

Броски:

NameNotFoundException - если промежуточный контекст не существует

NamingException - если с исключением именования встречаются

переименовать

void rename(Name oldName,
            Name newName)
     throws NamingException

Связывает новое имя к объекту, связанному со старым названием, и развязывает старое название. Оба имени относительно этого контекста. Любые атрибуты, связанные со старым названием, становятся связанными с новым именем. Промежуточные контексты старого названия не изменяются.

Параметры:

oldName - имя существующей привязки; возможно, не пусто

newName - имя новой привязки; возможно, не пусто

Броски:

NameAlreadyBoundException - если newName уже связывается

NamingException - если с исключением именования встречаются

См. Также:

rename(String, String), bind(Name, Object), rebind(Name, Object)

переименовать

void rename(String oldName,
            String newName)
     throws NamingException

Связывает новое имя к объекту, связанному со старым названием, и развязывает старое название. См. rename(Name, Name) для деталей.

Параметры:

oldName - имя существующей привязки; возможно, не пусто

newName - имя новой привязки; возможно, не пусто

Броски:

NameAlreadyBoundException - если newName уже связывается

NamingException - если с исключением именования встречаются

список

NamingEnumeration<NameClassPair> list(Name name)
                               throws NamingException

Перечисляет имена, связанные в именованном контексте, наряду с именами class объектов, связанных с ними. Содержание любых подконтекстов не включается.

Если привязка добавляется к или удаляется из этого контекста, его эффект на перечисление, ранее возвращенное, неопределен.

Параметры:

name - имя контекста, чтобы перечислить

Возвраты:

перечисление имен и имен class привязки в этом контексте. Каждый элемент перечисления имеет тип NameClassPair.

Броски:

NamingException - если с исключением именования встречаются

См. Также:

list(String), listBindings(Name), NameClassPair

список

NamingEnumeration<NameClassPair> list(String name)
                               throws NamingException

Перечисляет имена, связанные в именованном контексте, наряду с именами class объектов, связанных с ними. См. list(Name) для деталей.

Параметры:

name - имя контекста, чтобы перечислить

Возвраты:

перечисление имен и имен class привязки в этом контексте. Каждый элемент перечисления имеет тип NameClassPair.

Броски:

NamingException - если с исключением именования встречаются

listBindings

NamingEnumeration<Binding> listBindings(Name name)
                                 throws NamingException

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

Если привязка добавляется к или удаляется из этого контекста, его эффект на перечисление, ранее возвращенное, неопределен.

Параметры:

name - имя контекста, чтобы перечислить

Возвраты:

перечисление привязки в этом контексте. Каждый элемент перечисления имеет тип Binding.

Броски:

NamingException - если с исключением именования встречаются

См. Также:

listBindings(String), list(Name), Binding

listBindings

NamingEnumeration<Binding> listBindings(String name)
                                 throws NamingException

Перечисляет имена, связанные в именованном контексте, наряду с объектами, связанными с ними. См. listBindings(Name) для деталей.

Параметры:

name - имя контекста, чтобы перечислить

Возвраты:

перечисление привязки в этом контексте. Каждый элемент перечисления имеет тип Binding.

Броски:

NamingException - если с исключением именования встречаются

destroySubcontext

void destroySubcontext(Name name)
                throws NamingException

Уничтожает именованный контекст и удаляет это из пространства имен. Любые атрибуты, связанные с именем, также удаляются. Промежуточные контексты не уничтожаются.

Этот метод является идемпотентом. Это успешно выполняется, даже если терминальное атомарное имя не связывается в целевом контексте, но бросает NameNotFoundException, если какой-либо из промежуточных контекстов не существует.

В объединенной в федерацию системе именования контекст от одной системы именования может быть ограничен к имени в другом. Можно впоследствии искать и выполнить операции на внешнем контексте, используя составное имя. Однако, попытка уничтожают контекст, используя это составное имя, перестанет работать с NotContextException, потому что внешний контекст не является "подконтекстом" контекста, в котором это связывается. Вместо этого используйте unbind(), чтобы удалить привязку внешнего контекста. Уничтожение внешнего контекста требует, чтобы destroySubcontext() был выполнен на контексте от "собственной" системы именования внешнего контекста.

Параметры:

name - имя контекста, который будет уничтожен; возможно, не пусто

Броски:

NameNotFoundException - если промежуточный контекст не существует

NotContextException - если имя связывается, но не называет контекст, или не называет контекст соответствующего типа

ContextNotEmptyException - если именованный контекст не пуст

NamingException - если с исключением именования встречаются

См. Также:

destroySubcontext(String)

destroySubcontext

void destroySubcontext(String name)
                throws NamingException

Уничтожает именованный контекст и удаляет это из пространства имен. См. destroySubcontext(Name) для деталей.

Параметры:

name - имя контекста, который будет уничтожен; возможно, не пусто

Броски:

NameNotFoundException - если промежуточный контекст не существует

NotContextException - если имя связывается, но не называет контекст, или не называет контекст соответствующего типа

ContextNotEmptyException - если именованный контекст не пуст

NamingException - если с исключением именования встречаются

createSubcontext

Context createSubcontext(Name name)
                  throws NamingException

Создает и ограничивает новый контекст. Создает новый контекст с именем и связывает это в целевом контексте (названное всеми кроме терминального атомарного компонента имени). Все промежуточные контексты и целевой контекст должны уже существовать.

Параметры:

name - имя контекста, чтобы создать; возможно, не пусто

Возвраты:

недавно создаваемый контекст

Броски:

NameAlreadyBoundException - если имя уже связывается

InvalidAttributesException - если создание подконтекста требует спецификации обязательных атрибутов

NamingException - если с исключением именования встречаются

См. Также:

createSubcontext(String), DirContext.createSubcontext(javax.naming.Name, javax.naming.directory.Attributes)

createSubcontext

Context createSubcontext(String name)
                  throws NamingException

Создает и ограничивает новый контекст. См. createSubcontext(Name) для деталей.

Параметры:

name - имя контекста, чтобы создать; возможно, не пусто

Возвраты:

недавно создаваемый контекст

Броски:

NameAlreadyBoundException - если имя уже связывается

InvalidAttributesException - если создание подконтекста требует спецификации обязательных атрибутов

NamingException - если с исключением именования встречаются

lookupLink

Object lookupLink(Name name)
           throws NamingException

Получает именованный объект, ссылки за исключением терминального атомарного компонента имени. Если объект, связанный с name, не является ссылкой, возвращает объект непосредственно.

Параметры:

name - имя объекта искать

Возвраты:

объект, связанный с name, не после терминальной ссылки (если любой).

Броски:

NamingException - если с исключением именования встречаются

См. Также:

lookupLink(String)

lookupLink

Object lookupLink(String name)
           throws NamingException

Получает именованный объект, ссылки за исключением терминального атомарного компонента имени. См. lookupLink(Name) для деталей.

Параметры:

name - имя объекта искать

Возвраты:

объект, связанный с name, не после терминальной ссылки (если любой)

Броски:

NamingException - если с исключением именования встречаются

getNameParser

NameParser getNameParser(Name name)
                  throws NamingException

Получает синтаксический анализатор, связанный с именованным контекстом. В федерации пространств имен различные системы именования проанализируют имена по-другому. Этот метод позволяет приложению получать синтаксический анализатор для того, чтобы он проанализировал имена в их атомарные компоненты, используя соглашение о присвоении имен определенной системы именования. В пределах любой единственной системы именования объекты NameParser, возвращенные этим методом, должны быть равными (использование теста equals()).

Параметры:

name - имя контекста, от которого можно получить синтаксический анализатор

Возвраты:

синтаксический анализатор имени, который может проанализировать составные имена в их атомарные компоненты

Броски:

NamingException - если с исключением именования встречаются

См. Также:

getNameParser(String), CompoundName

getNameParser

NameParser getNameParser(String name)
                  throws NamingException

Получает синтаксический анализатор, связанный с именованным контекстом. См. getNameParser(Name) для деталей.

Параметры:

name - имя контекста, от которого можно получить синтаксический анализатор

Возвраты:

синтаксический анализатор имени, который может проанализировать составные имена в их атомарные компоненты

Броски:

NamingException - если с исключением именования встречаются

composeName

Name composeName(Name name,
                 Name prefix)
          throws NamingException

Составляет имя этого контекста с именем относительно этого контекста. Учитывая имя (name) относительно этого контекста, и имени (prefix) из этого контекстно-зависимого одному из его предков, этот метод возвращает состав двух имен, используя синтаксис, подходящий для включенной системы () именования. Таким образом, если name называет объект относительно этого контекста, результатом является имя того же самого объекта, но относительно контекста предка. Ни одно из имен не может быть нулем.

Например, если этот контекст называют "wiz.com" относительно начального контекста, то

  composeName("east", "wiz.com")  

мог бы возвратиться "east.wiz.com". Если вместо этого этот контекст называют "org/research", то

  composeName("user/jane", "org/research")        

мог бы возвратиться "org/research/user/jane" в то время как

  composeName("user/jane", "research")    

возвраты "research/user/jane".

Параметры:

name - имя относительно этого контекста

prefix - имя этого контекстно-зависимого одному из его предков

Возвраты:

состав prefix и name

Броски:

NamingException - если с исключением именования встречаются

См. Также:

composeName(String, String)

composeName

String composeName(String name,
                   String prefix)
            throws NamingException

Составляет имя этого контекста с именем относительно этого контекста. См. composeName(Name, Name) для деталей.

Параметры:

name - имя относительно этого контекста

prefix - имя этого контекстно-зависимого одному из его предков

Возвраты:

состав prefix и name

Броски:

NamingException - если с исключением именования встречаются

addToEnvironment

Object addToEnvironment(String propName,
                        Object propVal)
                 throws NamingException

Добавляет новое свойство среды к среде этого контекста. Если свойство уже существует, его значение перезаписывается. См. описание class для большего количества деталей о свойствах среды.

Параметры:

propName - имя свойства среды, чтобы добавить; возможно, не нуль

propVal - значение свойства, чтобы добавить; возможно, не нуль

Возвраты:

предыдущее значение свойства, или нуль, если свойство не было в среде прежде

Броски:

NamingException - если с исключением именования встречаются

См. Также:

getEnvironment(), removeFromEnvironment(String)

removeFromEnvironment

Object removeFromEnvironment(String propName)
                      throws NamingException

Удаляет свойство среды из среды этого контекста. См. описание class для большего количества деталей о свойствах среды.

Параметры:

propName - имя свойства среды, чтобы удалить; возможно, не нуль

Возвраты:

предыдущее значение свойства, или нуль, если свойство не было в среде

Броски:

NamingException - если с исключением именования встречаются

См. Также:

getEnvironment(), addToEnvironment(String, Object)

getEnvironment

Hashtable<?,?> getEnvironment()
                       throws NamingException

Получает среду в действительности для этого контекста. См. описание class для большего количества деталей о свойствах среды.

Вызывающая сторона не должна делать изменения в объекте возвращенными: их эффект на контекст неопределен. Среда этого контекста может быть изменена, используя addToEnvironment() и removeFromEnvironment().

Возвраты:

среда этого контекста; никогда не обнуляйте

Броски:

NamingException - если с исключением именования встречаются

См. Также:

addToEnvironment(String, Object), removeFromEnvironment(String)

близко

void close()
    throws NamingException

Завершения этот контекст. Этот метод сразу высвобождает средства этого контекста, вместо того, чтобы ожидать их, чтобы быть выпущенным автоматически сборщиком "мусора".

Этот метод является идемпотентом: вызов этого на контексте, который был уже закрыт, не имеет никакого эффекта. Вызов любого другого метода на закрытом контексте не позволяется, и приводит к неопределенному поведению.

Броски:

NamingException - если с исключением именования встречаются

getNameInNamespace

String getNameInNamespace()
                   throws NamingException

Получает полное имя этого контекста в пределах его собственного пространства имен.

У многих служб именования есть понятие "полного имени" для объектов в их соответствующих пространствах имен. Например, у записи LDAP есть отличительное имя, и у записи DNS есть полностью определенное имя. Этот метод позволяет клиентскому приложению получать это имя. Строка, возвращенная этим методом, не является именем составного объекта JNDI и не должна быть передана непосредственно к методам контекста. В именовании систем, для которых понятие полного имени не имеет смысла, бросается OperationNotSupportedException.

Возвраты:

имя этого контекста в его собственном пространстве имен; никогда не обнуляйте

Броски:

OperationNotSupportedException - если у системы именования нет понятия полного имени

NamingException - если с исключением именования встречаются

С тех пор:

1.3