Пакет javax.naming

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

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

Сводка интерфейса

Интерфейс	Описание
Контекст	Этот интерфейс представляет контекст именования, который состоит из ряда привязки имени к объекту.
Имя	Интерфейс Name представляет родовое название - упорядоченная последовательность компонентов.
NameParser	Этот интерфейс используется для того, чтобы проанализировать имена от иерархического пространства имен.
NamingEnumeration <T>	Этот интерфейс для того, чтобы перечислить списки, возвращенные методами в javax.naming и javax.naming.directory пакетах.
Referenceable	Этот интерфейс реализуется объектом, который может обеспечить Ссылку на себя.

Сводка класса

Класс	Описание
BinaryRefAddr	Этот class представляет двоичную форму адреса коммуникационной конечной точки.
Привязка	Этот class представляет привязку имени к объекту, найденную в контексте.
CompositeName	Этот class представляет составное имя - последовательность имен компонентов, охватывающих многократные пространства имен.
CompoundName	Этот class представляет составное имя - имя от иерархического пространства имен.
InitialContext	Этот class является запускающимся контекстом для того, чтобы выполнить операции именования.
LinkRef	Этот class представляет Ссылку, содержание которой имя, названное именем ссылки, которое связывается с атомарным именем в контексте.
NameClassPair	Этот class представляет имя объекта и пару имени class привязки, найденной в контексте.
RefAddr	Этот class представляет адрес коммуникационной конечной точки.
Ссылка	Этот class представляет ссылку на объект, который находится за пределами именования/системы каталогов.
StringRefAddr	Этот class представляет строковую форму адреса коммуникационной конечной точки.

Сводка исключения

Исключение	Описание
AuthenticationException	Это исключение выдается, когда ошибка аутентификации происходит, получая доступ к именованию или службе каталогов.
AuthenticationNotSupportedException	Это исключение выдается, когда определенная разновидность аутентификации, которую требуют, не поддерживается.
CannotProceedException	Это исключение выдается, чтобы указать, что работа, достигнутая точка на имя, где работа не может продолжиться дальше.
CommunicationException	Это исключение выдается, когда клиент неспособен связаться со службой именования или каталогом.
ConfigurationException	Это исключение выдается, когда есть проблема конфигурации.
ContextNotEmptyException	Это исключение выдается, пытаясь уничтожить контекст, который не пуст.
InsufficientResourcesException	Это исключение выдается, когда ресурсы не доступны, чтобы завершить требуемую работу.
InterruptedNamingException	Это исключение выдается, когда вызываемая операция именования была прервана.
InvalidNameException	Это исключение указывает, что определяемое имя не соответствует синтаксису именования системы именования.
LimitExceededException	Это исключение выдается, когда метод завершается неправильно из-за пользователя или системы определенный предел.
LinkException	Это исключение используется, чтобы описать проблемы, встречаются, разрешая ссылки.
LinkLoopException	Это исключение выдается, когда цикл был обнаружен, будет, пытаясь разрешить ссылку, или реализацию, определенный предел на количествах ссылки был достигнут.
MalformedLinkException	Это исключение выдается, когда с уродливой ссылкой встретились, решая или создавая ссылку.
NameAlreadyBoundException	Это исключение выдается методами, чтобы указать, что привязка не может быть добавлена, потому что имя уже связывается с другим объектом.
NameNotFoundException	Это исключение выдается, когда компонент имени не может быть разрешен, потому что это не связывается.
NamingException	Это - суперкласс всех исключений, выданных операциями в интерфейсах Контекста и DirContext.
NamingSecurityException	Это - суперкласс связанных с безопасностью исключений, выданных операциями в интерфейсах Контекста и DirContext.
NoInitialContextException	Это исключение выдается, когда никакая начальная реализация контекста не может быть создана.
NoPermissionException	Это исключение выдается, пытаясь выполнить работу, для которой у клиента нет никакого разрешения.
NotContextException	Это исключение выдается, когда операция именования продолжается к точке, где контекст обязан продолжать работу, но разрешенный объект не является контекстом.
OperationNotSupportedException	Это исключение выдается, когда реализация контекста не поддерживает вызываемую работу.
PartialResultException	Это исключение выдается, чтобы указать, что результат, возвращаемый или возвращаемый до сих пор, является частичным, и что работа не может быть завершена.
ReferralException	Этот абстрактный class используется, чтобы представить исключение отсылки, которое сгенерировано в ответ на отсылку, такую как возвращенное LDAP v3 серверы.
ServiceUnavailableException	Это исключение выдается, пытаясь связаться с каталогом или называя службу, и та служба не доступна.
SizeLimitExceededException	Это исключение выдается, когда метод приводит к результату, который превышает связанный с размером предел.
TimeLimitExceededException	Это исключение выдается, когда метод не завершается в пределах предела требуемого времени.

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

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

Этот пакет определяет операции именования Именования Java и Каталога ^InterfaceTM (JNDI). JNDI обеспечивает именование и функциональность каталога к приложениям, записанным в языке программирования Java. Это разрабатывается, чтобы быть независимым от любого определенного именования или реализации службы каталогов. Таким образом ко множеству служб - новый, появление, и уже развернутые - можно получить доступ в распространенном способе.

Контекст

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

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

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

Имена

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

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

Привязка

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

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

Ссылки

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

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

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

Исключения

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

Спецификация пакета

Спецификация API JNDI и связанные документы могут быть найдены в документации JNDI.

С тех пор:

1.3