Spec-Zone.ru › OpenJDK 21

Класс InitialContext

java.lang.Object
javax.naming.InitialContext
Все реализуемые интерфейсы:
Context
Прямые известные подклассы:
InitialDirContext
public class InitialContext extends Object implements Context
Этот класс является начальным контекстом для выполнения операций именования.

Все операции именования относительны к контексту. Начальный контекст реализует интерфейс Context и предоставляет отправную точку для разрешения имен.

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

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" не равно null, конструктор InitialContext попытается создать начальный контекст, указанный в нем. В этот момент фабрика начального контекста может выбросить исключение, если возникнет проблема. Однако поведение зависит от реализации поставщика, когда он проверяет и указывает пользователям начального контекста любые проблемы, связанные со свойствами окружения или подключением. Он может делать это лениво — откладывая это до выполнения операции с контекстом или сразу при создании контекста.

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

С момента:
1.3, JNDI 1.1
См. также:
  • Context
  • NamingManager.setInitialContextFactoryBuilder

Краткое описание полей

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

Поля, объявленные в интерфейсе javax.naming.Context

APPLET, AUTHORITATIVE, BATCHSIZE, DNS_URL, INITIAL_CONTEXT_FACTORY, LANGUAGE, OBJECT_FACTORIES, PROVIDER_URL, REFERRAL, SECURITY_AUTHENTICATION, SECURITY_CREDENTIALS, SECURITY_PRINCIPAL, SECURITY_PROTOCOL, STATE_FACTORIES, URL_PKG_PREFIXES

Краткое описание конструкторов

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

Краткое описание методов

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

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

myProps

protected Hashtable<Object,Object> myProps
Окружение, связанное с этим InitialContext. Инициализируется значением null и обновляется конструктором, принимающим окружение, или методом 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(). Если true, то результат находится в defaultInitCtx.

Подробное описание конструкторов

InitialContext

protected InitialContext(boolean lazy) throws NamingException
Создаёт начальный контекст с возможностью не инициализировать его. Это может использоваться конструктором подкласса, когда значение параметра environment ещё неизвестно во время вызова конструктора InitialContext. Конструктор подкласса вызовет этот конструктор, вычислит значение environment и затем вызовет init() перед возвратом.
Параметры:
lazy - true означает не инициализировать начальный контекст; false эквивалентно вызову 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 пустое, возвращает новый экземпляр этого контекста (который представляет тот же контекст именования, что и этот контекст, но его окружение можно изменять независимо и к нему можно обращаться одновременно).

Параметризованные типы:
T - тип возвращаемого объекта
Параметры:
name - имя объекта для поиска
Возвращает:
объект, связанный с name
Исключения:
NamingException - если произошла ошибка в управлении именами
С:
1.6
См. также:
  • doLookup(String)
  • lookup(Name)

doLookup

public static <T> T doLookup(String name) throws NamingException
Статический метод для получения объекта по имени. Подробности см. в doLookup(Name).
Параметризованные типы:
T - тип возвращаемого объекта
Параметры:
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) для описания того, как подкласс должен использовать этот метод.

Параметры:
name - Не нулевое имя, для которого нужно получить контекст.
Возвращает:
Контекст URL для name или кэшированный начальный контекст. Результат не может быть null.
Исключения:
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 или кэшированный начальный контекст. Результат не может быть null.
Исключения:
NoInitialContextException - Если начальный контекст не найден.
NamingException - Если произошла ошибка в управлении именами.
См. также:
  • NamingManager.getURLContext(java.lang.String, java.util.Hashtable<?, ?>)

lookup

public Object lookup(String name) throws NamingException
Описание скопировано из интерфейса: Context
Получает объект по имени. Подробности см. в Context.lookup(Name).
Определено в:
lookup в интерфейсе Context
Параметры:
name - имя объекта для поиска
Возвращает:
объект, связанный с name
Исключения:
NamingException - если произошла ошибка в управлении именами

lookup

