Sun Java System Web Server 6.1 SP9 Programmer's Guide

Preface

This guide is a starting point for developers who need information about using the various APIs and programming technologies that are supported in Sun Java^TM System Web Server 6.1. The guide summarizes the APIs, and provides information about configuring your server to work with server-side HTML tags and CGI programs.

This preface contains information about the following topics:

Who Should Use This Guide

The intended audience for this guide is the person who develops, assembles, and deploys Java™ 2 Platform, Standard Edition (J2SE)-supported web applications in a corporate enterprise.

This guide assumes you are familiar with the following topics:

The J2EE specification
HTML
The Java™ programming language
Java APIs as defined in the Java™ Servlet, JavaServer Pages™ (JSP™), and Java™ DataBase Connectivity (JDBC™) specifications
Structured database query languages such as SQL
Relational database concepts
Software development processes

Using the Documentation

The Sun Java System Web Server manuals are available as online files in PDF and HTML formats from http://docs.sun.com/app/docs/coll/1308.5.

The following table lists the tasks and concepts described in the Sun Java System Web Server manuals.

Table P–1 Sun Java System Web Server Documentation Roadmap


For Information About	See the Following
Late-breaking information about the software and documentation	Release Notes
Getting started with Sun Java System Web Server, including hands-on exercises that introduce server basics and features (recommended for first-time users)	Getting Started Guide
Performing installation and migration tasks: Installing Sun Java System Web Server and its various components, supported platforms, and environments Migrating from Sun Java System Web Server 4.1 or 6.0 to Sun Java System Web Server 6.1	Installation and Migration Guide
Performing the following administration tasks: Using the Administration and command-line interfaces Configuring server preferences Using server instances Monitoring and logging server activity Using certificates and public key cryptography to secure the server Configuring access control to secure the server Using Java™ 2 Platform, Standard Edition (J2SE) security features Deploying applications Managing virtual servers Defining server workload and sizing the system to meet performance needs Searching the contents and attributes of server documents, and creating a text search interface Configuring the server for content compression Configuring the server for web publishing and content authoring using WebDAV	Administrator’s Guide
Using programming technologies and APIs to do the following: Extend and modify Sun Java System Web Server Dynamically generate content in response to client requests Modify the content of the server	Programmer’s Guide
Creating custom Netscape Server Application Programmer’s Interface (NSAPI) plugins	NSAPI Programmer’s Guide
Implementing servlets and JavaServer Pages™ (JSP™) technology in Sun Java System Web Server	Programmer’s Guide to Web Applications
Editing configuration files	Administrator’s Configuration File Reference
Tuning Sun Java System Web Server to optimize performance	Performance Tuning, Sizing, and Scaling Guide

How This Guide Is Organized

This guide provides a basic Sun Java System Web Server environment overview for designing programs.

The guide has the following chapters:

Chapter 1, Technology Overview

This chapter summarizes the various APIs and programming technologies supported by Sun Java System Web Server 6.1.
Chapter 2, Server-parsed HTML Tags

This chapter describes how to configure your server to work with server-side HTML tags.
Chapter 3, Using CGI

This chapter describes how to configure your server to work with Common Gateway Interface (CGI) programs.

Documentation Conventions

This section describes the conventions used throughout this guide.

File and directory paths

These are given in UNIX® format (with forward slashes separating directory names). For Windows versions, the directory paths are the same, except that backslashes are used to separate directories.
URLs are given in the format:
```
http://server.domain/path/file.html
```
In these URLs, server is the server name where applications are run; domain is your Internet domain name; path is the directory structure of the server; and file is an individual file name. Italic items in URLs are placeholders.
Font conventions include:
- The monospace font is used for sample code and code listings, API and language elements (such as function names and class names), file names, path names, directory names, and HTML tags.
- Italic monospace type is used for code variables.
- Italic type is also used for book titles, emphasis, variables and placeholders, and words used in the literal sense.
- Bold type is used as either a paragraph lead-in or to indicate words used in the literal sense.
Installation root directories are indicated by install_dir in this guide.

By default, the location of install_dir is as follows:
- On UNIX-based platforms: /opt/SUNWwbsvr/
- On Windows: C:\Sun\WebServer6.1

Product Support

If you have problems with your system, contact customer support using one of the following mechanisms:

The online support web site at:

http://www.sun.com/training/
The telephone dispatch number associated with your maintenance contract

Please have the following information available prior to contacting support. This helps to ensure that our support staff can best assist you in resolving problems.

Description of the problem, including the situation where the problem occurs and its impact on your operation.
Machine type, operating system version, and product version, including any patches and other software that might be affecting the problem.
Detailed steps on the methods you have used to reproduce the problem.
Any error logs or core dumps.