org.omg. CosNaming (Платформа Java SE 7)

Интерфейсная Сводка
Интерфейс	Описание
BindingIterator	Интерфейс BindingIterator позволяет клиенту выполнять итерации посредством привязки, используя next_one или next_n операции.
BindingIteratorOperations	Интерфейс BindingIterator позволяет клиенту выполнять итерации посредством привязки, используя next_one или next_n операции.
NamingContext	Контекст именования является объектом, который содержит ряд привязки имени, в которой каждое имя уникально.
NamingContextExt	`NamingContextExt` расширение `NamingContext` который содержит ряд привязки имени, в которой каждое имя уникально и является частью Взаимодействующей Службы Именования.
NamingContextExtOperations	`NamingContextExt` расширение `NamingContext` который содержит ряд привязки имени, в которой каждое имя уникально и является частью Взаимодействующей Службы Именования.
NamingContextOperations	Контекст именования является объектом, который содержит ряд привязки имени, в которой каждое имя уникально.

Сводка класса
Класс	Описание
_BindingIteratorImplBase
_BindingIteratorStub	Интерфейс BindingIterator позволяет клиенту выполнять итерации посредством привязки, используя next_one или next_n операции.
_NamingContextExtStub	`NamingContextExt` расширение `NamingContext` который содержит ряд привязки имени, в которой каждое имя уникально и является частью Взаимодействующей Службы Именования.
_NamingContextImplBase
_NamingContextStub	Контекст именования является объектом, который содержит ряд привязки имени, в которой каждое имя уникально.
Привязка	org/omg/CosNaming/Binding.java.
BindingHelper	org/omg/CosNaming/BindingHelper.java.
BindingHolder	org/omg/CosNaming/BindingHolder.java.
BindingIteratorHelper	Интерфейс BindingIterator позволяет клиенту выполнять итерации посредством привязки, используя next_one или next_n операции.
BindingIteratorHolder	Интерфейс BindingIterator позволяет клиенту выполнять итерации посредством привязки, используя next_one или next_n операции.
BindingIteratorPOA	Интерфейс BindingIterator позволяет клиенту выполнять итерации посредством привязки, используя next_one или next_n операции.
BindingListHelper	Список Привязки.
BindingListHolder	Список Привязки.
BindingType	Определяет, является ли данная привязка для объекта (который не является контекстом именования), или для контекста именования.
BindingTypeHelper	Определяет, является ли данная привязка для объекта (который не является контекстом именования), или для контекста именования.
BindingTypeHolder	Определяет, является ли данная привязка для объекта (который не является контекстом именования), или для контекста именования.
IstringHelper	org/omg/CosNaming/IstringHelper.java.
NameComponent	org/omg/CosNaming/NameComponent.java.
NameComponentHelper	org/omg/CosNaming/NameComponentHelper.java.
NameComponentHolder	org/omg/CosNaming/NameComponentHolder.java.
NameHelper	Имя является последовательностью компонентов имени.
NameHolder	Имя является последовательностью компонентов имени.
NamingContextExtHelper	`NamingContextExt` расширение `NamingContext` который содержит ряд привязки имени, в которой каждое имя уникально и является частью Взаимодействующей Службы Именования.
NamingContextExtHolder	`NamingContextExt` расширение `NamingContext` который содержит ряд привязки имени, в которой каждое имя уникально и является частью Взаимодействующей Службы Именования.
NamingContextExtPOA	`NamingContextExt` расширение `NamingContext` который содержит ряд привязки имени, в которой каждое имя уникально и является частью Взаимодействующей Службы Именования.
NamingContextHelper	Контекст именования является объектом, который содержит ряд привязки имени, в которой каждое имя уникально.
NamingContextHolder	Контекст именования является объектом, который содержит ряд привязки имени, в которой каждое имя уникально.
NamingContextPOA	Контекст именования является объектом, который содержит ряд привязки имени, в которой каждое имя уникально.

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

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

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

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

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

Интерфейсы

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

Интерфейсы:

NamingContext
BindingIterator

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

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

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

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

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

