InitialContext (Платформа Java SE 7)

java.lang. Объект
- javax.naming. InitialContext

Все Реализованные Интерфейсы:

Контекст

Прямые Известные Подклассы:

InitialDirContext
```
public class InitialContext
extends Object
implements Context
```
Этот класс является запускающимся контекстом для того, чтобы выполнить операции именования.
Все операции именования относительно контекста. Начальный контекст реализует интерфейс Контекста и обеспечивает начальную точку для разрешения имен.
Когда начальный контекст создается, его среда инициализируется со свойствами, определенными в параметре среды, который передают конструктору, и в любых файлах ресурсов приложения. Кроме того, небольшое количество стандартных свойств JNDI может быть определено как системные свойства или как параметры апплета (с помощью Context.APPLET). Эти специальные свойства перечисляются в полевых разделах детали Context и документации интерфейса LdapContext.
JNDI определяет значение каждого свойства, объединяя значения из следующих двух источников в порядке:
1. Первое возникновение свойства от параметра среды конструктора и (для соответствующих свойств) параметры апплета и системные свойства.
2. Файлы ресурсов приложения (jndi.properties).
Для каждого свойства, найденного в обоих из этих двух источников, или больше чем в одном файле ресурсов приложения, значение свойства определяется следующим образом. Если свойство является одним из стандартных свойств JNDI, которые определяют список фабрик JNDI (см. Context), все значения связываются в единственный разделенный от двоеточия список. Для других свойств только используется первое найденное значение.
Во время выполнения определяется начальная реализация контекста. Политика по умолчанию использует свойство среды"java.naming.factory.initial", который содержит имя класса начальной фабрики контекста. Исключение к этой политике делается, разрешая строки URL, как описано ниже.
Когда строку URL (String формы scheme_id:rest_of_name) передают как параметр имени к любому методу, фабрика контекста URL для того, чтобы обработать ту схему располагается и используется, чтобы разрешить URL. Если никакая такая фабрика не находится, начальный контекст, определенный "java.naming.factory.initial", используется. Точно так же то, когда CompositeName возражает, чей первый компонент является строкой URL, передают как параметр имени к любому методу, фабрика контекста URL располагается и используется, чтобы разрешить компонент имени. См. NamingManager.getURLContext() для описания того, как располагаются фабрики контекста URL.
Эта политика по умолчанию определения местоположения начального контекста и фабрик контекста URL может быть переопределена, вызывая NamingManager.setInitialContextFactoryBuilder().
NoInitialContextException бросается, когда начальный контекст нельзя инстанцировать. Это исключение может быть выдано во время любого взаимодействия с InitialContext, не только когда InitialContext создается. Например, реализация начального контекста могла бы лениво получить контекст только, когда фактические методы вызываются на это. У приложения не должно быть никакой зависимости от того, когда существование начального контекста определяется.
Когда свойство среды "java.naming.factory.initial" будет ненулем, конструктор InitialContext попытается создать начальный контекст, определенный там. Тогда, начальная включенная фабрика контекста могла бы выдать исключение, если с проблемой встречаются. Однако, это - провайдер, зависящий от реализации, когда это проверяет и указывает пользователям начального контекста на любое свойство среды - или соединение - связанные проблемы. Это может сделать так лениво - задерживающийся, пока работа не выполняется на контексте, или нетерпеливо, в то время, когда контекст создается.
Экземпляр InitialContext не синхронизируется против параллельного доступа многократными потоками. Многократные потоки каждое управление различным экземпляром InitialContext не должны синхронизироваться. Потоки, которые должны получить доступ к единственному экземпляру InitialContext одновременно, должны синхронизироваться среди себя и обеспечить необходимую блокировку.
С тех пор:

JNDI 1.1 / Java 2 Платформы, Standard Edition, v 1.3

См. Также:
Context, NamingManager.setInitialContextFactoryBuilder

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

Поля
Модификатор и Тип	Поле и Описание
`protected Context`	`defaultInitCtx` Поле, содержащее результат вызова NamingManager.getInitialContext ().
`protected boolean`	`gotDefault` Поле, указывающее, был ли начальный контекст получен, вызывая NamingManager.getInitialContext ().
`protected Hashtable<Object,Object>`	`myProps` Среда связалась с этим InitialContext.

