Миграция программ J2C с помощью командной строки

Миграцию программ из WebSphere Studio Application Developer Integration Edition в инструменты Rational можно выполнить с помощью командной строки.

Процедура

  1. Перейдите в каталог с файлами J2CMigration.bat и J2CMigration.sh:
    • windows icon установочным каталогом для инструмента миграции J2C по умолчанию является системный_диск: <установочный-каталог>\plugins\com.ibm.j2c.migration.wsadie_7.2.0.vxxx.
    • linux icon: установочным каталогом для инструмента миграции J2C по умолчанию является: <установочный-каталог>\plugins\com.ibm.j2c.migration.wsadie_7.2.0.vxxx.
  2. Необходимо изменить файл J2CMigration.bat или J2CMigration.sh
    1. Найдите раздел, в котором задаются переменные:
      ECLIPSE_ROOT: Каталог, в котором расположены файлы eclipse.exe и eclipse.ini. Значение по умолчанию для продуктов разработки приложений Rational: <установочный-каталог>.
      • windows icon ECLIPSE_ROOT= <install-dir>; расположение каталога указывается в зависимости от среды.
      • linux icon SET ECLIPSE_ROOT=/opt/<установочный-каталог>
      JDK_HOME : Каталог, в котором расположен файл java.exe.
      • windows icon Каталог по умолчанию: %ECLIPSE_ROOT%\jdk\jre\bin
      • linux icon SET JDK_HOME=%ECLIPSE_ROOT%/jdk/jre/bin
      .
       rarsPathVar: Каталог, в котором расположена папка Resource Adapters. Точный путь можно определить, открыв <установочный_каталог>configuration/config.ini и найдя rarsPathVar.
      • windows icon SET RARVARPATH=%ECLIPSE_ROOT%/ResourceAdapters.
      • linux icon SET RARVARPATH=%ECLIPSE_ROOT%/ResourceAdapters
      was.runtime: Каталог, в котором расположена папка рабочей среды WAS. Точный путь можно определить, открыв <установочный_каталог>configuration/config.ini и найдя rarsPathVar.
      • windows icon SET WASRUNTIME=%ECLIPSE_ROOT%/runtimes
      • linux iconSET WASRUNTIME=%ECLIPSE_ROOT%/runtimes
      EQUINOXJAR: Каталог, в котором находится файл jar org.eclipse.core.Launcher.Main.
      • windows icon SET EQUINOXJAR=%ECLIPSE_ROOT%\plugins\org.eclipse.equinox.launcher_1.0.101.R34x_v20081125.jar
      • linux iconSET EQUINOXJAR=%ECLIPSE_ROOT%/plugins/org.eclipse.equinox.launcher_1.0.101.R34x_v20081125.jar
      • Рабочая область по умолчанию %WORKSPACE% %WORKSPACE% будет задана как: %WORKSPACE%%ECLIPSE_ROOT%\workspace\Migration1 или %ECLIPSE_ROOT%\workspace\Migration1 в пакетном файле миграции или сценарии командного процессора.
  3. Сохраните и закройте файл. В каталоге J2CMigration, расположенном в установочном каталоге продукта, запустите J2CMigration.bat и J2CMigration.sh.
  4. Введите команду и опции в соответствии с информацией, приведенной в следующих таблицах.
    Табл. 1. Команды для запуска инструмента миграции J2C
    Команда для Windows Команда для Linux Описание
    J2CMigration.bat [опции] ./J2CMigration.sh [опции] Эта команда позволяет запустить инструмент миграции J2C следующими способами:
    Формат:
    • J2CMigration.bat -w файл-wsdl -d рабочая-область [-p проект] [-t тип] [-o опция] [-s обзор]
    • J2CMigration.bat -f входной-файл
    J2CMigration [опции]   Опции
    • -w файл-wsdl: Полный путь к файлу службы WSDL или папке с такими файлами.
    • -f входной-файл: Файл миграции, содержащий опции для передачи инструменту миграции. Такой способ рекомендуется использовать, если длина опций командной строки превышает максимальную допустимую длину. Дополнительная информация приведена в разделе SampleMigration.txt Пример файла ввода для миграции.
    • -d рабочая-область: Рабочая область для создания вывода.
    • [-p проект] : Имя проекта для создания перенесенных артефактов. Укажите только имя проекта. Для создания можно выбрать проект Java™, EJB или веб-проект. Если проект не указан, то по умолчанию создается проект Java. Если не указана опция -p, то перенесенные артефакты создаются в проекте, указанном в файле службы WSDL.
    • [-t тип]: Тип проекта:
      • WEB
      • EJB
      • JAVA
    • [-o опция]
      • databindingonly: Укажите эту опцию, если в ходе миграции требуется создать только объекты связывания данных. Если опция databindingonly указана, то опция commandbean игнорируется.
      • commandbean: Укажите эту опцию, если в ходе миграции требуется создать только командные JavaBean.
    • [-s обзор]: Имя файла для сохранения обзора миграции (без расширения .xml). Если значение не указано, то по умолчанию обзор сохраняется в файле j2cmigration_timestamp.xml. Если файл обзора уже существуют, то информация сохраняется в файле summary_timestamp.xml. Если указано расположение, например, d:\summaryFolder\summary, то папка summaryFolder должна существовать. Если расположение не указано, то файл обзора создается в текущем каталоге.
    • [cicsver]: Версия rar CIC в перенесенном проекте. Например, 6.1.0.2. Если версия адаптер ресурса CIC не указана, то приложение извлекает значение из реестра.
    • [imsver]: Версия rar IMS в перенесенном проекте. Например, 9.1.0.2.5a. Если версия адаптера ресурса IMS не указана, то приложение извлекает значение из реестра.
    • [wasver]: Версия сервера WebSphere Application Server, применяемого в перенесенном проекте. Если значение не указано, то по умолчанию применяется значение 7.0. Допустимые значения:
      • was.base.v61
      • was.base.v7
    • [cicsrar]: Полный путь к адаптеру ресурса CIC. Пример: d:\IBM\sdp75\ResourceAdapters\cicseci6102.rar.
    • [imsrar]: Полный путь к адаптеру ресурса IMS. Пример: d:\IBM\sdp75\ResourceAdapters\imsico91025.rar.
    • [suffix]: impl, proxy или другой суффикс для реализации J2C. Если значение не указано, то применяется суффикс реализации proxy.

