спецификации, руководства, описания, API

Начинание с IDL Java:
Запись Определения Интерфейса

Прежде, чем Вы начнете работать с IDL Java, Вы должны установить версию 1.4 (или позже) платформы Java. Версия 1.4 (и позже) обеспечивает Прикладной программный интерфейс (API), и Посредник запросов к объектам (ШАР) должен был включить CORBA-на-основе распределенному объектному взаимодействию, так же как компилятору idlj. Компилятор idlj использует язык IDL к Java, отображающийся, чтобы преобразовать определения интерфейса IDL соответствующим интерфейсам Java, классам, и методам, которые можно тогда использовать, чтобы реализовать Ваш код клиента и сервера.

Этот раздел учит Вас, как записать простое определение интерфейса IDL и как преобразовать интерфейс IDL в Java. Это также описывает цель каждого файла, сгенерированного компилятором idlj.

Эти темы включаются в этот раздел:

Запись Hello.idl
Понимание файла IDL
Отображение Hello.idl к Java
Понимание idlj Выхода компилятора

Запись `Hello.idl`

Создать файл Hello.idl,

Создайте новый каталог, названный Hello, для этого приложения.
Запустите свой любимый текстовый редактор и создайте файл под названием Hello.idl в этом каталоге.
В Вашем файле введите код для определения интерфейса, Hello.idl:
```
module HelloApp
{
  interface Hello
  {
    string sayHello();
    oneway void shutdown();
  };
};
```
Сохраните файл.

Понимание файла IDL

IDL OMG является языком, используемым, чтобы описать интерфейсы, что клиент возражает вызову, и объектные реализации обеспечивают. Определение интерфейса, записанное в IDL OMG полностью, определяет интерфейс и полностью определяет параметры каждой работы. Интерфейс IDL OMG предоставляет информацию, должен был разработать клиенты, которые используют операции интерфейса.

Клиенты пишутся на языках, для которых были определены отображения от понятий IDL OMG. Отображение понятия IDL OMG к клиентской конструкции языка будет зависеть от средств, доступных на клиентском языке. OMG определяет отображение от IDL до нескольких различных языков программирования, включая C, C++, Smalltalk, КОБОЛ, Аду, Lisp, Python, и Java. Когда отображено, каждый оператор в IDL OMG преобразовывается в соответствующий оператор в предпочтительном языке программирования.

Например, Вы могли использовать инструмент idlj, чтобы отобразить интерфейс IDL на Java и реализовать клиент class. Когда Вы отобразили тот же самый IDL на C++ и реализовали сервер на том языке, клиент Java (через ШАР Java) и сервер C++ (через ШАР C++) взаимодействует, как если бы они были записаны на том же самом языке.

IDL для "Привет Мира" чрезвычайно прост; его единственный интерфейс имеет только две операции. Вы должны выполнить только три шага:

Объявите модуль IDL CORBA
Объявите интерфейс
Объявите операции

Объявление Модуля IDL CORBA

Модуль CORBA является пространством имен, которое действует как контейнер для связанных интерфейсов и объявлений. Это соответствует близко пакету Java. Каждый оператор модуля в файле IDL отображается на оператор пакета Java.

Оператор модуля похож на это:

module HelloApp
{
    // Subsequent lines of code here.
};

Когда Вы скомпилируете IDL, оператор модуля генерирует оператор пакета в коде Java.

Объявление Интерфейса

Как интерфейсы Java, интерфейсы CORBA объявляют, что API сокращается, объект имеет с другими объектами. Каждый оператор интерфейса в IDL отображается на оператор интерфейса Java когда отображено.

В Вашем файле Hello.idl оператор интерфейса похож на это:

module HelloApp
{
  interface Hello  // These lines
  {                // declare the 
                   // interface
  };               // statement.
};

Когда Вы скомпилируете IDL, этот оператор генерирует оператор интерфейса в коде Java.

