[Jsdoc-user] Re: [Mapbuilder-devel] status of XMI/UML export?

[Cameron S. <sho...@op...>]

Kralidis,Tom [Burlington] wrote:

>>Gabriel,
>>I'm very excited.  This is great.
>>I've just reverse engineered our JS code and I seem to be
>>able to view 
>>all our class diagrams, including classes, class 
>>dependancies, functions 
>>and internal variables.
>>
>>This is the main requirement I was looking for.
>>What else are you considering incorporating?
>>
>>Mapbuilder people (and Gabriel),
>>It would be great if someone knew of a tool which can automatically
>>build class diagrams and place the classes on a page for you.
>>
>>Do any of the commercial UML tools do this?
>>
>>    
>>
>
>I just tried this in Enterprise Architect and it imports the XMI
>generated by jsdoc.  NICE!!!!!
>
>As Gabriel mentions, it only outputs the class hierarchies.  i.e. I
>would need to write my own component diagram which USES the output
>classes.  A nice thing would be to have something to generate a
>component diagram which lays out the classes, etc. into a view.  Mind
>you, I'm not sure if that's a job for jsdoc or a given software project
>like mapbuilder to build our own layouts.
>
>..Tom
>  
>
Yes, I think there are 2 possible solutions here:
1. jsdoc (or some other UML tool) creates a class diagram and 
automatically places the classes into the diagram.  I think this is 
probably a role for a UML tool as I'm sure this problem would have 
already been solved.  I know that Poseidon imports java code and builds 
a class diagram layout based on the import.

2. Maintain existing class diagrams.  Ie, If I create a class diagram, 
then update the code, I'd like to run a program which incorporates the 
updates to the code into my class diagram(s).
I think this wouldn't be too difficult using XSL.
It goes something like this:

a. Use jsdoc to create uml1.xmi
b. In a UML tool (eg Poseidon), build class diagrams based on uml1.xmi.  
Save as uml2.xmi.
c. Update code.
d. Use jsdoc to create uml3.xmi
e. Use XSL to replace the classes within uml2.xmi with the equivalent 
classes in uml3.xmi, but keep the layout information of the class diagrams.