ModCBroker: руководство по миграции приложений с версий 1.x и 2.x на версию 3.0
DocumentId:GradSof-Cbroker-r-mg-06.06.2002

Contents

• Изменения CORBA API
• Изменения в параметрах настройки
• Перечень изменений

Изменения CORBA API

Общая логика CORBA API осталась такой-же, как и в версии 2.0. Изменены лишь параметры и некоторые наименования методов, а также добавлены несколько новых методов.

Собственно изменения следующие:

• Файл HTTPServ.idl переименован в HTTP.idl.
• createHandler переименован в create_handler. Мотивация этих изменений: совместимость с рекомендациями по стилю idl от OMG ab/98-06-03
• set_cookie принимает в качестве длительности жизни cookie количество секунд вместо тройки (дни, часы, минуты). Т. е. в программах вы должны вызовы типа:

   \verb|httpStream->set_cookie(name,value,x,y,z);
  

  В вызовы:

   \verb|httpStream->set_cookie(name,value,(((x*24)+y)*60+z)*60);
  

• сам IDL файл HTTPServ.idl переименован в HTTP.idl.

Расширения:

• В структуру RequestInfo добавлен метод HTTP запроса.
• Методы создания обработчика и метод обраобтки запросов сейчас могут вызывать исключение RedirectException.
• Добавлен механизм установки любого выходного элемента заголовка запроса.
• Добавлен механизм пакетной записи заголовка запроса.

Таким образом:

• Вы должны в любом случае перекомпилировать все модули, зависящие от HTTP.idl.
• Изменить createHandler на create_handler
• Изменить вызовы set_cookie
• При необходимости, рассмотрите возможность использования новых свойста ModCbroker для увеличения функциональности либо повышения производительности вашего ПО.

Изменения в параметрах настройки

• Задание директив ORB ранее определялось параметром ORB_Args, сейчас - CbrokerORBArgs.
• В Apache-2.0 изменился способ привязки обработчика модуля к запросу. Поэтому мы добавили в конфигурацию директиву CbrokerLocation - мы обрабатываем этот запрос если директория URI начинается со значения этого параметра.
• Имя файла модуля изменилось с libcbroker.so на mod_cbroker.so
• В Unix этот файл инсталлируется в местоположение: <prefix>/libexec/apache2

Таким образом:

• предложение загрузки модуля:

  LoadModule cbroker_module <path>/libcbroker.so
  

  Необходимо заменить на

  LoadModule cbroker_module <path>/mod_cbroker.so
  

• часть конфигурации Apache-1.x имеющая вид:

  <Location cbroker>
  SetHandler cbroker-handler
  ORB_args -ORBInitRef NameService=cobaloc::my.host.com:2809/NameService
  </Location>
  

  преобразуется в следующую форму.

  <IfModule mod_cbroker>
  CbrokerLocation  cbroker 
  CbrokerORBArgs -ORBInitRef NameService=corbaloc::my.host.com:2809/NameService
  </IfModule>
  

  А конфигурация с авторизацией:

  <Location cbroker>
  SetHandler cbroker-handler
  ORB_args -ORBInitRef NameService=cobaloc::my.host.com:2809/NameService
  AuthType Basic
  AuthName myService
  require valud_user
  </Location>
  

  преобразуется в форму

  <IfModule mod_cbroker>
  CbrokerLocation  ProtectedCbroker 
  CbrokerORBArgs -ORBInitRef NameService=corbaloc::my.host.com:2809/NameService
  </IfModule>
  <Location ProtectedCbroker>
  AuthType Basic
  AuthName myService
  require valud_user
  </Location>
  

Перечень изменений

• 14.06.2002 - пересмотрен, добавлено преобразование выражения LoafModule
• 07.06.2002 - первая публичная версия.
• 06.06.2002 - создан.