BeanDoc 0.6 available.

[davison]

The 0.6.1 release of BeanDoc is now available

BeanDoc is the tool that facilitates documentation and graphing of Spring bean factories and application context files. While very easy to use, it is designed to be flexible and extensible to meet most needs.

I'm very keen for as much feedback as possible on features and bugs. Please give it a shot and submit comments via the forums or the Confluence pages.

http://opensource.atlassian.com/conf...play/BDOC/Home

Thanks all!

[Alef Arendsen]

Great, I'll have a look at it soon!

p.s. I've changed it into an announcement for you. Don't know why you can't do this??

[davison]

Thanks Alef. I don't know either, perhaps Colin can shed some light..?

[smccrory]

BTW I wanted to take a moment so say that BeanDoc is outstanding. Having a graphical representation of bean dependancies will make a splash with our management, auditors, architecture review board and junior teammates trying to come up to speed. Excellent work - thanks!

Scott

[davison]

Thanks for your comments Scott - glad it's of use to you

I think much of the credit needs to go to the ATT developers who wrote GraphViz though - great stuff.

[mestachs]

i don't know if it's the good post but i think it's interessting for the beandoc users

i've modified the org.springframework.beandoc.DefaultContextProcesso r to handle the includes in the files

<beans>
  <import resource="classpath&#58;/ent-context.xml"/>
<beans>

in the method buildDomsFromInputFiles() i have added a called to handleIncludes

	/**
	 * generate in memory DOM representations from the input files on disk
	 * 
	 * @return a Document[]
	 * @throws IOException
	 */
	private Document[] buildDomsFromInputFiles() throws IOException {
		logger.debug("Starting building DOM trees from input files");
	 ....

			// set an attribute on the root element to mark the original input
			// file
			Element root = contextDocuments[i].getRootElement();
			root.setAttribute(Tags.ATTRIBUTE_BD_FILENAME,
					normalisedFileNames[i]);
			logger.debug("Attribute [" + Tags.ATTRIBUTE_BD_FILENAME
					+ "] set to [" + normalisedFileNames[i] + "]");

			handleIncludes(contextDocuments, builder, i);
        ...

and here's the code of the handleIncludes method

private void handleIncludes(Document[] contextDocuments, SAXBuilder builder, int i) throws IOException {
		List imports = contextDocuments[i].getRootElement().getChildren(
				"import");

		List importedbeans = new ArrayList();

		for (Iterator iter = imports.iterator(); iter.hasNext();) {
			Element includedImport = (Element) iter.next();
			String importfile = includedImport
					.getAttributeValue("resource");
			ResourceLoader loader = new DefaultResourceLoader();
			Resource res = loader.getResource(importfile);
				try {
				Document importDocument = builder.build(res
						.getInputStream());
				List beans = importDocument.getRootElement().getChildren(
						"bean");
				for (Iterator iterator = beans.iterator(); iterator
						.hasNext();) {
					Element bean = (Element) iterator.next();
					importedbeans.add(bean);
				}

			} catch (JDOMException e) {
				throw new BeanDocException(
						"Unable to parse or validate input resource ["
								+ res + "]", e);
			}

		}
                // move the bean nodes to the current contextDocuments
		for (Iterator iter = importedbeans.iterator(); iter.hasNext();) {
			Element bean = (Element) iter.next();			contextDocuments[i].getRootElement().addContent(bean.detach());
		}
	}

and voila...

[davison]

Is it possible you could post .patch files for the changes you made either to JIRA or the spring-developer mailing list? I'd be very interested in getting this included in beandoc - it's one of the annoying things it can't do right now.

Thanks for sharing your efforts.

Regards,

[davison]

a modified version of this that recurses imports is now in CVS.

Thanks again,