Поля, наследованные от интерфейса javax.naming. Контекст
APPLET, AUTHORITATIVE, BATCHSIZE, DNS_URL, INITIAL_CONTEXT_FACTORY, LANGUAGE, OBJECT_FACTORIES, PROVIDER_URL, REFERRAL, SECURITY_AUTHENTICATION, SECURITY_CREDENTIALS, SECURITY_PRINCIPAL, SECURITY_PROTOCOL, STATE_FACTORIES, URL_PKG_PREFIXES

Сводка конструктора

Конструкторы
Модификатор	Конструктор и Описание
	`InitialContext()` Создает начальный контекст.
`protected`	`InitialContext(boolean lazy)` Создает начальный контекст с опцией не инициализации этого.
	`InitialContext(Hashtable<?,?> environment)` Создает начальный контекст, используя предоставленную среду.

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

Методы
Модификатор и Тип	Метод и Описание
`Объект`	`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)` Уничтожает именованный контекст и удаляет это из пространства имен.
`static <T> T`	`doLookup(Name name)` Статический метод, чтобы получить именованный объект.
`static <T> T`	`doLookup(String name)` Статический метод, чтобы получить именованный объект.
`protected Context`	`getDefaultInitCtx()` Получает начальный контекст, вызывая `NamingManager.getInitialContext()` и кэш это в defaultInitCtx.
`Hashtable<?,?>`	`getEnvironment()` Получает среду в действительности для этого контекста.
`Строка`	`getNameInNamespace()` Получает полное имя этого контекста в пределах его собственного пространства имен.
`NameParser`	`getNameParser(Name name)` Получает синтаксический анализатор, связанный с именованным контекстом.
`NameParser`	`getNameParser(String name)` Получает синтаксический анализатор, связанный с именованным контекстом.
`protected Context`	`getURLOrDefaultInitCtx(Name name)` Получает контекст для того, чтобы решить `name`.
`protected Context`	`getURLOrDefaultInitCtx(String name)` Получает контекст для того, чтобы разрешить имя строки `name`.
`protected void`	`init(Hashtable<?,?> environment)` Инициализирует начальный контекст, используя предоставленную среду.
`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)` Развязывает именованный объект.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Полевая Деталь
  - myProps
```
protected Hashtable<Object,Object> myProps
```
    Среда связалась с этим InitialContext. Это инициализируется к нулю и обновляется конструктором, который принимает среду или методом init().
    
    См. Также:
    addToEnvironment(java.lang.String, java.lang.Object), removeFromEnvironment(java.lang.String), getEnvironment()
  - defaultInitCtx
```
protected Context defaultInitCtx
```
    Поле, содержащее результат вызова NamingManager.getInitialContext (). Это устанавливается getDefaultInitCtx (), первый раз getDefaultInitCtx () вызывают. Последующие вызовы getDefaultInitCtx () возвращают значение defaultInitCtx.
    
    См. Также:
    getDefaultInitCtx()
  - gotDefault
```
protected boolean gotDefault
```
    Поле, указывающее, был ли начальный контекст получен, вызывая NamingManager.getInitialContext (). Если это правда, его результат находится в defaultInitCtx.
- Деталь конструктора
  - InitialContext
```
protected InitialContext(boolean lazy)
                  throws NamingException
```
    Создает начальный контекст с опцией не инициализации этого. Это может использоваться конструктором в подклассе, когда значение параметра среды еще не известно в то время, когда конструктора InitialContext вызывают. Конструктор подкласса вызовет этого конструктора, вычислит значение среды, и затем вызовет init() перед возвратом.
    
    Параметры:
    lazy - истинные средства не инициализируют начальный контекст; ложь эквивалентна вызову new InitialContext()
    
    Броски:
    
    NamingException - если с исключением именования встречаются
    С тех пор:
    
    1.3
    
    См. Также:
    init(Hashtable)
  - InitialContext
```
public InitialContext()
               throws NamingException
```
    Создает начальный контекст. Никакие свойства среды не предоставляются. Эквивалентный new InitialContext(null).
    
    Броски:
    
    NamingException - если с исключением именования встречаются
    См. Также:
    InitialContext(Hashtable)
  - InitialContext
