Spec-Zone .ru
спецификации, руководства, описания, API
Пожалуйста, учтите, что спецификации и другая информация, содержащаяся здесь, не являются заключительными и могут быть изменены. Информация доступна для вас исключительно ради ознакомления.
 Платформа Java™
Стандарт Эд. 8

ЧЕРНОВАЯ земля-b92

Пакет org.omg. CosNaming

Предоставляет услугу именования для IDL Java.

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

Пакет org.omg. Описание CosNaming

Предоставляет услугу именования для IDL Java. Демон Посредника запросов к объектам (ORBD) также включает и переходный процесс и персистентную службу именования.

Пакет и все его классы и интерфейсы были сгенерированы, выполняя инструмент idlj на файле nameservice.idl, который является модулем, записанным в IDL OMG.

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

Для точного списка поддерживаемых разделов официальных спецификаций, с который Java [ТМ] Платформа, Standard Edition 6, ШАР подчиняется, см. Официальные Спецификации для поддержки CORBA в Java [ТМ] SE 6.

Интерфейсы

Пакет org.omg.CosNaming содержит два открытых интерфейса и несколько вспомогательных классов.

Интерфейсы:

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

Вспомогательные Классы

Чтобы отобразить интерфейс IDL OMG на язык программирования Java, idlj компилятор создает классы Java, которые могут считаться вспомогательными классами. Комментарии для сгенерированных вспомогательных классов используются интерфейсами NamingContext и BindingIterator включаются здесь.

Классы, Используемые NamingContext и BindingIterator

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

Классы держателя

IDL OMG использует и Параметры, являющиеся одновременно входным и выходным для того, чтобы возвратить значения из операций. Отображение на язык программирования Java, который не имеет и Параметры, являющиеся одновременно входным и выходным, создает специальный class для каждого типа, названного держателем class. Экземпляр держателя, class можно передать к методу Java в качестве параметра, и значению, может быть присвоен value поле. Это позволяет этому выполнять функцию или Параметр, являющийся одновременно входным и выходным.

Следующие классы держателя сгенерированы для пакета org.omg.CosNaming:

Отметьте это в org.omg.CORBA пакет, есть держатель class для каждого из основных типов Java: IntHolder, ShortHolder, StringHolder, и так далее.

Отметьте также, что есть a NameHolder class даже при том, что есть нет Name class; точно так же есть a BindingListHolder class даже при том, что есть нет BindingList class. Это - истина потому что в интерфейсе IDL OMG, Name и BindingList typedefs. От IDL нет никакого отображения typedef к конструкции Java, но классам держателя сгенерированы если typedef для последовательности или массива. Как отображено на язык программирования Java, Name массив NameComponent объекты, и a BindingList массив Binding объекты. У всех классов держателя есть по крайней мере два конструктора и одно поле:

Держатель у class для определяемого пользователем типа (Java class) есть еще три метода, но разработчики приложений, не использует их непосредственно.

Классы помощника

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

Есть только один метод в помощнике class, который использует прикладной программист: метод narrow. Только у интерфейсов Java, отображенных от интерфейсов IDL, будет помощник class, который включает a narrow метод, таким образом, в CosNaming пакет, только классы NamingContextHelper и BindingIteratorHelper имейте a narrow метод.

Пакет org.omg.CosNaming.NamingContextPackage

Этот пакет предоставляет классы Помощника и Держателя для исключений, используемых в пакете org.omg.CosNaming и также для class NotFoundReason, который предоставляет причину исключения NotFound.

Есть классы Помощника и Держателя для следующих исключений:

Именование Совместимости Службы

Реализация Sun CosNaming пакет выполняет OMG COSNaming спецификация. Другими словами API в службе именования Sun реализуются согласно направляющим линиям для услуги именования, предоставленной OMG. Поэтому, если сторонний поставщик реализовал службу именования, которая является совместимым OMG, возможно переключиться между реализацией Sun CosNaming и реализация стороннего поставщика. Однако, важно понять, что могут быть незначительные изменения в способе, которым различные поставщики реализуют службу именования, такую как различия в строках исключения.

Инструкции для Использования Службы Именования Третьей стороны

Хотя мы поощряем использовать ШАР и службы ШАРА, которые являются оба от одного поставщика, возможно включить третью сторону COSNaming реализация с ШАРОМ IIOP RMI Sun. Вот шаги, чтобы следовать:
  1. Создайте файл свойств для сервера Начальной загрузки и дайте ему две записи. Например, Вы могли вызвать этот файл свойств /tmp/services и помещенный следующее в это: NameService, <Stringified IOR of the Root Naming Context>.

    Это связывается NameService с Корневым Контекстом именования CosNaming реализация, которую Вы хотите использовать.

  2. Запустите автономный сервер Начальной загрузки, используя следующую команду:
          
          java -classpath $(CLASSPATH)
          com.sun.corba.ee.internal.CosNaming.BootstrapServer -InitialServicesFile
          "/tmp/services" [-ORBInitialPort port]
          
      

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

Теперь, когда приложение вызывает метод org.omg.CORBA.ORB.resolve_initial_references, Процессы CORBA свяжутся с Сервером Начальной загрузки, чтобы получить Корневой Контекст именования.

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

Связанная Документация

Для краткого обзора и примеров того, как использовать CosNaming API, пожалуйста, см.:

Для краткого обзора IDL Java, пожалуйста, см.:

С тех пор:
JDK1.3
 Платформа Java™
Стандарт Эд. 8

ЧЕРНОВАЯ земля-b92

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

ЧЕРНОВАЯ земля-b92