A servlet project allows you to debug servlets running within Sun's test webserver that is included with the cross platform JavaServer Web Development Kit (JSWDK Version 1.0.x). Although lacking features of a full-scale production webserver, the JSWDK is quite suitable for testing and debugging your servlets.
The JSWDK must be installed before you can use the Servlet project type configuration. It can be downloaded for free at Sun's website: http://java.sun.com/products/servlet. At the time of writing, the most recent version is 1.0.1.
You do not have to use Servlet project type to debug your servlets as the Servlet project type is simply a convenient configuration for debugging servlets running under JSWDK's test webserver. If you want to debug your servlets running in a different environment, you may wish to investigate BugSeeker's Remote Debugging feature. In a nutshell, you will need to find a way to start your production webserver's JVM in debug mode (the JVM options that you need to be supply to the remote VM when launching are provided when you select Debug | Remote | Listen or Attach).
Webserver Arguments
Unless you need to pass special commands to the JSWDK test webserver, you usually will leave this text field blank.
JSWDK webserver accepts the following optional arguments:
-config [file|url] Read config from URL -noconfig Do not read config -adminport [int] Administration port -serviceid [string] Service Id -port[:id|:*] [int] Listen on int [for Service id] -inet [:id|:*] [inetaddr] Bind server to inet [for Service id] -hostname [:id|:*] [name] Use name as hostname [for Service id] -docbase [:id|:*] [name] Use URL as the content base [for Service id] -workdir [:id|:*] [name] Use scratch file [for Service id]
Please consult the
JSWDK documentation for explanations of what these arguments do.
JSWDK Installation Home
Project's whose project type is Servlet will use Sun's Java Server Web Development Kit's (JSWDK) test web server to launch your servlets. However, before BugSeeker can run projects that use this configuration, you will need to enter the base JSWDK installation home directory so that BugSeeker can load the appropriate files when starting the test web server.
If you do not have the JSWDK installed on your computer, you will need to separate download the JSWDK from http://java.sun.com/products/servlet/ and install it yourself. The latest JSWDK version as of this writing was Version 1.0.1.