Migrando Programas J2C Usando a Linha de Comandos

É possível usar a linha de comandos para migrar programas do WebSphere Studio Application Developer Integration Edition para as ferramentas do aplicativo Rational.

Procedimento

  1. Altere para o diretório onde os arquivos J2CMigration.bat e J2CMigration.sh estão localizados:
    • ícone do Windows: o diretório de instalação padrão para a ferramenta de migração J2C é system_drive: <install-dir>\plugins\com.ibm.j2c.migration.wsadie_7.2.0.vxxx.
    • ícone do Linux: o diretório de instalação padrão para a ferramenta de migração J2C é: <install-dir>\plugins\com.ibm.j2c.migration.wsadie_7.2.0.vxxx.
  2. É necessário modificar J2CMigration.bat ou J2CMigration.sh
    1. Localize o local no arquivo onde você configura variáveis:
      ECLIPSE_ROOT: É onde os arquivos eclipse.exe e eclipse.ini estão localizados. O valor padrão será <install-dir> para produtos de desenvolvimento de aplicativo Rational.
      • ícone do Windows ECLIPSE_ROOT= <install-dir>, onde você configura o local do diretório para corresponder ao seu ambiente.
      • ícone do Linux SET ECLIPSE_ROOT=/opt/<install-dir>
      JDK_HOME : É onde o java.exe está localizado.
      • ícone do Windows O caminho padrão é %ECLIPSE_ROOT%\jdk\jre\bin
      • ícone do Linux SET JDK_HOME=%ECLIPSE_ROOT%/jdk/jre/bin
      .
      rarsPathVar : É o caminho onde a pasta Resource Adapters está localizada. É possível localizar o caminho exato abrindo <install_path>configuration/config.ini e procurando rarsPathVar.
      • Ícone do Windows SET RARVARPATH=%ECLIPSE_ROOT%/ResourceAdapters.
      • Ícone do Linux SET RARVARPATH=%ECLIPSE_ROOT%/ResourceAdapters
      was.runtime: É onde a pasta do tempo de execução do WAS está localizada. É possível localizar o caminho exato abrindo <install_path>configuration/config.ini e procurando rarsPathVar.
      • ícone do Windows SET WASRUNTIME=%ECLIPSE_ROOT%/runtimes
      • ícone do LinuxSET WASRUNTIME=%ECLIPSE_ROOT%/runtimes
      EQUINOXJAR: É onde o arquivo JAR org.eclipse.core.Launcher.Main está localizado.
      • ícone do Windows SET EQUINOXJAR=%ECLIPSE_ROOT%\plugins\org.eclipse.equinox.launcher_1.0.101.R34x_v20081125.jar
      • ícone do LinuxSET EQUINOXJAR=%ECLIPSE_ROOT%/plugins/org.eclipse.equinox.launcher_1.0.101.R34x_v20081125.jar
      • A área de trabalho padrão %WORKSPACE% %WORKSPACE% será configurada como: %WORKSPACE%%ECLIPSE_ROOT%\workspace\Migration1 ou %ECLIPSE_ROOT%\workspace\Migration1 no arquivo em lote de migração ou shell script.
  3. Salve e feche o arquivo. No diretório J2CMigration na pasta de instalação do produto, execute J2CMigration.bat e J2CMigration.sh.
  4. Insira a opção e o comando apropriados conforme descrito nas tabelas abaixo:
    Tabela 1. Comandos para Execução da Ferramenta de Migração J2C
    Comando do Windows Comando do Linux Descrição
    J2CMigration.bat [options] ./J2CMigration.sh [options] Use este comando para iniciar a ferramenta de migração J2C usando um dos dois padrões de uso:
    Uso:
    • J2CMigration.bat -w wsdlsource -d workspace [-p project] [-t type] [-o option] [-s summary]
    • J2CMigration.bat -f migrationinputfile
    J2CMigration [options]   Opções
    • -w wsdlsource: O caminho completo do arquivo WSDL de serviço ou o caminho completo da pasta que contém um ou mais arquivos WSDL de serviço.
    • -f migrationinputfile: O arquivo de migração que contém as opções acima para serem passadas para a ferramenta de migração de linha de comandos. Esse método é útil quando suas opções da linha de comandos excedem o comprimento máximo permitido. Consulte SampleMigration.txt Arquivo de Entrada de Migração de Amostra para referência.
    • -d workspace: A área de trabalho onde a saída é gerada.
    • [-p project] : O nome do projeto onde os artefatos migrados serão gerados. Não inclua um caminho, apenas um nome para o projeto. É possível especificar um projeto da web, Java™ ou EJB para ser criado. Se nenhum projeto for especificado, um projeto Java padrão será criado. Se você não especificar a opção -p, os artefatos migrados serão gerados para o projeto especificado no arquivo WSDL de serviço.
    • [-t type]: Tipo de projeto do projeto de saída:
      • WEB
      • EJB
      • JAVA
    • [-o option]
      • databindingonly: Especifique esta opção se deseja que apenas beans de ligação de dados sejam gerados durante a migração. Se você especificar databindingonly, a opção commandbean será ignorada.
      • commandbean: Especifique esta opção se quiser que um bean de comando seja gerado.
    • [-s summary]: O nome do resumo de migração (sem .xml). Se nenhum for especificado, o arquivo de resumo padrão será j2cmigration_timestamp.xml. Se o arquivo de resumo já existir, gravaremos o resumo em summary_timestamp.xml. Se você especificar um local, por exemplo, d:\summaryFolder\summary, summaryFolder deverá existir. Se você não especificar um local, o resumo será gerado no diretório atual.
    • [cicsver]: A versão do rar do CICs que você está usando no projeto migrado. Por exemplo, 6.1.0.2. Se nenhuma versão de adaptador de recursos CICs for especificada, o aplicativo localizará uma no registro.
    • [imsver]: A versão do rar do IMS que você está usando no projeto migrado. Por exemplo, 9.1.0.2.5a. Se nenhuma versão do IMS Resource Adapter for especificada, o aplicativo localizará uma no registro.
    • [wasver]: A versão do WebSphere Application Server que você está usando no projeto migrado. Se nenhuma for especificada, o padrão será 7,0. Valores válidos:
      • was.base.v61
      • was.base.v7
    • [cicsrar]: O caminho completo para o adaptador de recursos do CICs. Por exemplo: d:\IBM\sdp75\ResourceAdapters\cicseci6102.rar.
    • [imsrar]: O caminho completo para o IMS Resource Adapter. Por exemplo: d:\IBM\sdp75\ResourceAdapters\imsico91025.rar.
    • [suffix]: impl, proxy ou qualquer sufixo que você queira usar para implementação do J2C. Se essa opção não for especificada, o sufixo da implementação será proxy.