public final class NameComponent - стандартный блок для имен. (Имена связываются со ссылками на объект в контексте именования.)
Имя является массивом один или больше NameComponent объекты. Имя с синглом NameComponent вызывается простым именем; имя с многократным NameComponent объекты вызывают составным именем.
A NameComponent объект состоит из двух полей:
1. id - a String используемый в качестве идентификатора
2. kind - a String это может использоваться в любой дескриптивной цели. Его важность состоит в том, что это может использоваться, чтобы описать объект, не влияя на синтаксис. Язык программирования C, например, использует синтаксическое соглашение добавления расширения ".c" к имени файла, чтобы указать, что это - файл исходного кода. В a NameComponent объект, kind поле может использоваться, чтобы описать тип объекта, а не расширения файла или некоторого другого синтаксического соглашения. Примеры значения kind поле включает строки "c_source", "object_code", "executable", "postscript", и "". Это весьма обычно для kind поле, чтобы быть пустой строкой.
На имя, каждого NameComponent объект кроме последнего обозначает a NamingContext объект; последнее NameComponent объект обозначает связанную ссылку на объект. Это подобно пути, в котором фамилия является именем файла, и все имена перед этим являются именами каталогов.
public final class Binding - объект, который связывает имя со ссылкой на объект или контекстом именования. A Binding у объекта есть два поля:
1. binding_name - массив один или больше NameComponent объекты, который представляет связанное имя
2. binding_type - a BindingType объект, указывающий, является ли привязка между именем и ссылкой на объект или между именем и контекстом именования
Интерфейс NamingContext имеет методы для того, чтобы связать/развязать имена со ссылками на объект или контекстами именования, для того, чтобы перечислить привязку, и для того, чтобы разрешить привязку (данный имя, метод resolve возвращает ссылку на объект, связанную с этим).
public final class BindingType - объект, который определяет ли данный Binding объект является привязкой между именем и ссылкой на объект (то есть, не контекст именования) или между именем и контекстом именования.
КлассBindingType состоит из двух методов и четырех констант. Две из этих констант BindingType объекты, и два ints.
BindingType объекты можно передать конструктору для класса Binding или используемый в качестве параметров или возвращаемых значений. Они BindingType объекты:
- public static final BindingType nobject - указать, что привязка со ссылкой на объект
- public static final BindingType ncontext - указать, что привязка с контекстом именования
int константы могут быть предоставлены методу from_int создать BindingType объекты, или они могут быть возвращаемыми значениями для метода value. Эти константы:
- public static final int _nobject
- public static final int _ncontext
Если метод from_int предоставляется чем-либо кроме _nobject или _ncontext, это выдаст исключение org.omg.CORBA.BAD_PARAM.
Использование следующие:
```
       BindingType btObject = from_int(_nobject);
       BindingType btContext = from_int(_ncontext);
    
```
Переменная btObject обращается к a BindingType объект, инициализированный, чтобы представить привязку со ссылкой на объект. Переменная btContext обращается к a BindingType объект, инициализированный, чтобы представить привязку с a NamingContex объект.
Метод value возвраты также _nobject или _ncontext, так в следующей строке кода, переменной bt будет содержать _nobject или _ncontext:
```
       int bt = BindingType.value();
    
```

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

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

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

NamingContextHolder
BindingIteratorHolder
BindingHolder
BindingListHolder
BindingTypeHolder
NameComponentHolder
NameHolder

Отметьте это в 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 объекты. У всех классов держателя есть по крайней мере два конструктора и одно поле:

value поле - экземпляр типа, используемого в качестве или Параметр, являющийся одновременно входным и выходным. Например, value поле a NamingContextHolder будет a NamingContext объект.
конструктор по умолчанию - конструктор, который создает новый объект держателя, инициализированный со значением по умолчанию для типа. Например, новое BindingHolder у объекта, создаваемого с конструктором по умолчанию, будет value полевой набор к null потому что это - значение по умолчанию для объекта. Другие значения по умолчанию false для boolean, 0 для числового и типов случайной работы, и null для ссылок на объект.
конструктор от экземпляра - конструктор, который создает новый объект держателя чей value поле инициализируется с предоставленным экземпляром

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

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

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

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

public static NamingContext narrow(org.omg.CORBA.Object obj) - преобразовывает данный объект CORBA в a NamingContext объект
public static BindingIterator narrow(org.omg.CORBA.Object obj) - преобразовывает данный объект CORBA в a BindingIterator объект

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

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

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

AlreadyBound
CannotProceed
InvalidName
NotEmpty
NotFound

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

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

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

Хотя мы поощряем использовать ШАР и службы ШАРА, которые являются оба от одного поставщика, возможно включить третью сторону COSNaming реализация с ШАРОМ IIOP RMI Sun. Вот шаги, чтобы следовать:

Создайте файл свойств для сервера Начальной загрузки и дайте ему две записи. Например, Вы могли вызвать этот файл свойств /tmp/services и помещенный следующее в это: NameService, <Stringified IOR of the Root Naming Context>.
Это связывается NameService с Корневым Контекстом именования CosNaming реализация, которую Вы хотите использовать.
Запустите автономный сервер Начальной загрузки, используя следующую команду:
```
      
      java -classpath $(CLASSPATH)
      com.sun.corba.ee.internal.CosNaming.BootstrapServer -InitialServicesFile
      "/tmp/services" [-ORBInitialPort port]
      
  
```
Отметьте, что квадратные скобки в конце команды указывают, что определение номера порта является дополнительным.

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

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

Взаимодействующая Служба Именования (ptc/00-08-07)

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

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

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

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

Домашняя страница IDL Java

С тех пор:: JDK1.3

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

Пакет org.omg. CosNaming

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

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

Интерфейсы

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

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

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

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

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

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

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

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

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

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

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