Applet Project Type

Creating an applet project allows you to debug Java applets running in Sun's Java appletviewer. Before you can debug an applet, you will need to create an HTML file that contains one or more <APPLET> tags that specifies the applet or applets that are to be loaded. If you are unfamiliar with the <APPLET> tag, consult any introductory Java programming book on the topic.

If you are looking to debug your applets using a web browser with Sun's Java Plug-in you do not need to use the Applet project type because the only way to debug with the Java Plug-in is through the use of BugSeeker's remote debugging capabilities to connect to the Plug-in's VM running in debug mode. Debug | Start Process will always launch the appletviewer from BugSeeker which is not what you want when you are trying to debug using Sun's Java Plug-in. Please consult the Remote Debugging chapter of this manual for more information.

URL | HTML File

An URL or local path name to an HTML file containing the applet you wish to debug in the appletviewer must be supplied. If you are entering an URL, it should be prefixed with 'http://'. If you are using the browse feature to locate your HTML file, a 'file:/' prefix will be automatically added to the path name you entered. The file:/ prefix is required only for absolute path names. If you wish to enter a relative local file name, you do not need the file:/ prefix and can simply enter the filename. Note that the current working/runtime directory will be the directory in which BugSeeker was started from unless you specified the working directory in the Runtime tab and BugSeeker is running on a Java 1.3 or above runtime. Please see the working directory section of this manual for more details.

If you enter an incorrect URL or refer to a non-existing local file or if the html file being referred to does not contain an <APPLET> tag, an error message will be printed to the console (View | Console) and the debugging session will be terminated.

If you are running your applet locally, you will also need to ensure that your applet's classes are in the classpath. You should also ensure that your applet's sources are present in the sourcepath if you wish to step through the source as you debug.

Encoding

Allows you to specify the input HTML file's encoding if it differs from your platforms default encoding.

Java Virtual Machine Options

If you need to pass special arguments to the debug JVM, you can do so by entering them in this text field. See Appendix C for list of JVM argument flags that BugSeeker accepts.