JavaServer Web Development Kit (JSWDK) 1.0.1

JSWDK released: October, 1999

Readme last update: September 21, 1999

Please read the License Agreement  that applies to this software.

The JavaServerTM Web Development Kit (JSWDK) is the reference implementation for JSP and the JavaTM Servlet API. This release of JSWDK supports JSP 1.0 and the Servlet API 2.1.

The JSWDK contains a simple servlet engine for developing and testing servlets, the javax.servlet and javax.servlet.jsp package sources (which are the JSP and Servlet APIs), and API documentation. The JSWDK also contains a simple HTTP web server and a JSP-enabled engine.

Requirements

Operating System

This release has been tested on the following platforms:

JDK version

Environment variables

  1. Add the full path of the JDK bin directory (where the java command is located) to the PATH variable.

  2. For Windows NT:

    To set the path permanently, select Start -> Control Panel. Select System, select Environment, and look for "Path" in the User Variables and System Variables.

    For Window 98 and Windows 95:

    Open and edit the AUTOEXEC.BAT file and add or change the PATH statement. To do so, click Start-> Run and enter Sysedit.

  3. If you are using JDK 1.2 you also need to do one of the following:
    1. Add the tools.jar (from the JDK lib directory) file to your CLASSPATH variable
    2. Set JAVA_HOME to the JDK directory

Installing JSWDK

Once you have downloaded the file, move it to the location where you want to install the JSWDK and extract the contents of the file. (In Windows, simply use Explorer and double-click on the icon for the downloaded file. You will need a WinZip-compatible decompression utility.)

This process automatically creates a subdirectory (by default, jswdk-1.0).

Starting and Stopping the Server

The JSWDK includes Unix shell scripts and Windows batch files to start and stop the server. These are in the main JSWDK directory. In order to view the examples and the default JSWDK page, these scripts need to be run from the main JSWDK directory.

Accessing the Server

Use any web browser to access the following address:
http://localhost:8080, or http://<your-host-name>:8080
This lets you browse the server. It includes links to Javadoc documentation as well as JSP and Servlet examples.

You can change the default port from 8080 - see Configuring the Server below.

Configuring the Server

The webserver.xml file (which is in the base JSWDK directory) lets you adjust server and application settings, including default port and directory mapping and locations.

The syntax of the different options is described in the file itself.

To change the default port for the webserver from 8080 to 80 (or some other number), add the port="<portnum>" statement to the <Service> tag:

For example:

<WebServer id="webServer">
<Service id="service0" port="80">
<WebApplication id="examples" mapping="/examples" docBase="examples"/>
</Service>
</WebServer>
See the contents of the file for the other options that you can edit.

Known Bugs/Limitations

  1. Automatic servlet reloading is not implemented in JSWDK.
  2. The JSP engine treats buffer size in units of characters instead of bytes.

Troubleshooting

  1. Close the DOS window (the error can corrupt its CLASSPATH variable).
  2. Open a new DOS window.
  3. Click on the MS-DOS icon at the top left of the window.
  4. Select the Properties option.
  5. Click on the Memory tab.
  6. Adjust the "Initial Environment" drop-down box from "Auto" to "2816".
  7. Click OK.
  8. Start the server.