Пример

Примеры миграции с помощью командной строки

J2CMigration.bat -d "d:\myworkspace" -w "d:\mywsdl.wsdl" -p "OutputProject"
./J2CMigration.sh -d /home/myworkspace -w /home/mywsdl.wsdl -p OutputProject
Эта команда переносит отдельную службу, описанную в файле d:\myservicewsd.wsdl. Перенесенные артефакты создаются в проекте Java с именем "OutputProject" в рабочей области d:\myworkspace. Создаются следующие файлы:
  • файл Java интерфейса
  • Файл Java Proxy (реализации)
  • файл Java связывания данных
  • Файл j2cmigration_timestamp.xml (Итоговые данные миграции сохраняются в текущем каталоге.
J2CMigration.bat  -w "d:\mywsdlFolder" -p "OutputProject" -s "MigrationReport"
./J2CMigration.sh -w /home/mywsdlFolder -p OutputProject -s /home/myworkspce/MigrationReport

Переносятся все службы из папки d:\myservicewsdlfolder и ее подпапок. Перенесенные артефакты (для всех служб) добавляются в проект Java с именем "OutputProject". Создаются следующие файлы:

J2CMigration.bat -w "d:\myfolder" -o databindingonly
./J2CMigration.sh -w /home/myfolder -o databindingonly

Переносятся все службы из папки d:\myfolder и ее подпапок. Создаются следующие файлы:

J2CMigration.bat -w "d:\myfolder" -o commandbean -t EJB
./J2CMigration.sh -w /home/myfolder -o commandbean -t EJB

Переносятся все службы из папки d:\myfolder и ее подпапок. Перенесенные артефакты добавляются в проекты EJB, имена которых извлекаются из определений WSDL. . Создаются следующие файлы и артефакты:

J2CMigration.bat -f "d:\SampleMigration.txt"
./J2CMigration.sh  -f /home/SampleMigration.txt"

Миграция выполняется в соответствии с опциями, указанным во входном файле миграции.


Комментарии