Uma
ferramenta de migração de API é fornecida para ajudar a
converter as chamadas de API nas classes Java™,
mas a ferramenta não modifica quaisquer arquivos não Java como
dependências de plug-in e pontos de extensão nos arquivos plugin.xml. A ferramenta de migração contém um mecanismo de procura e substituição baseado em regra juntamente com um grande conjunto de regras para converter as chamadas de API públicas disponíveis no release anterior dos produtos de modelagem Rational nas chamadas equivalentes para a versão atual. As procuras estão cientes das semânticas
Java
(importações, declarações de classe, chamadas de método, etc.).
Por Que e Quando Desempenhar Esta Tarefa
Há várias etapas
necessárias para migrar código do cliente que eram utilizadas nas
API da versão 6 e pontos de extensão. Devido à complexidade de alterações UML2 entre versões 1.x e 2.1,
algumas modificações necessárias não podem ser tratadas pelo
mecanismo de procura-e-substituição. Nesses casos, as regras inserirão comentários TODO no
código-fonte
Java
com uma indicação de quais necessidades serão feitas. Quando a ferramenta está instalada, o usuário pode selecionar
classes
Java,
pacotes Java
ou projetos Java
e então executar essa ferramenta de migração de API contra a seleção. A ferramenta vasculha as classes
Java
e aplica as ferramentas de migração.
Nota: Devido a um grande número de regras e ao número de
procuras
Java
que precisarão ser executadas, a ferramenta é melhor executada
contra um pequeno conjunto de plug-ins e não uma execução de lote
enorme. Portanto, o uso proposto da ferramenta é para equipes individuais
converterem seus plug-ins.
Para ativar o teste, isso implicaria que o
plug-in de menor nível na cadeia de dependências precisaria ser
convertido primeiro.
A ferramenta de migração de API fornece apenas um
ponto inicial para as alterações que talvez precisem ser feitas
no código do cliente. Para ver exemplos do código do cliente, clique em
,
e escolha um dos exemplos do Plug-in do Modeler.