This week's book giveaway is in the Servlets forum.
We're giving away four copies of Murach's Java Servlets and JSP and have Joel Murach on-line!
See this thread for details.
The moose likes Architect Certification (SCEA/OCMJEA) and the fly likes Sequence diagrams: methods calls vs. plain english Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login


Win a copy of Murach's Java Servlets and JSP this week in the Servlets forum!
JavaRanch » Java Forums » Certification » Architect Certification (SCEA/OCMJEA)
Bookmark "Sequence diagrams: methods calls vs. plain english" Watch "Sequence diagrams: methods calls vs. plain english" New topic
Author

Sequence diagrams: methods calls vs. plain english

Lars Behnke
Ranch Hand

Joined: May 09, 2006
Posts: 76
Hi all,

I have just finished my sequence diagrams and feel that thinks got too complicated.

In the course of simplifying the diagrams I decided to use plain old english phrases (instead of method calls) in order to document messages.

However, I have some doubts, whether this is still compliant with UML 2.0. All documentation I found uses method calls.

What's your decision/opinion on this topic? Comments are highly welcome.
Sreenivasa Majji
Ranch Hand

Joined: Jul 12, 2001
Posts: 224
I think you need to use methods, however you can use 'note' to describe the methods.


Sreenivasa Majji
Lars Behnke
Ranch Hand

Joined: May 09, 2006
Posts: 76
Hi Sreenivasa,

After looking up the UML 2.0 spec I tend to agree with you.
The spec states:


A Message is a NamedElement that defines one specific kind of communication in an Interaction. A communication can
be, for example, raising a signal, invoking an Operation, creating or destroying an Instance.
[...]
A Message reflects either an Operation call and start of execution - or a sending and reception of a Signal.

[Unified Modeling Language: Superstructure, version 2.0, formal/05-07-04]

Furthermore the notation of signals and operation calls are specified in great detail. IMO there is no room for a plain english approach.
 
I agree. Here's the link: http://aspose.com/file-tools
 
subject: Sequence diagrams: methods calls vs. plain english
 
Similar Threads
Details in the sequence diagrams...
how detailed should the sequence diagrams be?
Sequence diagram.
SCEA Part II&III 100%
POJO's / Value objects in the Sequence Diagrams