Контекст (Платформа Java SE 7)

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

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
Библиотека классов JNDI читает файлы ресурсов и делает значения свойств в свободном доступе. Таким образом файлы ресурсов JNDI, как должны полагать, являются "миром, читаемым", и уязвимая информация, такая как пароли в виде открытого текста не должна быть сохранена там.
Есть два вида файлов ресурсов JNDI: провайдер и приложение.
Файлы ресурсов провайдера
У каждого поставщика услуг есть дополнительный ресурс, который перечисляет свойства, определенные для того провайдера. Имя этого ресурса:
[снабдите префиксом/] jndiprovider.properties
где префикс является именем пакета реализации (й) контекста провайдера с каждым периодом (". ") преобразованный в наклонную черту (" / "). Например, предположите, что поставщик услуг определяет реализацию контекста с помощью имени класса com.sun.jndi.ldap.LdapCtx. Ресурс провайдера для этого провайдера называют com/sun/jndi/ldap/jndiprovider.properties. Если класс не находится в пакете, именем ресурса является просто jndiprovider.properties.
Определенные методы в библиотеке классов 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 для деталей. Эта начальная среда тогда наследована другими экземплярами контекста.
Когда библиотека классов 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)` Перечисляет имена, связанные в именованном контексте, наряду с именами классов объектов, связанных с ними.
`NamingEnumeration<NameClassPair>`	`list(String name)` Перечисляет имена, связанные в именованном контексте, наряду с именами классов объектов, связанных с ними.
`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
```
    Постоянный, который содержит имя свойства среды для того, чтобы определить начальную фабрику контекста, чтобы использовать. Значение свойства должно быть полностью определенным именем класса класса фабрики, который создаст начальный контекст. Это свойство может быть определено в параметре среды, который передают начальному конструктору контекста, параметру апплета, системному свойству, или файлу ресурсов приложения. Если это не определяется ни в одном из этих источников, 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
```
    Постоянный, который содержит имя свойства среды для того, чтобы определить список объектных фабрик, чтобы использовать. Значение свойства должно быть разделенным от двоеточия списком полностью определенных имен классов классов фабрики, которые создадут объект, данный информацию об объекте. Это свойство может быть определено в среде, параметре апплета, системном свойстве, или одном или более файлах ресурсов.
    Значение этой константы является "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
```
    Постоянный, который содержит имя свойства среды для того, чтобы определить список фабрик состояния, чтобы использовать. Значение свойства должно быть разделенным от двоеточия списком полностью определенных имен классов классов фабрики состояния, которые будут использоваться, чтобы получить состояние объекта, данное объект непосредственно. Это свойство может быть определено в среде, параметре апплета, системном свойстве, или одном или более файлах ресурсов.
    Значение этой константы является "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. Значение свойства должно быть разделенным от двоеточия списком префиксов пакета для имени класса класса фабрики, который создаст фабрику контекста 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
```
    Постоянный, который содержит имя свойства среды для того, чтобы определить уровень безопасности, чтобы использовать. Его значение является одной из следующих строк: "ни один", "простой", "сильный". Если это свойство является неуказанным, поведение определяется поставщиком услуг.
    Значение этой константы является "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
```
    Перечисляет имена, связанные в именованном контексте, наряду с именами классов объектов, связанных с ними. Содержание любых подконтекстов не включается.
    Если привязка добавляется к или удаляется из этого контекста, его эффект на перечисление, ранее возвращенное, неопределен.
    
    Параметры:
    name - имя контекста, чтобы перечислить
    
    Возвраты:
    перечисление имен и имена классов привязки в этом контексте. Каждый элемент перечисления имеет тип NameClassPair.
    
    Броски:
    
    NamingException - если с исключением именования встречаются
    См. Также:
    list(String), listBindings(Name), NameClassPair
  - список
```
NamingEnumeration<NameClassPair> list(String name)
                                      throws NamingException
```
    Перечисляет имена, связанные в именованном контексте, наряду с именами классов объектов, связанных с ними. См. list(Name) для деталей.
    
    Параметры:
    name - имя контекста, чтобы перечислить
    
    Возвраты:
    перечисление имен и имена классов привязки в этом контексте. Каждый элемент перечисления имеет тип 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
```
    Добавляет новое свойство среды к среде этого контекста. Если свойство уже существует, его значение перезаписывается. См. описание класса для большего количества деталей о свойствах среды.
    
    Параметры:
    propName - имя свойства среды, чтобы добавить; возможно, не нуль
    propVal - значение свойства, чтобы добавить; возможно, не нуль
    
    Возвраты:
    предыдущее значение свойства, или нуль, если свойство не было в среде прежде
    
    Броски:
    
    NamingException - если с исключением именования встречаются
    См. Также:
    getEnvironment(), removeFromEnvironment(String)
  - removeFromEnvironment
```
Object removeFromEnvironment(String propName)
                             throws NamingException
```
    Удаляет свойство среды из среды этого контекста. См. описание класса для большего количества деталей о свойствах среды.
    
    Параметры:
    propName - имя свойства среды, чтобы удалить; возможно, не нуль
    
    Возвраты:
    предыдущее значение свойства, или нуль, если свойство не было в среде
    
    Броски:
    
    NamingException - если с исключением именования встречаются
    См. Также:
    getEnvironment(), addToEnvironment(String, Object)
  - getEnvironment
```
Hashtable<?,?> getEnvironment()
                              throws NamingException
```
    Получает среду в действительности для этого контекста. См. описание класса для большего количества деталей о свойствах среды.
    Вызывающая сторона не должна делать изменения в объекте возвращенными: их эффект на контекст неопределен. Среда этого контекста может быть изменена, используя 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

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Интерфейсный Контекст

Имена

Исключения

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

Параметры

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

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

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

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

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

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

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

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

INITIAL_CONTEXT_FACTORY

OBJECT_FACTORIES

STATE_FACTORIES

URL_PKG_PREFIXES

PROVIDER_URL

DNS_URL

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

BATCHSIZE

ОТСЫЛКА

SECURITY_PROTOCOL

SECURITY_AUTHENTICATION

SECURITY_PRINCIPAL

SECURITY_CREDENTIALS

ЯЗЫК

АППЛЕТ

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

поиск

поиск

связать

связать

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

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

развязать

развязать

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

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

список

список

listBindings

listBindings

destroySubcontext

destroySubcontext

createSubcontext

createSubcontext

lookupLink

lookupLink

getNameParser

getNameParser

composeName

composeName

addToEnvironment

removeFromEnvironment

getEnvironment

близко

getNameInNamespace