public Object lookup(Name name) throws NamingException
Описание скопировано из интерфейса: Context
Получает объект по имени. Если name пустое, возвращает новый экземпляр этого контекста (который представляет тот же контекст именования, что и этот контекст, но его окружение можно изменять независимо и к нему можно обращаться одновременно).
Определено в:
lookup в интерфейсе Context
Параметры:
name - имя объекта для поиска
Возвращает:
объект, связанный с name
Исключения:
NamingException - если произошла ошибка в управлении именами
См. также:
  • Context.lookup(String)
  • Context.lookupLink(Name)

bind

public void bind(String name, Object obj) throws NamingException
Описание скопировано из интерфейса: Context
Связывает имя с объектом. Подробности см. в Context.bind(Name, Object).
Указано в:
bind в интерфейсе Context
Параметры:
name - имя для привязки; не может быть пустым
obj - объект для привязки; возможно null
Исключения:
NameAlreadyBoundException - если имя уже привязано
InvalidAttributesException - если объект не предоставил все обязательные атрибуты
NamingException - если возникло исключение при именовании

bind

public void bind(Name name, Object obj) throws NamingException
Описание скопировано из интерфейса: Context
Связывает имя с объектом. Все промежуточные контексты и целевой контекст (названные всеми, кроме конечного атомарного компонента имени) должны уже существовать.
Указано в:
bind в интерфейсе Context
Параметры:
name - имя для привязки; не может быть пустым
obj - объект для привязки; возможно null
Исключения:
NameAlreadyBoundException - если имя уже привязано
InvalidAttributesException - если объект не предоставил все обязательные атрибуты
NamingException - если возникло исключение при именовании
См. также:
  • Context.bind(String, Object)
  • Context.rebind(Name, Object)
  • DirContext.bind(Name, Object, javax.naming.directory.Attributes)

rebind

public void rebind(String name, Object obj) throws NamingException
Описание скопировано из интерфейса: Context
Связывает имя с объектом, перезаписывая любое существующее связывание. Подробности см. в Context.rebind(Name, Object).
Указано в:
rebind в интерфейсе Context
Параметры:
name - имя для привязки; не может быть пустым
obj - объект для привязки; возможно null
Исключения:
InvalidAttributesException - если объект не предоставил все обязательные атрибуты
NamingException - если возникло исключение при именовании

rebind

public void rebind(Name name, Object obj) throws NamingException
Описание скопировано из интерфейса: Context
Связывает имя с объектом, перезаписывая любое существующее связывание. Все промежуточные контексты и целевой контекст (названные всеми, кроме конечного атомарного компонента имени) должны уже существовать.

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

Указано в:
rebind в интерфейсе Context
Параметры:
name - имя для привязки; не может быть пустым
obj - объект для привязки; возможно null
Исключения:
InvalidAttributesException - если объект не предоставил все обязательные атрибуты
NamingException - если возникло исключение при именовании
См. также:
  • Context.rebind(String, Object)
  • Context.bind(Name, Object)
  • DirContext.rebind(Name, Object, javax.naming.directory.Attributes)
  • DirContext

unbind

public void unbind(String name) throws NamingException
Описание скопировано из интерфейса: Context
Отвязывает объект по имени. Подробности см. в Context.unbind(Name).
Указано в:
unbind в интерфейсе Context
Параметры:
name - имя для отвязки; не может быть пустым
Исключения:
NameNotFoundException - если промежуточный контекст не существует
NamingException - если возникло исключение при именовании

unbind

public void unbind(Name name) throws NamingException
Описание скопировано из интерфейса: Context
Отвязывает объект по имени. Удаляет конечное атомарное имя в name из целевого контекста — того, который назван всеми, кроме конечной атомарной части name.

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

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

Указано в:
unbind в интерфейсе Context
Параметры:
name - имя для отвязки; не может быть пустым
Исключения:
NameNotFoundException - если промежуточный контекст не существует
NamingException - если возникло исключение при именовании
См. также:
  • Context.unbind(String)

rename

public void rename(String oldName, String newName) throws NamingException
Описание скопировано из интерфейса: Context
Связывает новое имя с объектом, связанным со старым именем, и отвязывает старое имя. Подробности см. в Context.rename(Name, Name).
Указано в:
rename в интерфейсе Context
Параметры:
oldName - имя существующего связывания; не может быть пустым
newName - имя нового связывания; не может быть пустым
Исключения:
NameAlreadyBoundException - если newName уже привязано
NamingException - если возникло исключение при именовании

