Para criar uma transformação, é necessário criar um plug-in do Eclipse
que contenha uma instância do ponto de extensão do provedor de transformação e
um provedor de transformação.
Por Que e Quando Desempenhar Esta Tarefa
Para criar um projeto de transformação:
- Crie plug-in do Eclipse:
- Clique em .
- Na página Selecionar um Assistente, na área de janela Assistentes,
expanda Autoria de Transformação e clique em Projeto de
Transformação Genérico.
- Clique em Avançar.
- No assistente Novo Projeto de Plug-in, na página Projeto de Plug-in,
no campo Nome do Projeto, especifique um nome de projeto. Se você especificar um nome que contenha espaços nas páginas restantes do
assistente, os espaços serão convertidos em sublinhados no identificador (ID) de plug-in
e no nome do plug-in. Aceite os valores padrão para os outros campos desta
página e clique em Avançar.
- Na página Conteúdo do Plug-in, especifique a estrutura
do projeto e clique em Avançar. As
informações especificadas nesta página são utilizadas para customizar o arquivo de manifesto
de plug-ins e a classe Java™ de nível superior no plug-in.
- Na página Modelos, se ainda não estiver selecionado, selecione a caixa de opção Criar
um plug-in utilizando um dos modelos.
- Na área de janela Modelos Disponíveis, clique em Plug-in com
Transformação e clique em Avançar.
- Na página Novo Provedor de Transformação, crie
um provedor de transformação:
- No campo Pacote, aceite o valor
padrão ou especifique o nome do pacote que contém a implementação
da classe do provedor de transformação abstrato.
- No campo Classe, aceite o valor
padrão ou especifique o nome da classe que implementa a classe do provedor de
transformação abstrato.
Nota: Para obter
informações adicionais sobre os outros campos desta página e de páginas restantes
no assistente, consulte a ajuda contextual pressionando F1 quando
essa página for exibida no produto. Se
você estiver utilizando a plataforma Linux®, para obter informações adicionais sobre os outros
campos desta página e de páginas restantes no assistente, consulte a ajuda contextual
pressionando Shift+F1 quando essa página for exibida
no produto.
- Clique em Avançar.
- Na página Nova Transformação, conclua as
seguintes etapas:
- Para criar um elemento Transformation e registrar essa transformação
no serviço de transformação, aceite os valores padrão ou especifique valores
para os seguintes campos:
- ID
- Nome
- Classe
- Tipo do Modelo de Origem. Para alterar o tipo de modelo, clique
no botão de reticências (...).
- Tipo do Modelo de Destino. Para alterar o tipo de modelo, clique
no botão de reticências (...).
- Caminho do Grupo
- Versão
- Para definir as propriedades de transformação que
aperfeiçoam a saída da transformação, ao lado da tabela Propriedades, clique em Inserir e
especifique valores para os campos da tabela. Na próxima vez que você criar
uma configuração de transformação para essa transformação, as propriedades
definidas serão exibidas na página Propriedades do assistente
Nova Configuração de Transformação ou no editor de configuração de
transformação.
Nota: Para especificar propriedades de transformação posteriormente, você deve
editar o arquivo de manifesto de plug-ins.
- Para excluir uma propriedade de transformação, clique em uma
linha na tabela Propriedades e clique em Excluir.
- Para criar regras de transformação, verifique se
a caixa de opção Utilizar estrutura de transformação UML2 padrão
está selecionada. Se você limpar essa caixa de opção, a página Nova Definição de Regra
não estará disponível no assistente.
Nota: Para incluir uma regra na transformação
posteriormente, você deverá criar manualmente uma classe Java que estenda a classe com.ibm.xtools.transform.core.AbstractRule,
customizar o código na classe e incluir uma instância da regra no
arquivo Java
que contém a implementação de transformação.
- Clique em Avançar.
- Opcional: Na página Novas Definições de Regras, especifique
as regras da transformação:
- Para incluir uma regra na transformação, clique em Inserir e
especifique valores para os campos na tabela.
- Para excluir uma regra, clique em uma regra na tabela e clique em Excluir.
- Clique em Concluir.
Resultados
Um projeto de plug-in do Eclipse que contém os seguintes artefatos é
criado no espaço de trabalho:
- Uma pasta src/n/transformationProvider,
em que n é o nome do projeto, que contém uma implementação Java
para um provedor de transformação e uma transformação
- Uma pasta src/n/m.rules,
em que m é o nome da transformação, que contém
uma implementação para cada regra de transformação ou extrator que for definido
- Um arquivo de manifesto de plug-ins que define as dependências de plug-in e
os seguintes elementos:
- Um ponto de extensão com.ibm.xtools.transform.core.transformationProviders
- Um elemento TransformationProvider e Transformation
- Um elemento Property para cada propriedade que for definida
A transformação que for especificada nesse plug-in será registrada
automaticamente no serviço de transformação.
Para obter informações adicionais sobre os elementos
descritos nesse tópico, consulte
o
Rational Transformation
Developer Guide.
Nota: Algumas informações, como links para a documentação do Eclipse
ou para guias de desenvolvedor, estão disponíveis apenas a partir dos tópicos
na ajuda do produto.