UML: Aplicações Java de engenharia reversa

Neste tutorial, você aprende como reverter a engenharia do código-fonte de uma aplicação Java existente em um projeto UML. No projeto UML, todas as classes e outros elementos da aplicação são representados na janela Projetos sob o nó do projeto UML, enquanto o código Java original permanece em seu estado original. Este documento guia você através das diversas tarefas básicas, conforme indicadas pelos links de tópicos listados em Conteúdo.

Duração esperada: 25 minutos

Criando os projetos Java e UML de amostra

Nesta seção, use o assistente para Novo projeto para criar o projeto Java e UML de amostra e fornecido com o IDE.

1. No menu principal do IDE, escolha Arquivo > Novo projeto.
   É exibido o assistente para Novo projeto.
2. Na página Escolher projeto, expanda o nó Amostras no painel Categorias e selecione o nó UML.
   O painel Projetos é atualizado com o projeto de UML amostra.
3. No painel Projetos, selecione UML Bank App Sample e clique em Próximo.
4. Na página Nome e localização, deixe o valor padrão UMLBankAppSample para o nome do projeto Java.
5. Para o campo Localização dos projetos, clique em Explorar para navegar para a pasta em que deseja salvar os arquivos de amostra.
   Observe que quando você altera o valor no campo Localização dos projetos, o IDE automatiza automaticamente os valores nos campos Pasta do projeto Java e Pasta do projeto UML.
6. Deixe o valor padrão UMLBankAppSample-Model para o nome do projeto UML.
7. Clique em Terminar.
   A caixa de diálogo de progresso Abrir projetos se abre.
   Os projetos UMLBankAppSample e UMLBankAppSample-Model aparecem na janela Projetos.

 Exibir demonstração

início

Explorando o projeto UML na janela Projetos

Esta seção passa por partes diferentes da aplicação UMLBankAppSample, explorando os diferentes recursos da janela Projetos que representa os elementos da aplicação.

1. No menu principal, selecione Janelas > Propriedades para abrir a janela Propriedades.
2. Na janela Projetos, expanda o nó UMLBankAppSample-Model> Model > bankpack.
3. Expanda o nó BankAccount e seu nó Attributes.
   Todos os atributos da classe BankAccount estão contidos nesta pasta. Se houver menos do que três atributos, os atributos aparecerão sob o nó da classe sem uma pasta Attributes.
4. Selecione o nó Attribute rotuladosaldo duplo privado.
   A janela Propriedades mostra o nome do atributo e de suas propriedades.
5. Na janela Projetos, no nó da classe BankAccount, expanda o nó Operações .
   Todas as operações na classe BankAccount são exibidas sob esse nó.
6. Na classe BankAccount, expanda o nó Relacionamentos .
   Os nós dos três tipos de relacionamentos são exibidos: Specializations, Aggregation e Implementation.
7. Expanda o nó Specializations , em segunda, os três nós Generalization.
   Os links Generalization mostram o relacionamento entre a classe BankAccount com outros elementos (as classes Checking, Platinum e Saving ).
8. (Opcional) Antes de continuar com a próxima seção, feche os nós expandidos sob a classe BankAccount.

    Exibir demonstração

   início

Criando outro projeto UML por engenharia reversa

Na primeira seção deste tutorial, você carregou o projeto Java UMLBankAppSample e o projeto UML, UMLBankAppSample-Model, que foi gerado por meio do recurso engenharia reversa. Nesta seção, você percorre as etapas para criar outro projeto UML revertendo a engenharia do mesmo projeto Java UMLBankAppSample usado na seção anterior.

1. Na janela Projetos, clique com o botão direito do mouse no nó UMLBankAppSample e escolha Engenharia reversa.
   A caixa de diálogo Engenharia reversa se abre.
   Observe que o campo Nós selecionados contém o valor não-editável UMLBankAppSample.
2. Deixe as caixas de seleção marcadas na coluna Reverter engenharia.
3. Selecione o botão Criar novo projeto UML.
4. No campo Nome do projeto, aceite o padrão, UMLBankAppSample-Model1.
5. Para o campo Localização do projeto, deixe o valor padrão, que é o diretório em que você salvou os projetos de amostra UML.
   Se você quiser usar uma pasta diferente, clique em Explorar para navegar para a essa pasta , e clique em Abrir.
6. Clique em OK.
   A caixa de diálogo de progresso Abrir projetos se abre.
   O projeto UMLBankAppSample-Model1 aparece na janela Projetos.

 Exibir demonstração

início

Gerando um diagrama de classe

Nesta seção, você gera o diagrama de classe da aplicação UMLBankAppSample que importou na seção anterior.