rename

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)

list

public NamingEnumeration<NameClassPair> list(String name) throws NamingException
Описание скопировано из интерфейса: Context
Перечисляет имена, привязанные в указанном контексте, а также имена классов объектов, привязанных к ним. Подробности см. в Context.list(Name).
Указано в:
list в интерфейсе Context
Параметры:
name - имя контекста для перечисления
Возвращает:
перечисление имен и имён классов привязок в этом контексте. Каждый элемент перечисления имеет тип NameClassPair.
Исключения:
NamingException - если возникло исключение при именовании

list

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).
Specified by:
listBindings в интерфейсе Context
Параметры:
name - имя контекста для перечисления
Возвращает:
перечисление связей в этом контексте. Каждый элемент перечисления имеет тип Binding.
Исключения:
NamingException - если возникло исключение при работе с именованием

listBindings

public NamingEnumeration<Binding> listBindings(Name name) throws NamingException
Описание скопировано из интерфейса: Context
Перечисляет имена, связанные в указанном контексте, вместе с объектами, связанными с ними. Содержимое любых подконтекстов не включается.

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

Specified by:
listBindings в интерфейсе Context
Параметры:
name - имя контекста для перечисления
Возвращает:
перечисление связей в этом контексте. Каждый элемент перечисления имеет тип Binding.
Исключения:
NamingException - если возникло исключение при работе с именованием
См. также:
  • Context.listBindings(String)
  • Context.list(Name)
  • Binding

destroySubcontext

public void destroySubcontext(String name) throws NamingException
Описание скопировано из интерфейса: Context
Уничтожает указанный контекст и удаляет его из пространства имён. Подробнее см. Context.destroySubcontext(Name).
Specified by:
destroySubcontext в интерфейсе Context
Параметры:
name - имя контекста, который требуется уничтожить; не может быть пустым
Исключения:
NameNotFoundException - если промежуточный контекст не существует
NotContextException - если имя связано, но не указывает на контекст или указывает на контекст неподходящего типа
ContextNotEmptyException - если указанный контекст не пустой
NamingException - если возникло исключение при работе с именованием

destroySubcontext

public void destroySubcontext(Name name) throws NamingException
Описание скопировано из интерфейса: Context
Уничтожает указанный контекст и удаляет его из пространства имён. Все атрибуты, связанные с именем, также удаляются. Промежуточные контексты не уничтожаются.

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

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

Specified by:
destroySubcontext в интерфейсе Context
Параметры:
name - имя контекста, который требуется уничтожить; не может быть пустым
Исключения:
NameNotFoundException - если промежуточный контекст не существует
NotContextException - если имя связано, но не указывает на контекст или указывает на контекст неподходящего типа
ContextNotEmptyException - если указанный контекст не пустой
NamingException - если возникло исключение при работе с именованием
См. также:
  • Context.destroySubcontext(String)

createSubcontext

public Context createSubcontext(String name) throws NamingException
Описание скопировано из интерфейса: Context
Создаёт и связывает новый контекст. Подробнее см. Context.createSubcontext(Name).
Specified by:
createSubcontext в интерфейсе Context
Параметры:
name - имя контекста, который требуется создать; не может быть пустым
Возвращает:
созданный контекст
Исключения:
NameAlreadyBoundException - если имя уже связано
InvalidAttributesException - если создание подконтекста требует указания обязательных атрибутов
NamingException - если возникло исключение при работе с именованием

createSubcontext

public Context createSubcontext(Name name) throws NamingException
Описание скопировано из интерфейса: Context
Создаёт и связывает новый контекст. Создаёт новый контекст с заданным именем и связывает его в целевом контексте (заданном всеми, кроме конечного атомного компонента имени). Все промежуточные и целевой контексты должны уже существовать.
Specified by:
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).
Specified by:
lookupLink в интерфейсе Context
Параметры:
name - имя объекта для поиска
Возвращает:
объект, связанный с name, не следуя конечной ссылке (если таковая есть)
Исключения:
NamingException - если возникло исключение при работе с именованием

lookupLink

