Spec-Zone.ru › OpenJDK 8

Пакет javax.naming

Предоставляет классы и интерфейсы для доступа к службам именования.

См.: Описание

Интерфейс Описание
Context

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

Name

Интерфейс Name представляет общее имя — упорядоченную последовательность компонентов.

NameParser

Этот интерфейс используется для разбора имен из иерархического пространства имен.

NamingEnumeration<T>

Этот интерфейс предназначен для перечисления списков, возвращаемых методами в пакетах javax.naming и javax.naming.directory.

Referenceable

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

Класс Описание
BinaryRefAddr

Этот класс представляет двоичную форму адреса конечной точки связи.

Binding

Этот класс представляет привязку имя-объект, найденную в контексте.

CompositeName

Этот класс представляет составное имя — последовательность имен компонентов, охватывающих несколько пространств имен.

CompoundName

Этот класс представляет составное имя — имя из иерархического пространства имен.

InitialContext

Этот класс является начальным контекстом для выполнения операций именования.

LinkRef

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

NameClassPair

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

RefAddr

Этот класс представляет адрес конечной точки связи.

Reference

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

StringRefAddr

Этот класс представляет строковую форму адреса конечной точки связи.

Исключение Описание
AuthenticationException

Это исключение генерируется при возникновении ошибки аутентификации при доступе к службе именования или каталога.

AuthenticationNotSupportedException

Это исключение генерируется, когда конкретный тип запрошенной аутентификации не поддерживается.

CannotProceedException

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

CommunicationException

Это исключение генерируется, когда клиент не может взаимодействовать со службой каталога или именования.

ConfigurationException

Это исключение генерируется при возникновении проблемы конфигурации.

ContextNotEmptyException

Это исключение генерируется при попытке уничтожить непустой контекст.

InsufficientResourcesException

Это исключение генерируется, когда ресурсы недоступны для выполнения запрошенной операции.

InterruptedNamingException

Это исключение генерируется, когда операция именования, которая вызывается, была прервана.

InvalidNameException

Это исключение указывает, что указанное имя не соответствует синтаксису именования в системе именования.

LimitExceededException

Это исключение генерируется, когда метод завершается аномально из-за превышения пользователем или системой заданного предела.

LinkException

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

LinkLoopException

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

MalformedLinkException

Это исключение генерируется при обнаружении некорректной ссылки при разрешении или построении ссылки.

NameAlreadyBoundException

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

NameNotFoundException

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

NamingException

Это базовый класс всех исключений, генерируемых операциями в интерфейсах Context и DirContext.

NamingSecurityException

Это базовый класс исключений, связанных с безопасностью, генерируемых операциями в интерфейсах Context и DirContext.

NoInitialContextException

Это исключение генерируется, когда не удается создать реализацию начального контекста.

NoPermissionException

Это исключение генерируется при попытке выполнить операцию, на которую у клиента нет разрешения.

NotContextException

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

OperationNotSupportedException

Это исключение генерируется, когда реализация контекста не поддерживает вызываемую операцию.

PartialResultException

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

ReferralException

Этот абстрактный класс используется для представления исключения перенаправления, которое генерируется в ответ на перенаправление, такое как то, которое возвращают серверы LDAP v3.

ServiceUnavailableException

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

SizeLimitExceededException

Это исключение генерируется, когда метод создает результат, превышающий ограничение, связанное с размером.

TimeLimitExceededException

Это исключение генерируется, когда метод не завершается в течение заданного времени.

Описание пакета javax.naming

Предоставляет классы и интерфейсы для доступа к службам именования.

Этот пакет определяет операции именования для Java Naming and Directory InterfaceTM (JNDI). JNDI предоставляет функциональность именования и каталогов для приложений, написанных на языке программирования Java. Он разработан для независимости от любой конкретной реализации службы именования или каталога. Таким образом, к различным службам — новым, появляющимся и уже развернутым — можно получить доступ стандартным образом.

Контекст

Этот пакет определяет понятие контекста, представленного интерфейсом Context. Контекст состоит из набора связей «имя-объект». Context является основным интерфейсом для поиска, связывания, разрыва связей и переименования объектов, а также для создания и удаления подконтекстов.

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

Printer printer = (Printer)ctx.lookup("treekiller");
printer.print(report);

Имена

Каждый метод именования в интерфейсе Context имеет две перегрузки: одна принимает аргумент Name, а другая — строковое имя. Name — это интерфейс, представляющий общее имя — упорядоченную последовательность из нуля или более компонентов. Для этих методов Name может использоваться для представления составного имени (CompositeName), чтобы вы могли именовать объект с помощью имени, охватывающего несколько пространств имен.

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

Связи

Класс Binding представляет собой связывание «имя-объект». Он представляет собой кортеж, содержащий имя связанного объекта, имя класса объекта и сам объект.

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

Ссылки

Объекты хранятся в службах именования и каталогов различными способами. Если хранилище объектов поддерживает хранение объектов Java, оно может поддерживать хранение объекта в сериализованной форме. Однако некоторые службы именования и каталогов не поддерживают хранение объектов Java. Более того, для некоторых объектов в каталоге Java-программы — лишь одна группа приложений, которые к ним обращаются. В этом случае сериализованный Java-объект может не быть наиболее подходящим представлением. JNDI определяет ссылку, представленную классом Reference, которая содержит информацию о том, как создать копию объекта. JNDI попытается преобразовать ссылки, полученные из каталога, в представляющие их Java-объекты, чтобы клиенты JNDI имели иллюзию, что в каталоге хранятся Java-объекты.

Начальный контекст

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

Исключения

JNDI определяет иерархию классов исключений, которые могут быть выброшены во время выполнения операций именования и каталогов. Корень этой иерархии — NamingException. Программы, заинтересованные в обработке конкретного исключения, могут перехватить соответствующий подкласс исключения. В противном случае программы должны перехватить NamingException.
С:
1.3

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

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