Radiance DomProfiler Files

Radiance DomProfiler v.061010 - October 10th, 2006
Radiance: http://radiancesoftware.googlepages.com/



VERSIONS USED:

	dom4j 1.6.1		http://dom4j.org/
	XOM 1.1    		http://www.xom.nu/



LICENSES:

	dom4j			http://dom4j.org/license.html
	xom			http://www.xom.nu/license.xhtml
	Radiance DomProfiler	http://DomProfilerLicense-apl1.0



REQUIREMENTS:

	You will require Java Runtime Environment (JRE) 6 Beta 2,
	JDK 6 Beta 2, or newer:
				http://java.sun.com/javase/downloads/ea.jsp



INFORMATION:

Currently, Radiance DomProfiler has the ability to parse an XML file with two parsers - dom4j and xom.  It parses the document 5 times with the selected parser.

As this is JUST the alpha, we have yet to have things near finalization.  We intend to include a more exact method to calculate the memory footpath of the created DOM in upcoming versions.  Also, there will be an ability to specify the number of tests that you want to do with each parser as well as a final test result which will display the results of all runs and their average in terms of time take to parse and memory footpath.  Also, it will then show the percentage that of the original file to the final DOM's memory footpath.

It is interesting to see the parsing speeds and the memory footpath of the parsers, especially for big xml files.  To get a big xml file to try out for yourself, you may download the following .jar file which has 'weblog.xml' that is a 2.88 MB (3021921 bytes) in size:

	http://www.sosnoski.com/opensrc/xmlbench/code/fullbench.jar
	http://www.sosnoski.com/opensrc/xmlbench/download.html
	http://www.sosnoski.com/opensrc/xmlbench/



RELEASES:

DomProfiler.jar - Native Java;  Faster
DomProfiler.exe - Executable Binary file;  Slower



USAGE INSTRUCTIONS:

Keep DomProfiler.jar and the xml files from which the DOM will be parsed in the same folder.  At the command line, find yourself in the directory where DomProfiler.jar and the xml file are located and type the following:

java -jar DomProfiler.jar

The rest should be easy to understand.

If you have downloaded the executable 'DomProfiler.exe', you just need to keep the xml document to be parsed in the same folder as DomProfiler.exe and click on DomProfiler.exe.  Specify you xml file, and the rest shoud be easy to understand.  The DomProfiler.exe version is slower than the native 'DomProfiler.jar'.



SOURCE CODE AND LIBRARIES:

The source code and libraries are included in the jar file.  They can be accessed by decompression with any unzip program.  At Radiance Software, we recommend 7-zip.org's program, 7-zip.