SAXBench

What's New

[2001-07-22] version 1.0 release.

Abstract

SAXBench is a benchmark program for event-driven XML parser. It's derived from SAXCount/SAX2Count, the sample program of Xerces-J.

SAXBench supports API such as SAX1, SAX2, JAXP1.1, TinyXML, Lark. It's easy to write driver to support other SAX-like API.

Download

VERSION	FILE	CHANGES
1.0	SAXBench-1_0.zip [54KB]

Requirement

JDK 1.1 or higher. Perl for runSAXBench.pl.

Usage

java sax.SAXBench [options] filenames...

Options:

-p name: Specify SAX parser class by name.
-d name: Specify parser driver class by name.
-n / -N: Turn on/off namespace [default=on]
-v / -V: Turn on/off validation [default=off]
-w N: Warmup the parser N times before timing.
-r N: Repeat timing N times.
-h: Show help screen.

You can specify one of the following drivers with -d option:

sax.SAX1Driver (for SAX1 parser)
sax.SAX2Driver (for SAX2 parser)
sax.JAXPDriver (for JAXP1.1 parser)
sax.TinyXMLDriver (for TinyXML)
sax.LarkDriver (for Lark)

output example:

> java sax.SAXBench -d sax.JAXPDriver -w 2 -r 5 SAXBench.xml
warmup: 1356 ms
warmup: 174 ms
parse: 49 ms
parse: 72 ms
parse: 57 ms
parse: 195 ms
parse: 74 ms
avg. = 89 ms
mem. = 174304 bytes

mem. indicates approximate value of static memory usage of the parser and its library.

run with runSAXBench.pl

For convenience, runSAXBench.pl perl script is available.

You need to change following variables in this script.

$JAVA
$BLIB
$JAVAOPT
$PS
$LIB of all sub's

runSAXBench.pl [-name parser] [-J "java options"] [SAXBench options] filenames...

parser is one of the following names.

aelfred
crimson
lark
min
minml
minml2
nanoxml
oracle
tinyxml
xerces
xml4j
xp

Bugs etc.

SAXBench do parsing only. SAXBench do not check correctness of the parse result. Please check it with other tools such as SAXCount.

ToDo

counter mode?

Copyright

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.