Manter diagramas UML como documentação sempre foi um serviço braçal, pouco produtivo e dependendo do que for documentado, acaba não se tornando uma documentação útil.
Pensando neste problema foi desenvolvido o Jsigner, ferramenta que possibilita engenharia reversa através do maven, de uma maneira diferente das conhecidas. O Jsigner se propõe a gerar diagramas que realmente agreguem valor para comunicação e documentação.
O conceito utilizado foi o mesmo do javadoc. Marcações no código fonte são utilizados para gerar os diagramas de classes, de maneira bem simples…
Basta anotar as classes que você deseja que sejam documentadas com diagramas utilizando a anotação @Domain e passando como parametro os domínios ao qual a classe pertence.
Para cada dominio será gerado um diagrama separado, para não causar sobrecarga cognitiva aos leitores dos diagramas, podendo assim gerar diagramas claros e objetivos!
A configuração desta ferramenta possibilita:
Divisão do negócio em multiplos diagramas.
Decida qual classe irá ser exibida em quais diagramas.
Configure a omissão de metodos e atributos indesejados (getters, setters, equals, serialVersion etc…).
Geração dos diagramas através do maven.
Para mais detalhes sobre a configuração visite o site do projeto:http://code.google.com/p/jsigner/
Dúvidas, comentários e sugestões, são bem vindos.
[]s a todos,
Ferry