There's some tool out there, forget the name JVision or something like that that allows you to specify java classes and it will suck up classes and create diagrams.
UML is nice, but not necessary. Bill > -----Original Message----- > From: [EMAIL PROTECTED] > [mailto:[EMAIL PROTECTED]]On Behalf Of David > Jencks > Sent: Saturday, December 14, 2002 6:29 PM > To: [EMAIL PROTECTED] > Subject: Re: [JBoss-dev] JBoss and UML? > > > On 2002.12.14 16:47:48 -0500 wonder sonic wrote: > > --- David Jencks <[EMAIL PROTECTED]> a > > écrit : > On 2002.12.14 14:01:45 -0500 wonder sonic > > wrote: > > > > Well, it's a sort of answer I really appreciate > > > > (seriously). However, I think it should be > > > detailed. > > > > > > > > -1- Where should those diagrams reside? in the > > > same > > > > directories of the java files or in an other > > > directory > > > > named diagrams (for example). > > > > > > > > -2- AFAIK, only the ones who have designed the > > > > different modules might create the best UML > > > diagrams > > > > (activity, usecase...). I haven't the impertinence > > > to > > > > say that I could do that! :) > > > > > > > > -3- A synchronization problem could occur for the > > > > developers who don't have such tools: modification > > > of > > > > the source code whitout modification of the > > > diagrams. > > > > > > I think this is a really serious problem. > > > I also think most developers don't think uml > > > diagrams work very well for the kind of > > > "meta-programming" done in a lot of the server > > > core. > > > > Could you please explain what you mean by > > "meta-programming"? > > Basically interceptor based, reflective, or aspect oriented programming > techniques. > > Do you think a uml diagram of say a transaction interceptor or a lock > interceptor provides a useful explanation of what it does? I haven't seen > any evidence that it does, but am very open to demonstrations. > > > > > I haven't tried, but would be happy if > > > this was demonstrated to be wrong. > > > > In most cases, UML diagrams could help to communicate > > new developments design, explain *quickly* the > > dependencies between packages, classes and interfaces, > > show the logic of an algorithm... Moreover, the fact > > that UML is a graphical language reduces the > > explanation of a complex algorithm for example: > > - > > > http://www.visualuml.com/Sample%20Diagrams/Fig%209-1%20Activity%20 > Diagram.jpg > > - > > > http://msdn.microsoft.com/library/en-us/f_and_m/html/vxfm7_topleve > ldiagram.gif > > - > > > http://www.smartdraw.com/resources/centers/flowcharts/images/flowc > hart_deployment_example.gif > > Personally I have found uml diagrams sometimes useful in organizing my own > thinking but have never been able to communicate any useful ideas using > them. > > > > > > > > > > -4- Perhaps some Together project files could be > > > > added? > > > > > > Who is going to keep them in sync? Out of date is > > > worse than not there. > > > > Indeed! In fact, we can consider UML diagrams as a > > complement to javadoc. When a development is done, > > javadoc should be synchronized with it, UML diagrams > > should be synchronized the same way. > > "Should" covers a lot of territory here. Our javadocs are mostly missing > and wrong. I think developers will have to find any such diagram > very easy > to create and very helpful in their own development process > before you will > find anyone making or updating them. I suspect this would only > take off if > the diagrams were the basis of some kind of code generation, such as done > with uml2ejb. > > > The main problem is how can developers update UML > > diagrams? An open source tool would be welcome. > > Thus my suggestion of argo (free, open source)/poseidon > (commercial version > of the same tool, with free community edition). > > > > > > > > > > -5- I can personnaly create class diagrams for the > > > > JBoss modules. What format shall I use? wmf, gif, > > > > Together (v6)? > > > > > > I suggest xmi using argo/poseidon. > > > > Yes, xmi is a standard for UML diagrams. But they only > > are useful to those who can use them with the right > > tool. I think an image format could be used too for > > those who don't have such tool. > > again, argo is completely free and poseidon has a free version. They are > both pretty lightweight. > > I'll be interested to see what you come up with. > > thanks > david jencks > > > > WS > > > > > > > > david jencks > > > > > > > > WS > > > > > > > > --- Bill Burke <[EMAIL PROTECTED]> a écrit : > You > > > want > > > > it. Do it. > > > > > > > > > > > > > > > XXXXXXXXXXXXXXXX > > > > > Bill Burke > > > > > Chief Architect > > > > > JBoss Group, LLC > > > > > XXXXXXXXXXXXXXXX > > > > > > > > > > > > > > > > -----Original Message----- > > > > > > From: > > > > > [EMAIL PROTECTED] > > > > > > > > > > > > > > > > > > > > [mailto:[EMAIL PROTECTED]]On > > > > > Behalf Of > > > > > > wonder sonic > > > > > > Sent: Saturday, December 14, 2002 12:24 PM > > > > > > To: [EMAIL PROTECTED] > > > > > > Subject: [JBoss-dev] JBoss and UML? > > > > > > > > > > > > > > > > > > Hello, > > > > > > Looking the source code of the 4.0.0alpha > > > version, > > > > > > I noticed the presence of Together diagrams in > > > the > > > > > > jboss.net/testsuite directory. Wouldn't it be > > > > > useful > > > > > > to add such development documentation (UML > > > > > diagrams, > > > > > > not only classes diagrams) to other modules? > > > > > > > > > > > > I think it could help new developers who wish > > > to > > > > > > contribute. > > > > > > > > > > > > Best regards, > > > > > > WS > > > > > > > > > > > > > > > > > > > > > > > > > > ___________________________________________________________ > > > > > > Do You Yahoo!? -- Une adresse @yahoo.fr > > > gratuite > > > > > et en français ! > > > > > > Yahoo! Mail : http://fr.mail.yahoo.com > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > ------------------------------------------------------- > > > > > > This sf.net email is sponsored by: > > > > > > With Great Power, Comes Great Responsibility > > > > > > Learn to use your power at OSDN's High > > > Performance > > > > > Computing Channel > > > > > > http://hpc.devchannel.org/ > > > > > > > > > _______________________________________________ > > > > > > Jboss-development mailing list > > > > > > [EMAIL PROTECTED] > > > > > > > > > > > > > > > > > > > > https://lists.sourceforge.net/lists/listinfo/jboss-development > > > > > > > > > > > > > > > > > > > > > > > > > > > > > ------------------------------------------------------- > > > > > This sf.net email is sponsored by: > > > > > With Great Power, Comes Great Responsibility > > > > > Learn to use your power at OSDN's High > > > Performance > > > > > Computing Channel > > > > > http://hpc.devchannel.org/ > > > > > _______________________________________________ > > > > > Jboss-development mailing list > > > > > [EMAIL PROTECTED] > > > > > > > > > > > > > > https://lists.sourceforge.net/lists/listinfo/jboss-development > > > > > > > > > > > > > > > > ___________________________________________________________ > > > > Do You Yahoo!? -- Une adresse @yahoo.fr gratuite > > > et en français ! > > > > Yahoo! Mail : http://fr.mail.yahoo.com > > > > > > > > > > > > > > > > > ------------------------------------------------------- > > > > This sf.net email is sponsored by: > > > > With Great Power, Comes Great Responsibility > > > > Learn to use your power at OSDN's High Performance > > > Computing Channel > > > > http://hpc.devchannel.org/ > > > > _______________________________________________ > > > > Jboss-development mailing list > > > > [EMAIL PROTECTED] > > > > > > > > > https://lists.sourceforge.net/lists/listinfo/jboss-development > > > > > > > > > > > > > > > > > > > ------------------------------------------------------- > > > This sf.net email is sponsored by: > > > With Great Power, Comes Great Responsibility > > > Learn to use your power at OSDN's High Performance > > > Computing Channel > > > http://hpc.devchannel.org/ > > > _______________________________________________ > > > Jboss-development mailing list > > > [EMAIL PROTECTED] > > > > > https://lists.sourceforge.net/lists/listinfo/jboss-development > > > > ___________________________________________________________ > > Do You Yahoo!? -- Une adresse @yahoo.fr gratuite et en français ! > > Yahoo! Mail : http://fr.mail.yahoo.com > > > > > > ------------------------------------------------------- > > This sf.net email is sponsored by: > > With Great Power, Comes Great Responsibility > > Learn to use your power at OSDN's High Performance Computing Channel > > http://hpc.devchannel.org/ > > _______________________________________________ > > Jboss-development mailing list > > [EMAIL PROTECTED] > > https://lists.sourceforge.net/lists/listinfo/jboss-development > > > > > > > ------------------------------------------------------- > This sf.net email is sponsored by: > With Great Power, Comes Great Responsibility > Learn to use your power at OSDN's High Performance Computing Channel > http://hpc.devchannel.org/ > _______________________________________________ > Jboss-development mailing list > [EMAIL PROTECTED] > https://lists.sourceforge.net/lists/listinfo/jboss-development ------------------------------------------------------- This sf.net email is sponsored by: With Great Power, Comes Great Responsibility Learn to use your power at OSDN's High Performance Computing Channel http://hpc.devchannel.org/ _______________________________________________ Jboss-development mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/jboss-development