1. Na janela Projetos, sob o nó UMLBankAppSample-Model, expanda o nó Model e expanda o nó bankpack sob ele.
2. Selecione a pasta bankpack e todos os elementos sob a pasta bankpack, mantendo pressionada a tecla Shift ou Ctrl, ao fazer a seleção.
3. Clique com o botão direito do mouse nos elementos selecionados e escolha Criar diagrama a partir de elementos selecionados no menu pop-up.
   O assistente para Criar novo diagrama se abre.
4. Na lista Tipo de diagrama, selecione Diagrama de classe.
5. Digite BankClassDiagram no campo Nome do diagrama, deixe UMLBankAppSample-Model no campo Namespace e clique em Terminar.
   O IDE realiza os seguintes procedimentos:
   
   • Cria um nó BankClassDiagram sob o nó Modelo
   • Exibe o novo diagrama no Editor de diagramas
   • Abre a Paleta de modelagem
   Observação: o novo diagrama BankClassDiagram consiste em todos os elementos que você selecionou na Etapa 2 .

 Exibir demonstração

início

Explorando o Editor de diagramas

Nesta seção, você usa os botões da barra de ferramentas do diagrama para exibir a aplicação em vários layouts UML no Editor de diagramas.

1. Clique duas vezes na aba BankClassDiagram na parte superior do Editor de diagramas.
   Esta ação estica a classe do Editor de diagramas para preencher o espaço inteiro da janela do IDE.
   
   Observação: trata=se de uma alternância: para rever essa ação, clique duas vezes novamente na aba BankClassDiagram.
2. Permaneça no Editor de diagramas expandido e clique no botão Ajustar à janela na barra de ferramentas do Diagrama para exibir completamente o diagrama no editor expandido.
   
   Observação: observe o campo de porcentagem do nível de zoom na barra de ferramentas Diagrama. Você pode manipular o tamanho, digitando números diferentes neste campo.
3. Selecione o botão Layout simétrico na barra de ferramentas do diagrama e clique em Sim na caixa de diálogo de aviso de layout.
   O IDE organiza o diagrama BankClassDiagram em um estilo de layout simétrico.
4. Selecione o botão Layout hierárquico na barra de ferramentas do diagrama e clique em Sim na caixa de diálogo de aviso de layout.
   O IDE reorganiza o diagrama BankClassDiagram em um estilo de layout hierárquico com todos os elementos abaixo do pacote bankpack .
5. Selecione o botão Layout ortogonal na barra de ferramentas do diagrama e clique em Sim na caixa de diálogo de aviso de Layout.
   O IDE reorganiza o diagrama BankClassDiagram em um estilo de layout retangular.

 Exibir demonstração

início

Usando a janela Visão geral

Aqui, use os recursos da janela Visão geral para obter uma visualização escalonável do diagrama no Editor de diagramas.

1. Clique duas vezes na aba BankClassDiagram na parte superior do Editor de diagramas expandido.
   O IDE retorna para a visualização de várias janelas.
2. Selecione 50% na lista suspensa de zoom e, em seguida, clique no botão Ajustar à janela na barra de ferramentas do diagrama.
   Usando o botão Ajustar à janela, o diagrama é escalonado da versão dimensionada de 75%, para que você possa ler melhor os rótulos.
3. Clique no botão da janela Visão geral na barra de ferramentas do diagrama para abrir a janela Visão geral.
   Uma janela pequena, escalonável, mostrando o diagrama inteiro é exibida. Uma caixa azul na janela indica o que aparece no Editor de diagramas.
   Observação: talvez seja necessário aumentar a janela Visão geral ou selecionar uma escala maior na lista suspensa zoom para ver a caixa azul.
4. Arraste a caixa azul sobre o elemento BankAccount.
   Isso focaliza o elemento BankAccount no centro do Editor de diagramas.
5. Para efetuar mais zoom em um elemento, clique em uma das alças no canto da caixa azul e diminua o tamanho da caixa. Ajuste o local da caixa para efetuar mais zoom em uma parte específica do diagrama.
6. Para efetuar menos zoom, clique em uma das alças da caixa azul e aumente o tamanho da caixa.
   Observe que o IDE diminui o zoom do diagrama.
7. Feche a janela Visão geral, clicando no X no canto direito superior ou clicando no botão da janela Visão geral uma segunda vez.
8. Clique no botão Ajustar à janela novamente na barra de ferramentas do diagrama

 Exibir demonstração

início

Gerando um diagrama de dependência para uma classe

Agora, gere um diagrama de dependência de uma das classes na aplicação BankApp.

