This week's giveaway is in the Spring forum.
We're giving away four copies of Microservices Testing (Live Project) and have Chris Love & Andres Sacco on-line!
See this thread for details.
Win a copy of Microservices Testing (Live Project) this week in the Spring forum!
  • Post Reply Bookmark Topic Watch Topic
  • New Topic
programming forums Java Mobile Certification Databases Caching Books Engineering Micro Controllers OS Languages Paradigms IDEs Build Tools Frameworks Application Servers Open Source This Site Careers Other Pie Elite all forums
this forum made possible by our volunteer staff, including ...
Marshals:
  • Campbell Ritchie
  • Tim Cooke
  • Ron McLeod
  • Jeanne Boyarsky
  • Paul Clapham
Sheriffs:
  • Liutauras Vilda
  • Henry Wong
  • Devaka Cooray
Saloon Keepers:
  • Tim Moores
  • Stephan van Hulst
  • Tim Holloway
  • Al Hobbs
  • Carey Brown
Bartenders:
  • Piet Souris
  • Mikalai Zaikin
  • Himai Minh

How big are collaboration diagrams supposed to be?

 
Greenhorn
Posts: 8
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Hi All..

I wonder how much details are supposed to be in the Part II sequence
diagrams? My unfinished sequence diagram for the "prepare for itinerary" use
case already spans 7x3 A4 pages and is beginning to be hard to navigate in.
I've included most of the significant participants in the diagram, all of
the Transfer Objects, Data Access Objects, EJBs, Bean Delegates, Service
Locators, JSPs and then some. Am I being too detailed in the diagram or are
they supposed to be large?

TIA.
 
Greenhorn
Posts: 22
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
A readable sequence diagram must not have more than 15-20 objects...Use components or stereotyped subsystems instead of simple objects:
sample: "<<UI>>", you can list your jsps or other objects in the text.
Mouloud
 
Ranch Hand
Posts: 46
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Hello all,

Are you including only the happy path (Basic Flow), or are you including the Basic Flow and all Alternatre Flows?

Thanks in advance.

-Ravi
 
Sasmito Adibowo
Greenhorn
Posts: 8
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
The "change itinerary" sequence diagram has only 17 objects (lifelines, including the Client actor), but it is already very big in my opinion. But it spans 5x2 A4 portrait pages (using 8-10pt Arial fonts) already. I've included the JSPs as object, the front controller, as well as the transfer objects involved.

The "prepare itinerary" sequence diagram is even worse.

Since the example in Mark Cade's book also include the JSPs and their controller, I opt to do the same in the assignment. But then this raise the question, should I also draw the same diagram for the GUI clients? The interaction from the point of the UI's controller backwards will be mostly the same, being different only in the request/response paradigm of HTTP to the more interactive GUI-based systems.

My question is this now:
- Should I draw two sequence diagrams for every use case, for each type of client? Are GUI vs JSP clients that different?
- Would it be appropriate to leave out the transfer objects in the sequence diagrams?
- Should I leave out the Home interface of EJBs in the process of creating a bean instance in the sequence diagrams?
 
Ranch Hand
Posts: 52
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
If your GUI and JSP has the same operations, then you will only need to draw one sequence diagram.

I dont think it is appropriate to leave out the Transfer Object if it is somehow involve in the operation.

IMHO, stuff like Home Interface can be left out as it a known fact of how it will work and there is no variation to it.

HTH
 
Greenhorn
Posts: 5
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
I had prepared two sets of sequence diagrams. One showing the interaction in the web components i.e. JSP==>Action Objects==>Business Delegates. And the other showing BD ==> Business Objects ==> DAO...

This way I was able to show more details and improve clarity but then the number of sequence diagrams increased...
 
With a little knowledge, a cast iron skillet is non-stick and lasts a lifetime.
reply
    Bookmark Topic Watch Topic
  • New Topic