Menu
▾
▴
springframework-developer
|
From: Torsten J. <tju...@ya...> - 2004-04-06 08:02:46
|
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/ |
|
From: Daniel P. <po...@ci...> - 2004-04-06 15:06:16
|
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 |
|
From: Torsten J. <tju...@ya...> - 2004-04-06 17:43:28
|
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/ |
|
From: Daniel P. <po...@ci...> - 2004-04-06 23:13:47
Attachments:
ant_snippet.txt
springToDot.xsl.txt
|
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/ |
|
From: Don B. <mr...@tw...> - 2004-04-07 01:49:42
Attachments:
spring.xsl
|
I merged my version I created this morning with yours - attached is the result. Differences: * Use of the Mrecord shape to embed properties inside of bean objects * Seperate structure for lists and maps * No duplication of beans, ie refs don't get their own structure * Referenced beans connect at the property they are referenced For fun, I applied it to a moderately complex Spring config file for a pet project of mine: http://www.twdata.org/dakine/beans.png Don Daniel Potter wrote: >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 > > |
