Soyatec eUML Design Tool

Once upon a time I used to be a fan of the TogetherJ UML design tool (in fact, I even co-authored a book on it that sold, oh, 12 copies), and even though it isn’t fashionable these days I still think there’s a lot of value in UML as a way of expressing designs.

Anyway, for some of the documentation of Apache Isis I was looking around equivalent UML tools that offer similar capabilities to TogetherJ, preferably open source/free.  The one that seems to be closest is Soyatec, which offers both a free and a paid-for edition as plugins to Eclipse 3.7 and earlier.

What I like about this tool is that – like TogetherJ – it seems to generate the class diagrams from the Java source code, offering live updates, and uses Javadoc attributes as hints for the rendering.  However, it didn’t take long to run into problems.

First off, the tool was unbearably slow when trying to work in my usual Eclipse workspace that has all the Apache Isis modules.  It would seem that the tool isn’t too smart about figuring out which Java source code classes it needs to analyse for rendering, and which it can ignore.  Switching to a new workspace that just had the modules representing my domain object application seemed addressed that issue.

Next up… when I created a new class diagram and added some existing classes (from the examples/claims app which has Claimant, Claim, ClaimItem classes), the tool was clever enough to render a 1:1 association from Claim to Claimant, but couldn’t figure out that a property of type List<ClaimItem> in the Claim class implied a 1:n association from Claim to ClaimItem.

I knew the tool could do this, though, and recalled that TogetherJ needed additional Javadoc attributes to render this correctly.  Scouring the Soyatec documentation didn’t help, though … it didn’t seem to have any glossary of the different Javadoc attributes that were supported.  In the end I had to resort to manually adding dummy associations between the classes through the editor, in order to figure out which additional Javadoc annotations were needed.

Even then, though, I was unable to get the tool to render the association correctly; so I decided to delete the reference to Claim from the diagram and add it back in.  At this point the tool seemed to give up the ghost, and I couldn’t persuade it to add the reference to Claim back into the diagram.

Conclusion: #soyatec #fail.  It’s been deinstalled.

PS: I decided to wander over to Borland and download the latest TogetherJ product, to see if its still usable or not.  Clicking on the “download trial” link took me to a form which I duly filled in, at which point I was notified that a sales representative would contact me shortly! In what way is that a download, may I ask?  Not impressed.

About these ads

Posted on August 11, 2011, in Uncategorized and tagged , . Bookmark the permalink. 5 Comments.

  1. ROTFL. I clicked on that Borland link. Oh, about 8 months ago. Still waiting for the call from Sales.

    The #fail is worse than you think!

    • I guess I must be privileged – I got a call later today with a download link. Mind you, when I asked about the price, it was the equivalent of 23,381.29 South African Rand. #fail all round!

  2. Vernon Stinebaker

    I was a great Together J fan. I’m even one of the 12 who bought your book. I really miss what Together J offered and agree #fail once it was acquired by Borland.

  3. I personally like Visual Paradigm. It integrates with various IDEs and also has a standalone version.

  4. Hey, I just quoted BSF to someone today!

    We still use Together from when you left us, and it serves well, and has been bolstered by the Req. Mng. tool plug-in.

    I do have to say that it’s kinda stood still in some respects, and I don’t really have the time for DSL’s.

    I use VP at home- I like the collaborative and productivity features in one tool that Together doesn’t have

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

Follow

Get every new post delivered to your Inbox.

Join 268 other followers