Платформа Java™
Стандарт Эд. 7

Пакет 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, который не имеет и Параметры, являющиеся одновременно входным и выходным, создает специальный класс для каждого типа, названного классом держателя. Экземпляр класса держателя можно передать к методу Java в качестве параметра, и значение может быть присвоено value поле. Это позволяет этому выполнять функцию или Параметр, являющийся одновременно входным и выходным.

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

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

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

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

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

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

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

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

Этот пакет предоставляет классы Помощника и Держателя для исключений, используемых в пакете org.omg.CosNaming и также для класса 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™
Стандарт Эд. 7

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




Spec-Zone.ru - all specs in one place