Re: [Springframework-developer] Creating documentation from Spring beans definition files (e.g. like HiveMind's HiveDoc)

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

Here is the stylesheet and an Ant snippet that shows how to generate a graph (as
postscript and gif) as part of a build.  The XSL is not pretty and would need
some work for it to handle all possible configuration options allowed by the
Spring DTD.  It should work as-is for most Spring config files, but it doesn't
handle nested maps and lists, and doesn't even recognize sets (altho that would
be trivial to add).  It could be a good starting point for something more
thorough however.

Also, this XSL includes all property values in the graph (not just bean
dependencies).  This can clutter the graph up pretty quickly for
moderate-to-complex configurations.  It would probably be more useful to only
include bean dependencies in the graph, not all configuration properties
(basically, <value/> properties).

If anyone makes improvements to the XSL, please post them back to this (or the
user) list so everyone can benefit.

Enjoy.

Daniel

Quoting Torsten Juergeleit <tju...@ya...>:
> Daniel,
> 
> sounds good. Is it possible to share this stylesheet?
> 
> Thanx.
> Torsten
> 
> --- Daniel Potter <po...@ci...> wrote:
> > I know it's not quite what you had in mind with this
> > question, but we've
> > used Graphviz
> > (www.research.att.com/sw/tools/graphviz/) to
> > generate dependency graphs based on Spring
> > configuration files.  The
> > basic process involves using an XSL stylesheet to
> > transform the Spring
> > XML config files into the .dot syntax used by
> > Graphviz, then running
> > Graphviz on the .dot files to generate png, gif,
> > postscript, etc.
> > dependency graphs.  Of course, this wouldn't work
> > for autowired
> > configurations, but it generates interesting and
> > useful graphs for
> > explicit configurations.
> > 
> > Daniel
> > 
> > On Tue, Apr 06, 2004 at 01:02:39AM -0700, Torsten
> > Juergeleit wrote:
> > > Is anyone already working on a way to create
> > > documentation from Spring beans definition files?
> > > 
> > > Howard's HiveMind / HiveDoc
> > > (http://jakarta.apache.org/hivemind/hivedoc.html)
> > uses
> > > XSL stylesheets to transform the HiveMind config
> > files
> > > into a set of HTML files. Sample output:
> > >
> >
> http://jakarta.apache.org/hivemind/hivedocs/index.html
> > > 
> > > Does it make sense to create something similar for
> > > Spring?
> > > 
> > > Torsten
> > > 
> > > __________________________________
> > > Do you Yahoo!?
> > > Yahoo! Small Business $15K Web Design Giveaway 
> > > http://promotions.yahoo.com/design_giveaway/
> > > 
> > > 
> > >
> >
> -------------------------------------------------------
> > > This SF.Net email is sponsored by: IBM Linux
> > Tutorials
> > > Free Linux tutorial presented by Daniel Robbins,
> > President and CEO of
> > > GenToo technologies. Learn everything from
> > fundamentals to system
> > >
> >
> administration.http://ads.osdn.com/?ad_id=1470&alloc_id=3638&op=click
> > > _______________________________________________
> > > Springframework-developer mailing list
> > > Spr...@li...
> > >
> >
> https://lists.sourceforge.net/lists/listinfo/springframework-developer
> > 
> > 
> >
> -------------------------------------------------------
> > This SF.Net email is sponsored by: IBM Linux
> > Tutorials
> > Free Linux tutorial presented by Daniel Robbins,
> > President and CEO of
> > GenToo technologies. Learn everything from
> > fundamentals to system
> >
> administration.http://ads.osdn.com/?ad_id=1470&alloc_id=3638&op=click
> > _______________________________________________
> > Springframework-developer mailing list
> > Spr...@li...
> >
> https://lists.sourceforge.net/lists/listinfo/springframework-developer
> 
> 
> __________________________________
> Do you Yahoo!?
> Yahoo! Small Business $15K Web Design Giveaway 
> http://promotions.yahoo.com/design_giveaway/
> 
> 
> -------------------------------------------------------
> This SF.Net email is sponsored by: IBM Linux Tutorials
> Free Linux tutorial presented by Daniel Robbins, President and CEO of
> GenToo technologies. Learn everything from fundamentals to system
> administration.http://ads.osdn.com/?ad_id=1470&alloc_id=3638&op=click
> _______________________________________________
> Springframework-developer mailing list
> Spr...@li...
> https://lists.sourceforge.net/lists/listinfo/springframework-developer
> 




-------------------------------------------------
This mail sent through IMP: http://horde.org/imp/