Installing JAXP

JAXP is distributed as part of the JavaServer Web Development Kit (JSWDK)
Download JSWDK 1.0.1
- http://java.sun.com/products/servlet/archive.html
JSWDK is implemented in Java and thus available for Windows and Unix platforms
Install JSWDK in a directory of your choice
- http://java.sun.com/products/servlet/README.html
Note that JSWDK is now part of Apache Tomcat

Testing the Installation

Start the JSWDK web server

startserver		// Linux
startserver.bat		// Windows

Acces the default home page
```
http://localhost:8080/
```
From here you can follow the "servlet examples" link and run the examples provided

When you are done, you shut down the web server

stopserver		// Linux
stopserver.bat		// Windows

Compiling your own Servlet

When compiling a class that imports one of the servlet or XML classes, you need to set the classpath appropriately

            		// Linux
set JSWDK = ...		// Installation directory
javac -classpath ".:${JSWDK}/lib/xml.jar:${JSWDK}/lib/servlet.jar" MyFile.java

            		// Windows
set JSWDK= ...		// Installation directory
javac -classpath ".;%JSWDK%/lib/xml.jar;%JSWDK%/lib/servlet.jar" MyFile.java

Of course, this is best defined in a shell script or batch file

Installing your Servlet

If you don't make any changes to the JSWDK set-up, servlets need to be installed in the example directory under
```
examples/WEB-INF/servlets
```
You will find all the example servlets here
```
HelloWorldExample.java
...
```
Copy your .class files to this directory
- You may, of course, also use this directory to compile your code (but not in a production environment)

Executing the Servlet

The big moment of truth arrives
Assuming that your servlet is called MyServlet, enter the following URL in your browser
```
http://localhost:8080/examples/servlet/MyServlet
```
This is also what you would specify in the action of a form

Troubleshooting

One problem stems form the fact that other users might be logged into the same Linux box and ...
- ... try to run the web server at the same time
The best way to solve this problem is to make a simple change to the webserver.xml file in the installation directory
```
<WebServer id="webServer">
    <Service id="service0" port="1234">
    ...
</WebServer>
```
That is, you simply set the port attribute of the Service tag to a unique value
- For example, you can use the last 4 digits of your student number
- If this doesn't work either, add a "1" ("2", ...) in front of the 4 digits
- Note: Port numbers cannot be larger than 65536