- Dbxml address book example -

This code is an example application using dbXML and the xmlDB api with
jsp and servlets to provide an online address book.

If you would like to expand this demo, please do.  I have designed it to be
modular and well organized so it should be fairly easy to build upon.

NOTE:  These instructions assume that you already have the dbXML Server
       up and running.

Installation
------------

1 > Download and install Tomcat version 3.2.1 or higher

      Available at http://jakarta.apache.org/tomcat/

2 > Place a copy of Xerces.jar (From $DBXML_HOME/java/lib) in Tomcat's lib
    directory, renaming the file to ensure that it will be first in the
    classpath. (Yes this is a kludge, but necessary since Tomcat is using it's
    own version of the Dom that is uncompatible with the dbXML api)

    Example...

      cp $DBXML_HOME/java/lib/xerces_1.3.0.jar $TOMCAT_HOME/lib/1xerces_1.3.0.jar

3 > Place the Addressbook.war file in Tomcats's webapp directory

   Example...
   
      cp $DBXML_HOME/java/examples/Addressbook/Addressbook.war $TOMCAT_HOME/webapps

4 > Create the collection /db/addressbook on the dbXML server

   Example...
   
      dbxmladmin ac -c /db -n addressbook
      
5 > Add the following jar files to your classpath ( from $DBXML_HOME/java/lib )

      dbXML.jar
      xmldb.jar
      juggernaut-1.0.jar
      xalan_2.0.1.jar
      jacorb-1.1.jar
      
6 > Start Tomcat
      
   On Unix...     $TOMCAT_HOME/bin/startup.sh
   On Windows...  $TOMCAT_HOME/bin/startup.bat

7 > Finished - You should now be able to load the addressbook.

    http://127.0.0.1:8080/Addressbook

Compiling the Addressbook
-------------------------

1 > Add all jar files from $TOMCAT_HOME/lib to your classpath

2 > Add $DBXML_HOME/java/lib/dbXML.jar to your classpath

3 > Change directory into the Addressbook

      cd $DBXML_HOME/java/examples/Addressbook
      
4 > Use ant (it should be in your path) to build the distribution

      ant
   
      NOTE:  This will build the Addressbook.war file

5 > Copy the Addressbook.war file into $TOMCAT_HOME/webapps

6 > Restart the Tomcat server

Any problems, let us know.....
