Você pode criar páginas customizadas para configurações de transformação.
Você pode criar essas páginas para que os usuários da transformação possam especificar valores para as
propriedades incluídas em uma transformação.
Quando um usuário de transformação cria uma configuração de transformação, as novas
páginas são exibidas no editor ou no assistente de configuração de transformação.
Antes de Iniciar
Um autor de transformação deve registrar a transformação no
serviço de transformação. A transformação deve definir as propriedades associadas às novas guias de
configuração.
Como o autor de páginas de configuração de transformação
customizadas, você deve identificar um projeto no espaço de trabalho que contenha esses artefatos de
interface com o usuário. É possível criar um projeto que contenha o código
Java™ que implemente as novas páginas, ou é possível definir as páginas
em um projeto existente que contenha uma transformação.
Nota: O exemplo nesse tópico presume que você defina
as páginas customizadas em um plug-in diferente da transformação.
Para obter
informações adicionais sobre as classes da interface com o usuário listadas nesse tópico, consulte a seção
"UI de Transformação"
do
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.
Por Que e Quando Desempenhar Esta Tarefa
Para incluir páginas
em uma configuração de transformação:
- No projeto que você identificou para conter as páginas customizadas, crie as
seguintes classes Java:
- Uma classe que estende a classe com.ibm.xtools.transform.ui.AbstractTransformGUI
- Para cada página com a qual você contribui para a configuração de transformação, uma classe que estende a
classe com.ibm.xtools.transform.ui.AbstractTransformConfigTab
- Alterne para a perspectiva Java: Clique em
.
- Na visualização Package Explorer, dê um clique duplo na classe
Java que você criou na etapa
1, que estende a classe
com.ibm.xtools.transform.ui.AbstractTransformGUI.
- No editor de arquivo Java, especifique o código
Java para substituir o método nomeado
getConfigurationTabs(ITransformationDescriptor descriptor). Esse
método retorna a lista de páginas para exibir no editor de configuração de transformação ou assistente. É
possível usar o seguinte fragmento de código como um exemplo:
public AbstractTransformConfigTab[] getConfigurationTabs(
ITransformationDescriptor descriptor) {
AbstractTransformConfigTab[] superTabs =
super.getConfigurationTabs(descriptor);
AbstractTransformConfigTab[] myTabs =
new AbstractTransformConfigTab[superTabs.length + 1];
for (int i = 0; i < superTabs.length; i++) {
myTabs[i] = superTabs[i];
}
myTabs[myTabs.length - 1] = new MyTab(descriptor, "My tab ID", "My tab label");
return myTabs;
}
- Para cada classe que você criou na etapa 1 que
estende a classe com.ibm.xtools.transform.ui.AbstractTransformConfigTab, implemente os métodos nomeados
populateContext, populateTab, e createContents, como no exemplo a seguir:
public Control createContents(Composite parent) {
Composite contents = new Composite(parent, SWT.None);
contents.setLayout(new GridLayout());
text = new Text(contents, SWT.None);
text.addModifyListener(new ModifyListener() {
public void modifyText(ModifyEvent e) {
setDirty();
}
});
return contents;
}
public void populateContext(ITransformContext context) {
context.setPropertyValue("MyPropertyId", text.getText());
}
public void populateTab(ITransformContext context) {
String newText = (String) context.getPropertyValue("MyPropertyId");
if (newText == null) {
newText = "";
}
text.setText(newText);
}
- Clique em ; e
depois reconstrua o projeto.
- Abra a perspectiva Desenvolvimento de Plug-ins: Clique em
.
- Na visualização Package Explorer, expanda o nome do projeto que contém a
transformação para a qual você está criando as páginas customizadas.
- Na pasta META-INF do projeto de transformação, dê um clique duplo no
arquivoMANIFEST.MF.
- Na página Extensões, na seção Todas as Extensões, clique no elemento
Transformação ao qual incluir as páginas customizadas.
- Na seção Detalhes do Elemento de Extensão, no campo
transformGUI, especifique o identificador de plug-in (ID) e o nome do pacote e classe
Java que você criou na etapa
1, que substitui o método
getConfigurationTabs(ITransformationDescriptor descriptor). Se a class que estende a classe
com.ibm.xtools.transform.ui.AbstractTransformGUI estiver localizada no mesmo plug-in da transformação, não
especifique o ID de plug-in. Um parâmetro nomeado transformGUI é incluído no arquivo MANIFEST.MF, como no
seguinte exemplo:
<Transformation
groupPath="myTrans"
id="myTrans.transformation"
name="Transformation"
sourceModelType="resource"
targetModelType="resource"
transformGUI="com.myTransform.ui/com.myTransform.ui.MyGUI"</Transformation>
</Transformation>
- Clique em .
Resultados
Para testar as páginas customizadas, inicie um ambiente de trabalho de tempo de execução e crie uma
configuração de transformação para a transformação.
O editor de configuração de
transformação e o assistente exibem as páginas que estão na lista que o método getConfigurationTabs
retorna.