The Configuring Servlets page allows you to enter, edit, or delete servlet configuration information for local or remote servlets. It also allows you to load and unload the servlet from the server. For more information on loading and invoking servlets, see Loading and Invoking Servlets.

The Configuring Servlets page contains two cards, Configuration and Properties, and a row of buttons.

Configuration Card

Name

The unique name of the servlet. The name must be unique to the service.

Description

A text string describing the servlet. This field can be left blank.

Class Name

The name of the associated class file for the servlet. If the servlet is part of a package, the class name should include the package name, if any. For example, if a servlet of class OrderServlet was in package com.myCompany.sales, then the class name provided here should be com.myCompany.sales.OrderServlet

Load at Startup

Whether the Java Web Server should load the servlet when the server starts.

Loaded Now

Whether the servlet is currently loaded.

Load Remotely

Whether the Java Web Server loads the servlet from a remote location.

Class File URL

The URL that points to the class file for the remote servlet.

To Enter Information for a Servlet

• The Name and Class Name fields should have the same values as those you entered in the Adding Servlets screen.
• Enter a description of the servlet. This step is optional.
• Add any initialization arguments in the Properties Card.
• To have the Java Web Server load the servlet when the server starts, click Yes in the Load at Startup field. (By default, servlets are loaded when you invoke them for the first time.)
• If the servlet is a remote servlet,
  • Click Yes at the Load Remotely prompt.
  • In the Class File URL field, enter the full URL, ending with a slash, of the servlet's class file on the remote server. For example, if HelloWorld.class exists on a remote Java Web Server named nightsky.com in the top level public_html directory, then the URL is http://nightsky.com/.
• Click Save.

To Delete Information for a Servlet

• Select the entry for the servlet that you want to delete.
• Click Remove.

To Edit a Servlet Entry

• Select the entry
• Delete the entry
• Reenter the entry
• Click Save

The Properties card of the Configuring Servlets page has a table with two columns. The left column is titled Property and holds property names. The right column is titled Value and holds the left-column property's value. Beside the table there are three buttons: Add, Modify, and Remove.

Properties Procedures

To Enter a Property

• Click the Add button. This will open a new row in the table.
• Click the left column and enter the name of the property.
• Use the tab key or the mouse to advance to the right column, and add the property value.
• Click Save. (If you are entering multiple properties, it is not necessary to click save after each entry.)

To Change a Property

• Select the row of the table that holds the property by clicking on it with the mouse.
• Select the field to be changed, and change its text.
• Click Save.

To Delete a Property

• Select the row of the table that holds the property by clicking on it with the mouse.
• Click the Remove button to the right of the table. (Do not use the Remove... button at the bottom of the page, because it removes the entire servlet from the service.)
• Click Save.

• Load/Unload - Loads or unloads the servlet.
• Remove... - Removes the servlet from the servlet list.
• Save - Writes your changes to the Java Web Server and changes the settings.
• Revert - Takes you back to the previous settings for all fields in the screen. Use this button to undo changes you have not yet saved.
• Defaults - Changes all the fields to their default settings. This includes removing the servlet's name, class name, and description, and marking No as chosen at the Load at Startup, Loaded Now, and Load Remotely prompts.

Top java-server-feedback@java.sun.com

Copyright © 1997 Sun Microsystems, Inc. All Rights Reserved.