1. Clique duas vezes na aba BankClassDiagram para alternar para a visão em tela inteira do diagrama.
2. Clique com o botão direito do mouse na classe BankAccount no Editor de diagramas e escolha Gerar diagrama de dependência no menu pop-up.
   O IDE cria um diagrama de dependência e abre uma aba BankAccountDependencies no Editor de diagramas para exibir o novo diagrama. Seu foco está agora na aba Editor de diagramas, mostrando o diagrama BankAccountDependencies. O diagrama BankAccountDependencies mostra os seguintes links de dependência:
   
   • Relacionamento Implementation com a interface Account
   • Link Aggregation navegável para a classe History
   Observação: usando essa opção, você pode criar um diagrama que mostra todas as dependências de qualquer objeto determinado.
3. Clique duas vezes na aba BankClassDiagram novamente para alternar para a visão de várias janelas do diagrama.
4. Na janela Projetos, expanda o nó da classe BankAccount sob a pasta Projeto UML > Modelo > bankpack.
   Você vê que um nó BankAccountDependencies foi adicionado, representando o diagrama de dependência que você acabou de criar.

 

 Exibir demonstração

início

Gerando um diagrama de seqüência para uma operação

Agora, gere um diagrama de seqüência da operação da aplicação withdraw. Examine como ele é representado como um diagrama e como elementos no Projeto UML na janela Projetos

1. Clique na aba BankAccountDependencies no Editor de diagramas.
2. Selecione o elemento BankAccount e ajuste o zoom para que você possa ler facilmente os rótulos da operação.
3. No Editor de diagramas, clique com o botão direito do mouse na operação withdraw e escolha Operação de engenharia reversa no menu pop-up.
   A caixa de diálogo Criar novo diagrama se abre.
4. Na lista Tipo de diagrama, selecione Diagrama de seqüência.
5. No campo Nome do diagrama, digite withdrawSD.
6. Aceite o valor padrão no campo Namespace e clique em Terminar.
   Um diagrama de seqüência é exibido no Editor de diagramas.
7. Expanda o Editor de diagramas e manipule o nível de zoom para que você possa facilmente examinar o novo diagrama de seqüência.
   O diagrama de seqüência mostra o fluxo de controle, a seqüência de comportamento, além dos processos e ativações simultâneos.
8. Na janela Projetos, sob o nó da classe BankAccount, expanda o nó Operations, em seguida, expanda o nó da operação public void withdraw .
   Veja o novo nó do diagrama de seqüência withdraw .
9. Expanda o nó withdraw para ver os elementos do diagrama de seqüência representados na janela Projetos.

 Exibir demonstração

início

Uma observação sobre marcadores de mesclagem

A UML usa marcadores de mesclagem para ajudá-lo a manter a origem e o modelo sincronizados.  O IDE adiciona marcadores de mesclagem por padrão quando você chama a ação Geração de código em seu projeto UML.  Se o projeto UML tiver sido criado por engenharia reversa de um projeto Java existente, não há marcadores de mesclagem para seus elementos de origem existentes.

Para adicionar marcadores de mesclagem:

1. Crie ou abra seu projeto Java.
2. Clique com o botão direito do mouse no nó do projeto Java e selecione Reverter engenharia. Verifique se Criar novo projeto UML está selecionado.  Clique em OK.
3. Garanta que a engenharia reversa seja concluída.  A janela Saída exibe Tarefa bem-sucedida.
4. Clique com o botão direito do mouse no nó do projeto UML recém-criado -> Gerar código ...
5. Selecione o projeto Java na lista suspensa Projeto de destino. Selecione Adicionar marcadores de mesclagem a elementos de origem existentes. Clique em OK.

A origem e o modelo agora estão sincronizados e todos os elementos de origem terão marcadores de mesclagem.  Você pode ir para frente e para trás com segurança entre a origem e o modelo.  Antes de cada alternância, porém, você deve chamar Reverter engenharia ou Geração de código, conforme apropriado.

início

Resumo

• Neste tutorial, você aprendeu como reverter a engenharia de uma aplicação Java, importando seus dados em um modelo UML. Você aprendeu como realizar as seguintes tarefas:

  • Gerar um diagrama de classe a partir da aplicação Java importada
  • Explorar os recursos da janela Projetos para representar os elementos da aplicação.
  • Usar os botões da barra de ferramentas do diagrama para exibir a aplicação em vários layouts de UML.
  • Usar a janela Visão geral como uma ferramenta de visualização.
  • Gerar um digrama de dependência para uma das classes da aplicação.
  • Gerar um diagrama de seqüência para uma operação e examinar como ela era representada como um diagrama e como elementos no Projeto UML na janela Projetos.

início

Próximas etapas

• Para aprender mais sobre o recurso UML, conclua o tutorial Desenvolvendo aplicações.

• Para enviar comentários e sugestões, obter suporte e manter-se informado sobre as alterações mais recentes nos recursos de desenvolvimento do NetBeans IDE J2EE , junte-se à lista de usuários em .

início

>> Mais documentação da Modelagem UML