```
public InitialContext(Hashtable<?,?> environment)
               throws NamingException
```
    Создает начальный контекст, используя предоставленную среду. Свойства среды обсуждаются в описании класса.
    Этот конструктор не будет изменять environment или сохранять ссылку на него, но может спасти клона. Вызывающая сторона не должна изменить изменчивые ключи и значения в environment после того, как это передали конструктору.
    
    Параметры:
    environment - среда, используемая, чтобы создать начальный контекст. Нуль указывает на пустую среду.
    
    Броски:
    
    NamingException - если с исключением именования встречаются
- Деталь метода
  - init
```
protected void init(Hashtable<?,?> environment)
             throws NamingException
```
    Инициализирует начальный контекст, используя предоставленную среду. Свойства среды обсуждаются в описании класса.
    Этот метод изменит environment и сохранит ссылку на него. Вызывающая сторона больше, возможно, не изменяет это.
    
    Параметры:
    environment - среда, используемая, чтобы создать начальный контекст. Нуль указывает на пустую среду.
    
    Броски:
    
    NamingException - если с исключением именования встречаются
    С тех пор:
    
    1.3
    
    См. Также:
    InitialContext(boolean)
  - doLookup
```
public static <T> T doLookup(Name name)
                  throws NamingException
```
    Статический метод, чтобы получить именованный объект. Это - метод ярлыка, эквивалентный вызову:
    InitialContext ic = new InitialContext(); Object obj = ic.lookup();
    Если name пуст, возвращает новый экземпляр этого контекста (который представляет тот же самый контекст именования как этот контекст, но его среда может быть изменена независимо, и к этому можно получить доступ одновременно).
    
    Параметры:
    name - имя объекта искать
    
    Возвраты:
    объект, связанный с name
    
    Броски:
    
    NamingException - если с исключением именования встречаются
    С тех пор:
    
    1.6
    
    См. Также:
    doLookup(String), lookup(Name)
  - doLookup
```
public static <T> T doLookup(String name)
                  throws NamingException
```
    Статический метод, чтобы получить именованный объект. См. doLookup(Name) для деталей.
    
    Параметры:
    name - имя объекта искать
    
    Возвраты:
    объект, связанный с name
    
    Броски:
    
    NamingException - если с исключением именования встречаются
    С тех пор:
    
    1.6
  - getDefaultInitCtx
```
protected Context getDefaultInitCtx()
                             throws NamingException
```
    Получает начальный контекст, вызывая NamingManager.getInitialContext() и кэш это в defaultInitCtx. Набор gotDefault так, чтобы мы знали, что попробовали это прежде.
    
    Возвраты:
    Ненуль кэшируемый начальный контекст.
    
    Броски:
    
    NoInitialContextException - Если не может найти начальный контекст.
    
    NamingException - Если с исключением именования встретились.
  - getURLOrDefaultInitCtx
```
protected Context getURLOrDefaultInitCtx(String name)
                                  throws NamingException
```
    Получает контекст для того, чтобы разрешить имя строки name. Если name имя является строкой URL, затем попытайтесь найти контекст URL для него. Если ни один не находится, или если name не строка URL, затем возвратитесь getDefaultInitCtx().
    См. getURLOrDefaultInitCtx (Имя) для описания того, как подкласс должен использовать этот метод.
    
    Параметры:
    name - Ненулевое имя, для которого можно получить контекст.
    
    Возвраты:
    Контекст URL для name или кэшируемый начальный контекст. Результатом не может быть нуль.
    
    Броски:
    
    NoInitialContextException - Если не может найти начальный контекст.
    
    NamingException - В именовании встречаются с исключением.
    См. Также:
    NamingManager.getURLContext(java.lang.String, java.util.Hashtable<?, ?>)
  - getURLOrDefaultInitCtx
