Convertendo as Chamadas de API Java

Uma ferramenta de migração de API é fornecida como um ponto inicial para converter código Java™ do cliente da versão anterior das APIs do produto de modelagem Rational UML para essa versão de API. Como a ferramenta é apenas um auxiliador para refatorar a API, após a execução da ferramenta haverá erros e tarefas do TODO que precisam ser resolvidas. Os plug-ins devem ser migrados em uma ordem apropriada, de acordo com as dependências.
Por Que e Quando Desempenhar Esta Tarefa
A ferramenta de migração de API é definida em sua própria capacidade, a capacidade de Migração de API RSx, que fica desativada por padrão.
Nota: A ferramenta trabalha melhor quando um pequeno conjunto de plug-ins relacionados é convertido em qualquer momento.

Para converter as chamadas de API Java:

  1. Ative o recurso da ferramenta de migração de API.
    1. Clique em Janela > Preferências.
    2. Na janela Preferências, expanda Geral e então clique em Recursos.
    3. Na lista Recursos, selecione a Migração de API RSx.
    4. Clique em Aplicar e OK.
  2. Customize a perspectiva para mostrar a ferramenta de Migração de API RSx na barra de ferramentas principal.
    1. Clique em Janela > Personalizar Perspectiva.
    2. Na janela Customizar Perspectiva - Java, clique em Comandos.
    3. Na lista Grupos de comandos disponíveis, selecione Ferramenta de Migração de API para ativar a ferramenta.
    4. Clique em OK.
    Se sua perspectiva estiver customizada, um botão de Ferramenta de Migração de API é incluído na barra de ferramentas principal.

    Ícone da ferramenta de migração de API

  3. Converter um conjunto de classes.
    1. Na visualização Explorador de Pacotes, selecione as classes, pacotes ou plug-ins que você deseja converter.
    2. Clique no botão Ferramenta de Migração de API na barra de ferramentas principal. Uma janela de Regras de Migração de API é aberta com uma caixa de opção para utilizar o conjunto de regras padrão e uma tabela das regras que serão utilizadas. É provável que muitos usuários utilizem esse conjunto de regras padrão que foram fornecidas com o plug-in.

      Regras de Migração de API

      Se a caixa de opção Utilizar conjunto de regras padrão estiver desmarcada, você pode navegar pelo sistema de arquivos para selecionar um ou mais arquivos de regras, como *.java2java, a ser utilizado. O conjunto de regras padrão consiste em todos os arquivos de regras localizados no plug-in com.ibm.xtools.apimigrate.ui na pasta de regras.

    3. Clique em OK. As regras são aplicadas contra as classes Java na seleção atual.

      Erros serão registrados no arquivo de log Eclipse padrão e também no arquivo APIMigration.log criado em seu diretório home. No Windows®, o diretório normalmente está nomeado com seu nome de usuário, dentro do diretório de Documentos e Configurações. Informações adicionais também estão na saída do arquivo APIMigration.log.

      As regras são aplicadas somente às classes Java. A correção nas dependências de plug-in e quaisquer outras alterações em arquivos não Java precisarão ser executadas manualmente. Em geral, essa ferramenta de migração de API trata alterações de API de produtos de modelagem Rational triviais, e a API reprovada tem sido mantida para construções de API mais complexas que foram alteradas. Por exemplo, mesmo se a API de gerenciamento de modelo Xtools MSL anterior ainda existir, pode ser melhor migrar o código do cliente para a nova API de gerenciamento de modelo transacional.


Feedback