Re: [Springframework-developer] beandoc tool

[Daniel P. <po...@ci...>]

Will it handle autowired bean factories?  I really like the approach
you've taken with this (sort of a combination of SpringViz and
JavaDoc).  A few weeks ago, someone suggested the idea of actually
loading the application context or bean factory and generating the graph
and documentation from that.  It seems like this would be the only way
to support autowired configurations, but obviously poses problems b/c
you don't want to actually instantiate/lookup all the beans.  I played
with this a bit and wrote a custom BeanFactory or ApplicationContext
(can't remember which) that simply skipped bean creation.  I thought I'd
just be able to then query for all the bean definitions and use them to
generate the documentation, including dependency links.   Unfortunately, 
it turns out that autowired dependencies aren't stored in the collection
of bean definitions (the definitions just reflect what was in the
configuration files).  I stopped there and decided to wait for someone
else to figure it out. ;)  Perhaps all that is needed is a custom
BeanFactory that maintains these details and updates its bean
definitions to reflect autowired dependencies as it's loaded?

Thoughts? 

Daniel

On Thu, Nov 04, 2004 at 02:42:57PM -0500, Colin Sampaleanu wrote:
> That is way cool!
> 
> Darren Davison wrote:
> 
> >I've done a bit of work on a tool to document and graph context files.  It 
> >still needs some work in a few areas but it's starting to show promise I 
> >think.
> >
> >Although highly configurable in terms of output, the defaults are pretty 
> >sane and were used to generate docs from JPetStore's config.  They can be 
> >seen at http://www.davison.uk.net/beandoc/ for a short while.  All of the 
> >HTML and graphs were generated by simply calling the main class and 
> >supplying the input files and an output location as command line args.
> >
> >The only changes made to the input files was to move some of the XML 
> >comments into <description> tags.  Output of <list> <map> <set> and one or 
> >two other tags is currently either broken or not started, but there's 
> >enough there to get the idea.
> >
> >Stuff still to do: finish XSLT templates, add an ANT task, write docs, 
> >etc. etc.
> >
> >Is there any interest from others in using this and seeing it added as a 
> >subproject (like RCP or Spring-IDE)?
> >
> > 
> >
> 
> 
> 
> -------------------------------------------------------
> This SF.Net email is sponsored by:
> Sybase ASE Linux Express Edition - download now for FREE
> LinuxWorld Reader's Choice Award Winner for best database on Linux.
> http://ads.osdn.com/?ad_id=5588&alloc_id=12065&op=click
> _______________________________________________
> Springframework-developer mailing list
> Spr...@li...
> https://lists.sourceforge.net/lists/listinfo/springframework-developer