Executando Transformações de

É possível executar uma transformação de Java em Modelo de Serviço aplicando uma configuração de transformação ou selecionando uma classe ou interface Java™ em um projeto Java ou diagrama de classes.
Antes de Iniciar
Para executar uma transformação de Java em Modelo de Serviço aplicando uma configuração de transformação, um arquivo de configuração de transformação deve existir no espaço de trabalho ou como um arquivo que pode ser acessado com a especificação de uma URL. Para executar a transformação selecionando uma classe ou interface Java, o elemento Java deve ser uma interface Java ou uma classe Java que implementa uma interface em um projeto Java no espaço de trabalho atual.
Por Que e Quando Desempenhar Esta Tarefa

A transformação de Java em Modelo de Serviço 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 Modelo de Serviço, o editor de fusão exibe as diferenças entre os dois modelos. Na janela do editor de fusão, é possível selecionar as alterações que a transformação funde ao modelo de destino.

Para executar uma transformação, conclua as etapas para uma das opções na tabela a seguir:
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 de transformação: Na guia 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:
  1. 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 Incluir UML > Gerar Modelo de Serviço.
  2. 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:
  1. 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.
  2. 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, utilize a seguinte sintaxe:
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. Essa 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 MyTransformation, você pode executar a configuração MyConfig.tc digitando o seguinte texto na linha de comandos:
    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 da configuração de transformação, como neste exemplo:
    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. É 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, você pode 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.
}
Você pode 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 Executar como > Compilação Ant.


Feedback