Sun Java Streaming XML Parser (SJSXP) is the implementation of JSR 173 by SUN Microsystems.
This is the EA release.

Contents 
--------
In the distribution you will find "sjsxp.jar" that contains implementation of JSR 173 and samples.
  
Release Notes
-------------

Sun Java Streaming XML Parser (SJSXP) Release Notes are in ./docs directory.

Samples
-------

4 samples are distributed with this installation.

a) CursorParse.java shows how to use Stax Cursor (XMLStreamReader) APIs to parse XML file.
b) EventParse.java shows how to use Stax Event (XMLEventReader) APIs to parse XML file.
c) CursorWriter.java shows how to use Stax Writing APIs to write XML file programatticaly.
d) StreamFP.java shows the usage of Stax Stream Filter APIs. This filter accepts only StartElement 
   and EndElement events and filters out rest of the events.

Running Samples using ANT
-------------------------

There is an ant build (build.xml) file under ./samples directory to run the samples. Ant target name
to run the sample is same as file name. So to run CursorParse.java, go to the samples directory and 
type following on command line.

ant CursorParse

If Stax(JSR 173) APIs jar file name is not same as 'jsr173_1.0_api.jar' or is not at the same location
as 'sjsxp.jar' you will get an error running the samples. In that case, you should tell ant the location
of Stax APIs by over-riding property 'stax.api.jar' in following manner,

ant -Dstax.api.jar="<JSR 173 API LOCATION>" CursorParse

If ANT is not able to find sjsxp.jar , over-ride property 'sjsxp.jar' 

ant -Dsjsxp.jar="sjsxp.jar location" CursorParse

Running Samples Manually
------------------------

You can also run the samples manually. Go to the samples directory.
First you need to compile CursorParse.java with following command

javac -classpath ../jsr173_1.0_api.jar CursorParse.java

You can run CursorParse with the following command.
       
java -classpath .:../sjsxp.jar:../jsr173_api.jar  CursorParse -x 1 ./samples/data/BookCatalogue.xml

BookCatalogue.xml is bundled with SJSXP distribution
												