Объявление Операций

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

В Вашем файле Hello.idl оператор работы похож на это:

module HelloApp
{
  interface Hello
  {
    string sayHello();        // This line is an operation statement.
    oneway void shutdown();   // This line is another
  };
};

Определение интерфейса для наш немного "Привет Мировое" приложение теперь полно.

Отображение `Hello.idl` к Java

Инструмент idlj файлы IDL OMG чтений и создают необходимые файлы Java. Значения по умолчанию компилятора idlj к генерированию только клиентская привязка. Если Вы нуждаетесь и в клиентской привязке и в серверных скелетах (как Вы делаете для нашей "Привет Мировой" программы), следует использовать опцию -fall, выполняя компилятор idlj. Для получения дополнительной информации по опциям компилятора см. опции компилятора IDL к Java.

Серверное отображение значения по умолчанию, сгенерированное, когда или -fall или параметры -fserver используются, соответствует Главе 11, Переносимый Объектный Адаптер (POA) CORBA 2.3.1 Спецификации (formal/99-10-07). Для получения дополнительной информации по POA см. Переносимый Объектный Адаптер.

Преимущества использования Переносимого Объектного Адаптера (POA):

Позвольте программистам создавать объектные реализации, которые переносимы между различными продуктами ШАРА.
Окажите поддержку для объектов с персистентными идентификационными данными.
Окажите поддержку для прозрачной активации объектов.
Позвольте единственному слуге поддерживать многократные объектные идентификационные данные одновременно.

Удостоверьтесь, что каталог jdk/bin (или каталог, содержащий idlj, java, javac, и orbd), находятся в Вашем пути.
Пойдите в приглашение командной строки.
Изменитесь на каталог, содержащий Ваш файл Hello.idl.
Введите команду компилятора:
```
   
        idlj -fall Hello.idl
```

Если Вы перечислите содержание каталога, то Вы будете видеть, что каталог под названием HelloApp был создан и что это содержит шесть файлов. Откройте Hello.java в своем текстовом редакторе. Hello.java является интерфейсом подписи и используется, поскольку подпись вводит объявления метода, когда интерфейсы указанного типа используются в других интерфейсах. Это похоже на это:

//Hello.java
package HelloApp;


/**
* HelloApp/Hello.java
* Generated by the IDL-to-Java compiler (portable), version "3.0"
* from Hello.idl
*/

public interface Hello extends HelloOperations, org.omg.CORBA.Object, 
org.omg.CORBA.portable.IDLEntity 
{
} // interface Hello

С интерфейсом это простое, легко видеть, как операторы IDL отображаются на сгенерированные операторы Java.

Оператор IDL		Оператор Java
`module HelloApp`		`package HelloApp;`
`interface Hello`		`public interface Hello`

Единственный удивительный элемент является оператором extends. Все объекты CORBA получаются из org.omg.CORBA.Object, чтобы гарантировать требуемую функциональность CORBA. Необходимый код сгенерирован idlj; Вы не должны сделать никакого отображения.

В предыдущих версиях компилятора idlj (известный как idltojava), операции, определенные в интерфейсе IDL, существовали бы в этом файле также. Запускаясь с J2SDK v1.3.0, в соответствии с CORBA 2.3.1 Спецификации (formal/99-10-07), отображение IDL к Java помещает все операции, определенные в интерфейсе IDL в интерфейсе операций, HelloOperations.java. Интерфейс операций используется в серверном отображении и как механизм для того, чтобы обеспечить оптимизированные призывы к cо-расположенным клиентам и серверам. Для Hello.idl этот файл похож на это:

//HelloOperations.java
package HelloApp;


/**
* HelloApp/HelloOperations.java
* Generated by the IDL-to-Java compiler (portable), version "3.0"
* from Hello.idl
*/

public interface HelloOperations 
{
  String sayHello ();
  void Shutdown ();
} // interface HelloOperations

