| Utilizar uma configuração de transformação |
Dependendo da visualização em que você estiver, conclua
uma das seguintes etapas:- Na visualização de navegação, clique com o botão direito do mouse em um arquivo de configuração
de transformação (.tc); em seguida, clique em Transformar e clique em uma transformação. Quando você aplica uma configuração de transformação, uma instância da transformação
é criada e executada com as propriedades definidas nessa
configuração.
Nota: Também é possível
aplicar uma configuração de transformação a partir do editor de configuração
da transformação: Na página Principal, clique em Executar ou,
na barra de ferramentas no canto superior direito, clique no ícone que exibe
o nome da transformação.
- Na visualização Explorador de Padrões,
clique com o botão direito do mouse em uma transformação; em seguida, clique em Executar Transformação.
Na caixa de diálogo Selecionar Configuração, especifique a
configuração de transformação a ser executada e clique em OK.
|
| Executar a transformação a partir da visualização Project Explorer |
Para executar a transformação a partir da visualização Project Explorer, execute as seguintes etapas:- Na visualização Project Explorer, em um projeto Java, clique com o botão direito do mouse em um arquivo de classe Java ou em um arquivo de interface Java; em seguida, clique em .
- Na janela Gerar um Modelo de Serviço, especifique a transformação do modelo de serviços a ser executada e o nome do arquivo para o modelo de serviços gerado.
|
| Execute a trabsformação a partir de um diagrama de classes no projeto Java |
Para executar a transformação a partir de um diagrama de classes em um projeto Java, execute as seguintes etapa:- Em um diagrama de classes, clique com o botão direito do mouse em uma representação de classe Java ou de interface Java; em seguida, clique em Gerar Modelo de Serviço.
- Na janela Gerar um Modelo de Serviço, especifique a transformação do modelo de serviços a ser executada e o nome do arquivo para o modelo de serviços gerado.
|
| Executar a transformação a partir da linha de
comandos |
Para
executar uma transformação a partir de uma linha de comandos, use a sintaxe
a seguir e insira o comando em uma linha:eclipse -data workspace-path -application com.ibm.xtools.transform.core.transformationRunner
-transformConfigs "[-R]transformation-configuration-path1,
[-R]transformation-configuration-path2,..."
No parâmetro -transformConfigs,
é necessário especificar o nome completo do caminho do espaço de trabalho e do arquivo de configuração,
não o nome do caminho do sistema de arquivo, de uma ou mais configurações de transformação.
A execução de uma transformação a partir de uma
linha de comandos suprime todas as caixas de diálogo geradas pela transformação.
Como
um exemplo, uma configuração de transformação chamada MyConfig.tc está em um projeto
chamado MyProject em um espaço de trabalho chamado MyWorkspace. Esta configuração de transformação
especifica as informações de configuração para uma transformação chamada
MyTransformation e para uma transformação reversa correspondente chamada
MyReverseTransformation.- Para
chamar a transformação MyTransformation, é possível executar a configuração
MyConfig.tc inserindo o comando a seguir em uma linha:
eclipse -data /MyWorkspace -application com.ibm.xtools.transform.core.transformationRunner
-transformConfigs "MyProject/MyConfig.tc"
- Para
executar a transformação reversa, especifique a opção -R no início
do caminho de configuração da transformação e insira o comando
em uma linha:
eclipse -data /MyWorkspace -application com.ibm.xtools.transform.core.transformationRunner
-transformConfigs "-RMyProject/MyConfig.tc"
- Para
executar várias transformações, no parâmetro -transformConfigs,
especifique uma lista separada por vírgula de configurações de transformação, incluindo
o nome do caminho do espaço de trabalho para cada configuração. Insira o comando em uma linha. É possível executar transformações avançadas
ou reversas, como neste exemplo:
eclipse -data /MyWorkspace -application com.ibm.xtools.transform.core.transformationRunner -transformConfigs "MyProject/MyConfig.tc, -RMyProject/MyConfig.tc"
|
| Chamar a API da transformação |
Para executar a transformação
como parte de um aplicativo, é possível chamar a API de transformação, como no
exemplo a seguir:IFile file = ResourcesPlugin.getWorkspace().getRoot().getFile(new Path("/MyWorkspace/MyConfig.tc"));
try {
ITransformConfig config = TransformConfigUtil.loadConfiguration(file);
IStatus status = TransformController.getInstance().execute(config, null, false, null);
}
catch (IOException e) {
// O arquivo de configuração não pôde ser lido.
}
Você também pode carregar uma configuração
de transformação especificando uma URL, como no exemplo a seguir: try {
URL url= new URL(platform:/plugin/myPluginID/myConfig.tc);
ITransformConfig config = TransformConfigUtil.loadConfiguration(url);
}
catch (MalformedURLException malURLEx) {
// Manipular exceção.
}
catch (IOException ioEx) {
// Manipular exceção.
}
É possível especificar uma URL que utilize protocolos
diferentes, como nos exemplos a seguir: - plataforma:/plugin/myPluginID/myConfig.tc
- http://myServer.myCompany.com/myConfig.tc
- ftp://myUsername:myPassword@myServer.myCompany.com/myConfig.tc
- jar:arquivo:c:/myFolder/myJar.jar!/myConfig.tc
- arquivo:c:/myFolder/myConfig.tc
|
| Executar uma configuração de transformação a partir de um
script Ant |
Para executar uma transformação de um script
Ant ou arquivo build.xml, complete as seguintes etapas:<?xml version="1.0" encoding="UTF-8"?>
<project name="myProject" default="generate" basedir=".">
<target name="generate">
<echo>Executando a transformação 'myProject/myConfig.tc' ...</echo>
<com.ibm.xtools.transform.core.runTransformation transformConfig="myProject/myConfig.tc" reverse="false"/>
</target>
</project>
No
arquivo build.xml, no elemento project, configure o atributo
default igual ao valor que você especificou para o
atributo name no elemento de destino.
O atributo transformConfig
deve especificar um caminho de espaço de trabalho válido.
Para
tipos de transformação que suportam uma transformação inversa, para
executar uma transformação inversa, configure o atributo reverso para
true. Nota: A
configuração de transformação deve implementar o Design Contract Management Protocol (DCMP) de
Modelagem Reconciliada.
Para
executar um script Ant, clique com o botão direito do mouse no
arquivo build.xml; em seguida, clique em
.
|
| Execute várias configurações de transformação
de modo consecutivo |
É possível executar várias configurações de transformação de modo consecutivo para concluir as seguintes tarefas: - Transformar um modelo UML em código para vários domínios
- Transformar um modelo ou elementos UML no modelo em projetos de destino diferentes
- Sincronizar as mudanças entre um modelo e um código
Para obter informações adicionais
sobre a execução de configurações consecutivas, consulte o link para o tópico de conceito relacionado sobre as transformações e configurações de transformação no final desse tópico.
Para executar várias configurações de transformação de maneira consecutiva,
crie e execute uma configuração de transformação para realizar uma transformação
composta. As configurações a serem executadas já deverão existir na
área de trabalho atual.
- Clique em e, em seguida, clique em Avançar.
- Conclua as etapas no Novo assistente de configuração de transformação:
- Na página doEspecifique um Nome e uma Transformação de Configuração, especifique os detalhes da configuração.
Para selecionar a transformação composta,
na seção Transformação , clique em .
- Na página Configurações de Transformação,
selecione as configurações de transformação a serem executadas e a ordem na qual executá-las.
Na tabela do "Configurações de Transformação Selecionadas",
na coluna Transformação, selecione a transformação para frente ou reversa.
- Clique em Concluir.
- Na página Principal
do editor de
configuração de transformação,
clique em Executar.
|