Compiling Slide Dependencies Slide WebDAV Servlet
Compiling Slide
In order to successfully build Slide, you will need to do the
following. In the instructions below, $JAKARTA_HOME is assumed to be
the directory into which you are installing all of the required
distributions. The detailed dependency list is available in the next
section.
|
|
Download and install a version 1.1 or later Java Development Kit
implementation for your operating system platform. Set a "JAVA_HOME"
environment variable to point at the directory where your JDK is
installed, and add "$JAVA_HOME/bin" to your PATH.
|
|
Download and install Ant 1.3 or later. Then define an environment
variable named "ANT_HOME" and make it point to the path wher you just
installed Ant.
|
|
Download the source distribution of Slide (subpackage "jakarta-slide"),
or check it out via anonymous CVS, into a subdirectory named
"$JAKARTA_HOME/jakarta-slide".
|
|
Download the libraries needed to compile Slide, and either put
the appropriate JARs in the "lib" subdirectory of your Ant distribution,
or in the "lib" subdirectory of the Slide source distribution.
The Slide Ant makefile will attempt to find and copy the JARs required
at runtime. If the JARs are not located in their default location, you
should create a "build.properties" file based on the
"build.properties.sample" file present in the root of the Slide
source repository.
|
|
Build Slide using :
cd $JAKARTA_HOME/jakarta-slide
$ANT_HOME/bin/ant.sh for Unix
%ANT_HOME%\bin\ant for Windows
You can delete the generated files in the "build" and "dist"
subdirectories by executing the following:
cd $JAKARTA_HOME/jakarta-slide
$ANT_HOME/bin/ant.sh clean for Unix
%ANT_HOME%\bin\ant clean for Windows
|
|
A web application which can be used in any Servlet 2.2 compliant can
be found $JAKARTA_HOME/jakarta-slide/dist/webapp/slide.war.
|
Dependencies
Slide has dependencies to some external function libraries. Some of
these dependencies are both compile-time and runtime dependencies,
while some are only runtime dependencies. Some build options also
require additional external libraries.
Slide depends on the following software libraries at build time :
|
| Jakarta Ant 1.2 or later |
| Sun JAXP 1.0 or later (JAXP 1.1ea2 recommended) |
| DOM level 2 API (org.w3c.dom package) |
| SAX 2 API (org.xml.* packages) |
| Sun Servlet API 2.2 |
| Sun Java Transaction API 1.0 |
| Sun Servlet API 2.2 |
| JDOM 1.0 |
| JDK 1.1 or later |
Slide depends on the following software libraries at run time :
|
| Sun JAXP 1.0 or later (JAXP 1.1ea2 recommended) |
| A JAXP-compliant XML parser (DOM level 2 support recommended) |
| Sun Servlet API 2.2 or later |
| Sun Java Transaction API 1.0 |
| JDOM 1.0 (optional) |
| JRE 1.1 or later (1.3 recommended) |
As said above, the requirements for the various build options can
vary. Some might require :
|
| Tomcat 4.0 |
| Ant optional package |
| An Ant supported XSLT processor (Xalan or XSL:P) |
| A JMX MBean server, and the JMX libraries |
| JUnit 3.5 |
Slide
If you want to build an application which uses the Slide API, just add
the slide.jar to your classpath. Then, be sure to put the domain
configuration file in the appropriate directory. By default, it is a
file called "Domain.xml" placed in the directory from which the JVM is
started.
WebDAV Servlet
The WebDAV servlet requires a servlet container which supports at least
the 2.2 API. The easiest solution is to use the web application archive
which is included in the slide distribution (webapp/slide.war) and deploy
it in your servlet container. The WAR file contains a "Domain.xml" file
which should be modified to configure the domain.
|