Поскольку есть только две операции, определенные в этом интерфейсе, легко видеть, как операторы IDL отображаются на сгенерированные операторы Java.

Оператор IDL		Оператор Java
`string sayHello();`		`String sayHello();`
`oneway void shutdown();`		`void Shutdown ();`

Понимание Выхода компилятора `idlj`

Компилятор idlj генерирует много файлов. Фактическое число сгенерированных файлов зависит от опций, выбранных, когда файл IDL компилируется. Сгенерированные файлы обеспечивают стандартную функциональность, таким образом, можно проигнорировать их, пока не пора развернуть и выполнить Вашу программу. Под J2SE v.1.4, файлы, сгенерированные компилятором idlj для Hello.idl, с параметром командной строки -fall:

HelloPOA.java
Этот абстрактный class является основанным на потоке скелетом сервера, обеспечивая основную функциональность CORBA для сервера. Это расширяет org.omg.PortableServer.Servant, и реализует интерфейс InvokeHandler и интерфейс HelloOperations. Сервер class, HelloServant, расширяет HelloPOA.
_HelloStub.java
Этот class является клиентским тупиком, предоставляя функциональность CORBA клиенту. Это расширяет org.omg.CORBA.portable.ObjectImpl и реализует интерфейс Hello.java.
Hello.java
Этот интерфейс содержит версию Java нашего интерфейса IDL. Интерфейс Hello.java расширяет org.omg.CORBA.Object, обеспечивая стандартную функциональность объекта CORBA. Это также расширяет интерфейс HelloOperations и org.omg.CORBA.portable.IDLEntity.
HelloHelper.java
Этот class обеспечивает вспомогательную функциональность, особенно метод narrow(), требуемый бросать ссылки на объект CORBA на их надлежащие типы. Помощник class ответственен за чтение и запись типа данных к потокам CORBA, и вставки и извлечения типа данных от Any s. Держатель class делегирует к методам в Помощнике class для чтения и записи.
HelloHolder.java
Этот заключительный class содержит общедоступного члена экземпляра типа Hello. Всякий раз, когда типом IDL является out или параметр inout, Держатель, class используется. Это обеспечивает операции для org.omg.CORBA.portable.OutputStream и параметров org.omg.CORBA.portable.InputStream, которые CORBA позволяет, но которые не отображаются легко на семантику Java. Держатель class делегирует к методам в Помощнике class для чтения и записи. Это реализует org.omg.CORBA.portable.Streamable.
HelloOperations.java
Этот интерфейс содержит методы sayHello() и shutdown(). Отображение IDL к Java помещает все операции, определенные в интерфейсе IDL в этот файл, который совместно используется и тупиками и скелетами.

Когда Вы пишете интерфейс IDL, Вы делаете все программирование, требуемое генерировать все эти файлы для Вашего распределенного приложения. Следующие шаги должны реализовать классы клиента и сервера. В шагах, которые следуют, Вы создадите клиент HelloClient.java class и сервер HelloServer.java class.

Поиск и устранение неисправностей

Сообщение об ошибке: "idlj", не найденный
Если Вы пытаетесь выполнить idlj на файле, Hello.idl и система не могут найти idlj, это наиболее вероятно не в Вашем пути. Удостоверьтесь, что расположение idlj (каталог bin JDK) находится в Вашем пути, и попробовать еще раз.

Для получения дополнительной информации

IDL к Краткому обзору Отображения Языка Java
Обеспечивает основы для того, чтобы они отобразили конструкции IDL на соответствующие операторы Java.
Глава 3 OMG CORBA 2.3.1 спецификации, formal/99-10-07
Обеспечивает полную спецификацию для Языка определения интерфейсов OMG. Спецификация может быть загружена с formal/99-10-07.

Свяжитесь с Нами

Начинание с IDL Java: Запись Определения Интерфейса

Понимание файла IDL

Начинание с IDL Java:
Запись Определения Интерфейса