Пакет javax.naming
Предоставляет классы и интерфейсы для доступа к службам именования.
См.: Описание
| Интерфейс | Описание |
|---|---|
| Context | Этот интерфейс представляет контекст именования, который состоит из набора привязок имя-объект. |
| 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.