public Object lookupLink(Name name) throws NamingException
Описание скопировано из интерфейса: Context
Возвращает указанный объект, следуя ссылкам, за исключением конечного атомного компонента имени. Если объект, связанный с name, не является ссылкой, возвращает сам объект.
Specified by:
lookupLink в интерфейсе Context
Параметры:
name - имя объекта для поиска
Возвращает:
объект, связанный с name, не следуя конечной ссылке (если таковая есть).
Исключения:
NamingException - если возникло исключение при работе с именованием
См. также:
  • Context.lookupLink(String)

getNameParser

public NameParser getNameParser(String name) throws NamingException
Описание скопировано из интерфейса: Context
Возвращает парсер, связанный с указанным контекстом. Подробнее см. Context.getNameParser(Name).
Specified by:
getNameParser в интерфейсе Context
Параметры:
name - имя контекста, из которого получить парсер
Возвращает:
парсер имён, который может разбить составные имена на их атомные компоненты
Исключения:
NamingException - если возникло исключение при работе с именованием

getNameParser

public NameParser getNameParser(Name name) throws NamingException
Описание, скопированное из интерфейса: Context
Получает парсер, связанный с контекстом с заданным именем. В федерации пространств имён различные системы имён будут по-разному парсить имена. Этот метод позволяет приложению получить парсер для разбора имён на их атомарные компоненты с использованием соглашения об именовании конкретной системы имён. Внутри любой одной системы имён объекты, возвращаемые этим методом, должны быть равны (используя тест 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 - имя добавляемой системной переменной; не может быть null
propVal - значение добавляемой переменной; не может быть null
Возвращает:
предыдущее значение переменной или null, если переменная отсутствовала в среде ранее
Исключение:
NamingException - если возникает исключение при работе с системами имён
См. также:
  • Context.getEnvironment()
  • Context.removeFromEnvironment(String)

removeFromEnvironment

public Object removeFromEnvironment(String propName) throws NamingException
Описание, скопированное из интерфейса: Context
Удаляет системную переменную из среды этого контекста. Подробнее об условиях среды см. описание класса.
Указано в:
removeFromEnvironment в интерфейсе Context
Параметры:
propName - имя удаляемой системной переменной; не может быть null
Возвращает:
предыдущее значение переменной или null, если переменная отсутствовала в среде
Исключение:
NamingException - если возникает исключение при работе с системами имён
См. также:
  • Context.getEnvironment()
  • Context.addToEnvironment(String, Object)

getEnvironment

public Hashtable<?,?> getEnvironment() throws NamingException
Описание, скопированное из интерфейса: Context
Возвращает среду, действующую для этого контекста. Подробнее об условиях среды см. описание класса.

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

Указано в:
getEnvironment в интерфейсе Context
Возвращает:
среда этого контекста; никогда не null
Исключение:
NamingException - если возникает исключение при работе с системами имён
См. также:
  • Context.addToEnvironment(String, Object)
  • Context.removeFromEnvironment(String)

close

public void close() throws NamingException
Описание, скопированное из интерфейса: Context
Закрывает этот контекст. Этот метод освобождает ресурсы этого контекста немедленно, вместо ожидания их автоматического освобождения сборщиком мусора.

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

Указано в:
close в интерфейсе Context
Исключение:
NamingException - если возникает исключение при работе с системами имён

getNameInNamespace

public String getNameInNamespace() throws NamingException
Описание, скопированное из интерфейса: Context
Возвращает полное имя этого контекста в собственном пространстве имён.

Многие службы имён имеют понятие «полного имени» для объектов в своих пространствах имён. Например, у записи LDAP есть отличительное имя, а у записи DNS — полное квалифицированное имя. Этот метод позволяет прикладному программному обеспечению получить это имя. Возвращаемая строка этим методом не является составным именем JNDI и не должна передаваться напрямую методам контекста. В системах имён, для которых понятие полного имени не имеет смысла, выбрасывается OperationNotSupportedException.

Указано в:
getNameInNamespace в интерфейсе Context
Возвращает:
имя контекста в собственном пространстве имён; никогда не null
Исключение:
OperationNotSupportedException - если система имён не имеет понятия о полном имени
NamingException - если возникает исключение при работе с системами имён

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.naming/javax/naming/InitialContext.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API