Executando Transformações de Java em UML

Antes de poder executar uma transformação, você cria uma configuração de 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.

Antes de Iniciar

Um arquivo de configuração de transformação existe no espaço de trabalho ou em um arquivo que é possível acessar especificando uma URL.

Sobre Esta Tarefa

A transformação de Java em UML utiliza a funcionalidade de comparação e fusão para determinar as diferenças entre o modelo de destino e o modelo temporário gerados pela transformação. Ao executar a transformação de Java em UML, o editor de fusão exibe as diferenças entre os dois modelos. No editor de mesclagem, é possível selecionar as mudanças mescladas pela transformação no modelo de destino.

A tabela a seguir lista vários métodos diferentes para executar transformações na coluna Opção e fornece os procedimentos associados para esses métodos na coluna Descrição.

Procedimento

Conclua as etapas para uma das opções na seguinte tabela:
Opção Descrição
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.
Substituir a origem da transformação definida em uma configuração de transformação Na perspectiva Modelagem, selecione e clique com o botão direito do mouse em elementos no modelo ou projeto de origem; em seguida, clique em Transformar, clique em uma configuração de transformação e clique em uma transformação.

O arquivo de configuração de transformação deve estar no mesmo projeto que os elementos selecionados.

A configuração de transformação não é afetada e a origem especificada na página Origem e Destino do editor de configuração de transformação ou no assistente de Nova Configuração de Transformação não é alterada.

Dica: Para executar essa transformação novamente, clique em Modelagem > Transformação > Executar Última. A transformação usa os mesmos elementos de origem que quando você executou a transformação pela última vez.
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:
  1. Em um projeto na área de trabalho atual, crie um arquivo denominado build.xml.
  2. No arquivo build.xml, insira o seguinte conteúdo:
    <?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>
  3. Substitua a variável myProject pelo nome de seu projeto de destino e a variável myConfig.tc pelo nome do arquivo de configuração da transformação que está sendo referida nesse projeto.
  4. Para os tipos de transformação que suportam uma transformação inversa, execute a 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.
  5. Clique com o botão direito do mouse no arquivo build.xml; em seguida, clique em Executar como > Compilação Ant.
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.

  1. Clique em Arquivo > Novo > Outro > Transformações > Configuração de Transformação e, em seguida, clique em Avançar.
  2. Conclua as etapas no Novo assistente de configuração de transformação:
    1. 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 Geral > Composta.

    2. 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.

    3. Clique em Concluir.
  3. Na página Principal do editor de configuração de transformação, clique em Executar.

Feedback