Os diagramas de seqüência devem ser específicos ou abstratos?

5

Estou criando um diagrama de seqüência para um programa simples em que estou trabalhando. O diagrama no qual estou trabalhando atualmente é de nível muito alto - ele define a interface com muitos caminhos de alt, mas não exemplifica casos de uso específicos. Eu queria saber se seria mais apropriado fazer vários diagramas que demonstram exemplos específicos.

Não estou familiarizado com a maneira como esses diagramas devem ser usados e vi exemplos específicos e exemplos abstratos.

Obrigado!

    
por JSideris 14.02.2012 / 01:30
fonte

2 respostas

3

Os diagramas devem ajudar a entender as coisas .
Se não, eles falham.

Os diagramas de sequência são muito bons para explicar os protocolos em rede e interações simples em uma API. Em qualquer API não trivial, você terá dificuldade em descrever todas as interações . (ou seja, você não pode )

Você obviamente tem que fazer múltiplos diagramas , um para cada cenário de interação , fazendo com que um único diagrama com todas as interações sobrepostas fique doente e faça os olhos das pessoas se cruzarem .

Você ainda terá que escrever sua documentação em linguagem natural , de qualquer forma. Os diagramas só podem ajudar a alcançar um entendimento mais amplo ou mais preciso no topo de uma documentação já bem escrita.

E se a API implica o uso de objetos diferentes, de classes diferentes, por usuários diferentes, um diagrama de classes , pode e será útil.

    
por 14.02.2012 / 01:44
fonte
2

Depende inteiramente do que você deseja comunicar. Na minha experiência, os diagramas de sequência funcionam muito bem para sistemas de nível muito alto e muito baixo.

Por exemplo, usamos um diagrama de seqüência mostrando o fluxo no nível do evento de um handshake SSL para ajudar a explicar alguns problemas relacionados à segurança para os usuários. Nível muito baixo e muito concreto.

Também usamos um diagrama de seqüência que mostra a troca de mensagens de alto nível em nosso sistema distribuído entre os quatro ou cinco atores no lugar. Isso faz com que cada ator tenha algo como 50.000 linhas de código em tamanho - e eventos que recebem várias comunicações são um "evento" nessa escala.

    
por 14.02.2012 / 01:33
fonte