Exemplo

Exemplos de migração de linha de comandos

J2CMigration.bat -d "d:\myworkspace" -w "d:\mywsdl.wsdl" -p "OutputProject"
./J2CMigration.sh -d /home/myworkspace -w /home/mywsdl.wsdl -p OutputProject
Essa linha de comandos migrará um único serviço, conforme definido em d:\myservicewsd.wsdl. Os artefatos migrados são gerados em um projeto Java com o nome de projeto "OutputProject" dentro da área de trabalho d:\myworkspace. Os arquivos gerados são
  • Arquivo Java de interface
  • Arquivo Java de proxy (implementação)
  • Arquivo Java de ligação de dados
  • Arquivo j2cmigration_timestamp.xml (O resumo da migração será salvo no diretório atual.
J2CMigration.bat  -w "d:\mywsdlFolder" -p
"OutputProject" -s "MigrationReport"
./J2CMigration.sh -w /home/mywsdlFolder -p OutputProject -s
/home/myworkspce/MigrationReport

Isso migrará todos os serviços na pasta d:\myservicewsdlfolder ou em quaisquer outras subpastas em d:\myservicewsdlfolder. Os artefatos migrados (para todos os serviços) são gerados em um único projeto Java com o nome de projeto "OutputProject". Os arquivos gerados são

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

Isso migrará todos os serviços na pasta d:\myfolder ou em quaisquer outras subpastas sob d:\myfolder. Os arquivos gerados são:

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

Isso migrará todos os serviços na pasta d:\myfolder ou em quaisquer outras subpastas sob d:\myfolder. Os artefatos migrados são gerados em projetos EJB com os nomes de projeto obtidos das definições de WSDL . Os arquivos e os artefatos gerados são:

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

Migre de acordo com as opções especificadas no arquivo de entrada de migração.


Feedback