Migrando APIs de Extensibilidade

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 Arquivo > Novo > Exemplo, e escolha um dos exemplos do Plug-in do Modeler.


Feedback