```
protected Context getURLOrDefaultInitCtx(Name name)
                                  throws NamingException
```
    Получает контекст для того, чтобы решить name. Если первый компонент name имя является строкой URL, затем попытайтесь найти контекст URL для него. Если ни один не находится, или если первый компонент name не строка URL, затем возвратитесь getDefaultInitCtx().
    Создавая подкласс InitialContext, используйте этот метод следующим образом. Определите новый метод, который использует этот метод, чтобы получить начальный контекст требуемого подкласса.
    protected XXXContext getURLOrDefaultInitXXXCtx(Name name) throws NamingException { Context answer = getURLOrDefaultInitCtx(name); if (!(answer instanceof XXXContext)) { if (answer == null) { throw new NoInitialContextException(); } else { throw new NotContextException("Not an XXXContext"); } } return (XXXContext)answer; }
    Обеспечивая реализации для новых методов в подклассе, используйте этот недавно определенный метод, чтобы получить начальный контекст.
    public Object XXXMethod1(Name name, ...) { throws NamingException { return getURLOrDefaultInitXXXCtx(name).XXXMethod1(name, ...); }
    Параметры:
    name - Ненулевое имя, для которого можно получить контекст.
    
    Возвраты:
    Контекст URL для name или кэшируемый начальный контекст. Результатом не может быть нуль.
    
    Броски:
    
    NoInitialContextException - Если не может найти начальный контекст.
    
    NamingException - В именовании встречаются с исключением.
    См. Также:
    NamingManager.getURLContext(java.lang.String, java.util.Hashtable<?, ?>)
  - поиск
```
public Object lookup(String name)
              throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Получает именованный объект. См. Context.lookup(Name) для деталей.
    
    Определенный:
    
    lookup в интерфейсе Context
    
    Параметры:
    name - имя объекта искать
    
    Возвраты:
    объект, связанный с name
    
    Броски:
    
    NamingException - если с исключением именования встречаются
  - поиск
```
public Object lookup(Name name)
              throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Получает именованный объект. Если name пуст, возвращает новый экземпляр этого контекста (который представляет тот же самый контекст именования как этот контекст, но его среда может быть изменена независимо, и к этому можно получить доступ одновременно).
    
    Определенный:
    
    lookup в интерфейсе Context
    
    Параметры:
    name - имя объекта искать
    
    Возвраты:
    объект, связанный с name
    
    Броски:
    
    NamingException - если с исключением именования встречаются
    См. Также:
    Context.lookup(String), Context.lookupLink(Name)
  - связать
```
public void bind(String name,
        Object obj)
          throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Связывает имя к объекту. См. Context.bind(Name, Object) для деталей.
    
    Определенный:
    
    bind в интерфейсе Context
    
    Параметры:
    name - имя, чтобы связать; возможно, не пусто
    obj - объект связать; возможно нуль
    
    Броски:
    
    NameAlreadyBoundException - если имя уже связывается
    
    InvalidAttributesException - если объект не предоставлял все обязательные атрибуты
    
    NamingException - если с исключением именования встречаются
  - связать
```
public void bind(Name name,
        Object obj)
          throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Связывает имя к объекту. Все промежуточные контексты и целевой контекст (названное всеми кроме терминального атомарного компонента имени) должны уже существовать.
    
    Определенный:
    
    bind в интерфейсе Context
    
    Параметры:
    name - имя, чтобы связать; возможно, не пусто
    obj - объект связать; возможно нуль
    
    Броски:
    
    NameAlreadyBoundException - если имя уже связывается
    
    InvalidAttributesException - если объект не предоставлял все обязательные атрибуты
    
    NamingException - если с исключением именования встречаются
    См. Также:
    Context.bind(String, Object), Context.rebind(Name, Object), DirContext.bind(Name, Object, javax.naming.directory.Attributes)
  - снова переплести
```
public void rebind(String name,
          Object obj)
            throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Связывает имя к объекту, перезаписывая любую существующую привязку. См. Context.rebind(Name, Object) для деталей.
    
    Определенный:
    
    rebind в интерфейсе Context
    
    Параметры:
    name - имя, чтобы связать; возможно, не пусто
    obj - объект связать; возможно нуль
    
    Броски:
    
    InvalidAttributesException - если объект не предоставлял все обязательные атрибуты
    
    NamingException - если с исключением именования встречаются
  - снова переплести
```
public void rebind(Name name,
          Object obj)
            throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Связывает имя к объекту, перезаписывая любую существующую привязку. Все промежуточные контексты и целевой контекст (названное всеми кроме терминального атомарного компонента имени) должны уже существовать.
    Если объектом является DirContext, любые существующие атрибуты, связанные с именем, заменяются таковыми из объекта. Иначе, любые существующие атрибуты, связанные с именем, остаются неизменными.
    
    Определенный:
    
    rebind в интерфейсе Context
    
    Параметры:
    name - имя, чтобы связать; возможно, не пусто
    obj - объект связать; возможно нуль
    
    Броски:
    
    InvalidAttributesException - если объект не предоставлял все обязательные атрибуты
    
    NamingException - если с исключением именования встречаются
    См. Также:
    Context.rebind(String, Object), Context.bind(Name, Object), DirContext.rebind(Name, Object, javax.naming.directory.Attributes), DirContext
  - развязать
```
public void unbind(String name)
            throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Развязывает именованный объект. См. Context.unbind(Name) для деталей.
    
    Определенный:
    
    unbind в интерфейсе Context
    
    Параметры:
    name - имя, чтобы развязать; возможно, не пусто
    
    Броски:
    
    NameNotFoundException - если промежуточный контекст не существует
    
    NamingException - если с исключением именования встречаются
  - развязать
```
public void unbind(Name name)
            throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Развязывает именованный объект. Удаляет терминальное атомарное имя в name от целевого контекста - названное всеми кроме терминальной атомарной части name.
    Этот метод является идемпотентом. Это успешно выполняется, даже если терминальное атомарное имя не связывается в целевом контексте, но бросает NameNotFoundException, если какой-либо из промежуточных контекстов не существует.
    Удаляются любые атрибуты, связанные с именем. Промежуточные контексты не изменяются.
    
    Определенный:
    
    unbind в интерфейсе Context
    
    Параметры:
    name - имя, чтобы развязать; возможно, не пусто
    
    Броски:
    
    NameNotFoundException - если промежуточный контекст не существует
    
    NamingException - если с исключением именования встречаются
    См. Также:
    Context.unbind(String)
  - переименовать
```
public void rename(String oldName,
          String newName)
            throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Связывает новое имя к объекту, связанному со старым названием, и развязывает старое название. См. Context.rename(Name, Name) для деталей.
    
    Определенный:
    
    rename в интерфейсе Context
    
    Параметры:
    oldName - имя существующей привязки; возможно, не пусто
    newName - имя новой привязки; возможно, не пусто
    
    Броски:
    
    NameAlreadyBoundException - если newName уже связывается
    
    NamingException - если с исключением именования встречаются
  - переименовать
```
public void rename(Name oldName,
          Name newName)
            throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Связывает новое имя к объекту, связанному со старым названием, и развязывает старое название. Оба имени относительно этого контекста. Любые атрибуты, связанные со старым названием, становятся связанными с новым именем. Промежуточные контексты старого названия не изменяются.
    
    Определенный:
    
    rename в интерфейсе Context
    
    Параметры:
    oldName - имя существующей привязки; возможно, не пусто
    newName - имя новой привязки; возможно, не пусто
    
    Броски:
    
    NameAlreadyBoundException - если newName уже связывается
    
    NamingException - если с исключением именования встречаются
    См. Также:
    Context.rename(String, String), Context.bind(Name, Object), Context.rebind(Name, Object)
  - список
```
public NamingEnumeration<NameClassPair> list(String name)
                                      throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Перечисляет имена, связанные в именованном контексте, наряду с именами классов объектов, связанных с ними. См. Context.list(Name) для деталей.
    
    Определенный:
    
    list в интерфейсе Context
    
    Параметры:
    name - имя контекста, чтобы перечислить
    
    Возвраты:
    перечисление имен и имена классов привязки в этом контексте. Каждый элемент перечисления имеет тип NameClassPair.
    
    Броски:
    
    NamingException - если с исключением именования встречаются
  - список
```
public NamingEnumeration<NameClassPair> list(Name name)
                                      throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Перечисляет имена, связанные в именованном контексте, наряду с именами классов объектов, связанных с ними. Содержание любых подконтекстов не включается.
    Если привязка добавляется к или удаляется из этого контекста, его эффект на перечисление, ранее возвращенное, неопределен.
    
    Определенный:
    
    list в интерфейсе Context
    
    Параметры:
    name - имя контекста, чтобы перечислить
    
    Возвраты:
    перечисление имен и имена классов привязки в этом контексте. Каждый элемент перечисления имеет тип NameClassPair.
    
    Броски:
    
    NamingException - если с исключением именования встречаются
    См. Также:
    Context.list(String), Context.listBindings(Name), NameClassPair
  - listBindings
```
public NamingEnumeration<Binding> listBindings(String name)
                                        throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Перечисляет имена, связанные в именованном контексте, наряду с объектами, связанными с ними. См. Context.listBindings(Name) для деталей.
    
    Определенный:
    
    listBindings в интерфейсе Context
    
    Параметры:
    name - имя контекста, чтобы перечислить
    
    Возвраты:
    перечисление привязки в этом контексте. Каждый элемент перечисления имеет тип Binding.
    
    Броски:
    
    NamingException - если с исключением именования встречаются
  - listBindings
```
public NamingEnumeration<Binding> listBindings(Name name)
                                        throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Перечисляет имена, связанные в именованном контексте, наряду с объектами, связанными с ними. Содержание любых подконтекстов не включается.
    Если привязка добавляется к или удаляется из этого контекста, его эффект на перечисление, ранее возвращенное, неопределен.
    
    Определенный:
    
    listBindings в интерфейсе Context
    
    Параметры:
    name - имя контекста, чтобы перечислить
    
    Возвраты:
    перечисление привязки в этом контексте. Каждый элемент перечисления имеет тип Binding.
    
    Броски:
    
    NamingException - если с исключением именования встречаются
    См. Также:
    Context.listBindings(String), Context.list(Name), Binding
  - destroySubcontext
```
public void destroySubcontext(String name)
                       throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Уничтожает именованный контекст и удаляет это из пространства имен. См. Context.destroySubcontext(Name) для деталей.
    
    Определенный:
    
    destroySubcontext в интерфейсе Context
    
    Параметры:
    name - имя контекста, который будет уничтожен; возможно, не пусто
    
    Броски:
    
    NameNotFoundException - если промежуточный контекст не существует
    
    NotContextException - если имя связывается, но не называет контекст, или не называет контекст соответствующего типа
    
    ContextNotEmptyException - если именованный контекст не пуст
    
    NamingException - если с исключением именования встречаются
  - destroySubcontext
```
public void destroySubcontext(Name name)
                       throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Уничтожает именованный контекст и удаляет это из пространства имен. Любые атрибуты, связанные с именем, также удаляются. Промежуточные контексты не уничтожаются.
    Этот метод является идемпотентом. Это успешно выполняется, даже если терминальное атомарное имя не связывается в целевом контексте, но бросает NameNotFoundException, если какой-либо из промежуточных контекстов не существует.
    В объединенной в федерацию системе именования контекст от одной системы именования может быть ограничен к имени в другом. Можно впоследствии искать и выполнить операции на внешнем контексте, используя составное имя. Однако, попытка уничтожают контекст, используя это составное имя, перестанет работать с NotContextException, потому что внешний контекст не является "подконтекстом" контекста, в котором это связывается. Вместо этого используйте unbind(), чтобы удалить привязку внешнего контекста. Уничтожение внешнего контекста требует, чтобы destroySubcontext() был выполнен на контексте от "собственной" системы именования внешнего контекста.
    
    Определенный:
    
    destroySubcontext в интерфейсе Context
    
    Параметры:
    name - имя контекста, который будет уничтожен; возможно, не пусто
    
    Броски:
    
    NameNotFoundException - если промежуточный контекст не существует
    
    NotContextException - если имя связывается, но не называет контекст, или не называет контекст соответствующего типа
    
    ContextNotEmptyException - если именованный контекст не пуст
    
    NamingException - если с исключением именования встречаются
    См. Также:
    Context.destroySubcontext(String)
  - createSubcontext
```
public Context createSubcontext(String name)
                         throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Создает и ограничивает новый контекст. См. Context.createSubcontext(Name) для деталей.
    
    Определенный:
    
    createSubcontext в интерфейсе Context
    
    Параметры:
    name - имя контекста, чтобы создать; возможно, не пусто
    
    Возвраты:
    недавно создаваемый контекст
    
    Броски:
    
    NameAlreadyBoundException - если имя уже связывается
    
    InvalidAttributesException - если создание подконтекста требует спецификации обязательных атрибутов
    
    NamingException - если с исключением именования встречаются
  - createSubcontext
```
public Context createSubcontext(Name name)
                         throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Создает и ограничивает новый контекст. Создает новый контекст с именем и связывает это в целевом контексте (названное всеми кроме терминального атомарного компонента имени). Все промежуточные контексты и целевой контекст должны уже существовать.
    
    Определенный:
    
    createSubcontext в интерфейсе Context
    
    Параметры:
    name - имя контекста, чтобы создать; возможно, не пусто
    
    Возвраты:
    недавно создаваемый контекст
    
    Броски:
    
    NameAlreadyBoundException - если имя уже связывается
    
    InvalidAttributesException - если создание подконтекста требует спецификации обязательных атрибутов
    
    NamingException - если с исключением именования встречаются
    См. Также:
    Context.createSubcontext(String), DirContext.createSubcontext(javax.naming.Name, javax.naming.directory.Attributes)
  - lookupLink
```
public Object lookupLink(String name)
                  throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Получает именованный объект, ссылки за исключением терминального атомарного компонента имени. См. Context.lookupLink(Name) для деталей.
    
    Определенный:
    
    lookupLink в интерфейсе Context
    
    Параметры:
    name - имя объекта искать
    
    Возвраты:
    объект, связанный с name, не после терминальной ссылки (если любой)
    
    Броски:
    
    NamingException - если с исключением именования встречаются
  - lookupLink
```
public Object lookupLink(Name name)
                  throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Получает именованный объект, ссылки за исключением терминального атомарного компонента имени. Если объект, связанный с name, не является ссылкой, возвращает объект непосредственно.
    
    Определенный:
    
    lookupLink в интерфейсе Context
    
    Параметры:
    name - имя объекта искать
    
    Возвраты:
    объект, связанный с name, не после терминальной ссылки (если любой).
    
    Броски:
    
    NamingException - если с исключением именования встречаются
    См. Также:
    Context.lookupLink(String)
  - getNameParser
```
public NameParser getNameParser(String name)
                         throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Получает синтаксический анализатор, связанный с именованным контекстом. См. Context.getNameParser(Name) для деталей.
    
    Определенный:
    
    getNameParser в интерфейсе Context
    
    Параметры:
    name - имя контекста, от которого можно получить синтаксический анализатор
    
    Возвраты:
    синтаксический анализатор имени, который может проанализировать составные имена в их атомарные компоненты
    
    Броски:
    
    NamingException - если с исключением именования встречаются
  - getNameParser
```
public NameParser getNameParser(Name name)
                         throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Получает синтаксический анализатор, связанный с именованным контекстом. В федерации пространств имен различные системы именования проанализируют имена по-другому. Этот метод позволяет приложению получать синтаксический анализатор для того, чтобы он проанализировал имена в их атомарные компоненты, используя соглашение о присвоении имен определенной системы именования. В пределах любой единственной системы именования объекты NameParser, возвращенные этим методом, должны быть равными (использование теста equals()).
    
    Определенный:
    
    getNameParser в интерфейсе Context
    
    Параметры:
    name - имя контекста, от которого можно получить синтаксический анализатор
    
    Возвраты:
    синтаксический анализатор имени, который может проанализировать составные имена в их атомарные компоненты
    
    Броски:
    
    NamingException - если с исключением именования встречаются
    См. Также:
    Context.getNameParser(String), CompoundName
  - composeName
```
public String composeName(String name,
                 String prefix)
                   throws NamingException
```
    Составляет имя этого контекста с именем относительно этого контекста. Так как начальный контекст никогда нельзя называть относительно никакого контекста кроме себя, значение параметра prefix должно быть пустым названием ("").
    
    Определенный:
    
    composeName в интерфейсе Context
    
    Параметры:
    name - имя относительно этого контекста
    prefix - имя этого контекстно-зависимого одному из его предков
    
    Возвраты:
    состав prefix и name
    
    Броски:
    
    NamingException - если с исключением именования встречаются
  - composeName
```
public Name composeName(Name name,
               Name prefix)
                 throws NamingException
```
    Составляет имя этого контекста с именем относительно этого контекста. Так как начальный контекст никогда нельзя называть относительно никакого контекста кроме себя, значение параметра prefix должно быть пустым названием.
    
    Определенный:
    
    composeName в интерфейсе Context
    
    Параметры:
    name - имя относительно этого контекста
    prefix - имя этого контекстно-зависимого одному из его предков
    
    Возвраты:
    состав prefix и name
    
    Броски:
    
    NamingException - если с исключением именования встречаются
    См. Также:
    Context.composeName(String, String)
  - addToEnvironment
```
public Object addToEnvironment(String propName,
                      Object propVal)
                        throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Добавляет новое свойство среды к среде этого контекста. Если свойство уже существует, его значение перезаписывается. См. описание класса для большего количества деталей о свойствах среды.
    
    Определенный:
    
    addToEnvironment в интерфейсе Context
    
    Параметры:
    propName - имя свойства среды, чтобы добавить; возможно, не нуль
    propVal - значение свойства, чтобы добавить; возможно, не нуль
    
    Возвраты:
    предыдущее значение свойства, или нуль, если свойство не было в среде прежде
    
    Броски:
    
    NamingException - если с исключением именования встречаются
    См. Также:
    Context.getEnvironment(), Context.removeFromEnvironment(String)
  - removeFromEnvironment
```
public Object removeFromEnvironment(String propName)
                             throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Удаляет свойство среды из среды этого контекста. См. описание класса для большего количества деталей о свойствах среды.
    
    Определенный:
    
    removeFromEnvironment в интерфейсе Context
    
    Параметры:
    propName - имя свойства среды, чтобы удалить; возможно, не нуль
    
    Возвраты:
    предыдущее значение свойства, или нуль, если свойство не было в среде
    
    Броски:
    
    NamingException - если с исключением именования встречаются
    См. Также:
    Context.getEnvironment(), Context.addToEnvironment(String, Object)
  - getEnvironment
```
public Hashtable<?,?> getEnvironment()
                              throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Получает среду в действительности для этого контекста. См. описание класса для большего количества деталей о свойствах среды.
    Вызывающая сторона не должна делать изменения в объекте возвращенными: их эффект на контекст неопределен. Среда этого контекста может быть изменена, используя addToEnvironment() и removeFromEnvironment().
    
    Определенный:
    
    getEnvironment в интерфейсе Context
    
    Возвраты:
    среда этого контекста; никогда не обнуляйте
    
    Броски:
    
    NamingException - если с исключением именования встречаются
    См. Также:
    Context.addToEnvironment(String, Object), Context.removeFromEnvironment(String)
  - близко
```
public void close()
           throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Завершения этот контекст. Этот метод сразу высвобождает средства этого контекста, вместо того, чтобы ожидать их, чтобы быть выпущенным автоматически сборщиком "мусора".
    Этот метод является идемпотентом: вызов этого на контексте, который был уже закрыт, не имеет никакого эффекта. Вызов любого другого метода на закрытом контексте не позволяется, и приводит к неопределенному поведению.
    
    Определенный:
    
    close в интерфейсе Context
    
    Броски:
    
    NamingException - если с исключением именования встречаются
  - getNameInNamespace
```
public String getNameInNamespace()
                          throws NamingException
```
    Описание скопировало с интерфейса: Context
    
    Получает полное имя этого контекста в пределах его собственного пространства имен.
    У многих служб именования есть понятие "полного имени" для объектов в их соответствующих пространствах имен. Например, у записи LDAP есть отличительное имя, и у записи DNS есть полностью определенное имя. Этот метод позволяет клиентскому приложению получать это имя. Строка, возвращенная этим методом, не является именем составного объекта JNDI и не должна быть передана непосредственно к методам контекста. В именовании систем, для которых понятие полного имени не имеет смысла, бросается OperationNotSupportedException.
    
    Определенный:
    
    getNameInNamespace в интерфейсе Context
    
    Возвраты:
    имя этого контекста в его собственном пространстве имен; никогда не обнуляйте
    
    Броски:
    
    OperationNotSupportedException - если у системы именования нет понятия полного имени
    
    NamingException - если с исключением именования встречаются

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

Класс InitialContext

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

Поля, наследованные от интерфейса javax.naming. Контекст

Сводка конструктора

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

Методы java.lang унаследованный от класса. Объект

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

myProps

defaultInitCtx

gotDefault

Деталь конструктора

InitialContext

InitialContext

InitialContext

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

init

doLookup

doLookup

getDefaultInitCtx

getURLOrDefaultInitCtx

getURLOrDefaultInitCtx

поиск

поиск

связать

связать

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

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

развязать

развязать

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

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

список

список

listBindings

listBindings

destroySubcontext

destroySubcontext

createSubcontext

createSubcontext

lookupLink

lookupLink

getNameParser

getNameParser

composeName

composeName

addToEnvironment

removeFromEnvironment

getEnvironment

близко

getNameInNamespace