Parte 5 – Análise de uma aplicação legada com o Altova UModel
Em partes anteriores desta série, nas Partes 1, Partes 2, Partes 3 e Partes 4, utilizamos a funcionalidade de engenharia reversa do Altova UModel para criar diagramas UML para uma aplicação de simulação de um sistema bancário de caixas automáticas. Após analisar a arquitetura existente, planearam e implementaram uma nova funcionalidade: a taxa de levantamento. Mesmo com um tamanho reduzido, o nosso diagrama de sequência atualizado para a transação de levantamento representa graficamente a estrutura lógica interna do código fonte.
Esta manhã, encontramos o gestor de produtos dos caixas automáticos junto à máquina de café. "Já está a trabalhar nesse código dos caixas automáticos há mais de um mês", disse ele. "Quando é que vou poder ver o que conseguiu?" Podemos aproveitar o UModel Gerar documentação Esta funcionalidade permite satisfazer essa necessidade. O UModel irá criar automaticamente documentação personalizada para o nosso projeto, em formatos HTML, Microsoft Word ou RTF. A aba "Incluir" na caixa de diálogo "Gerar Documentação" permite-nos escolher quais tipos de diagramas incluir, e especificar o nível de detalhe do nosso relatório, permitindo-nos expandir cada tipo de elemento do diagrama.
Para um relatório geral, podemos selecionar todos os tipos de diagramas. Também selecionaremos a opção "classe" na lista de elementos para mostrar informações adicionais sobre as classes na nossa aplicação. O UModel pergunta de forma útil se queremos adicionar também elementos derivados da classe.
Depois de selecionarmos ou ajustarmos outros parâmetros do documento, incluindo fontes e tamanhos, o UModel gera o relatório em apenas alguns segundos. No topo da primeira página, o relatório começa com um índice de diagramas e um índice separado de elementos. Cada item indexado está ligado a um marcador no documento através de um hiperligação.
Independentemente do formato que escolher, o relatório resultante é totalmente editável. Por exemplo, podemos adicionar um rodapé que inclua números de página e uma linha de texto indicando a data de criação do documento. Podemos utilizar a linha de texto que o UModel criou para criar o nosso rodapé.
O nosso relatório final contém todos os diagramas UML que descrevem a aplicação ATM existente, com diagramas de classes detalhados que mostram as propriedades e operações das classes. Além disso, a representação de cada classe é acompanhada por um diagrama de hierarquia para mostrar as relações entre as classes, e uma lista de todas as associações entre as classes. Mais tarde, à medida que o nosso projeto evolui, podemos gerar facilmente uma versão atualizada do relatório. Poderíamos até aproveitar a funcionalidade da linha de comandos do UModel ou a API do UModel para automatizar a criação da documentação do projeto, ou poderíamos anexar a versão .html do relatório à wiki da nossa equipa de desenvolvimento. Mas, por agora, tudo o que temos de fazer é enviar o relatório por e-mail ao gestor de produto da aplicação ATM.
Conclusão
Esperamos que tenham apreciado acompanhar este exercício de análise de uma aplicação legada com o Altova UModel. Embora estejamos a concluir a série aqui, no mundo real, ainda há muito trabalho a fazer na nossa aplicação de caixas automáticas. Por exemplo, a funcionalidade que permite aos utilizadores aceitar a taxa ou cancelar um levantamento ainda precisa de ser implementada. Ou, poderíamos atualizar o código legado com construções mais recentes da linguagem Java, como genéricos, anotações e enumerações.
Se já tem experiência com UML, esperamos ter-lhe mostrado algumas novidades. Se é um desenvolvedor que nunca experimentou o UML, queríamos dar-lhe uma ideia dos benefícios e vantagens da modelação visual de software. De qualquer forma, se estiver pronto para avançar no seu próprio projeto, clique aqui para descarregar uma versão de avaliação gratuita e totalmente funcional do Altova UModel.