This guide describes how to create and run Java™ 2 Platform, Standard Edition (J2SE platform) applications that follow the new open Java standards model for servlets and JavaServer Pages™ (JSP) technology on the Sun Java System Web Server 6.1. In addition to describing programming concepts and tasks, this guide offers implementation tips and reference material.
This preface contains the following topics:
The intended audience for this guide is the person who develops, assembles, and deploys web applications (servlets and JSPs) in a corporate enterprise.
This guide assumes you are familiar with the following topics:
The J2SE specification
HTML
The Java™ programming language
Java APIs as defined in servlet, JSP, and Java™ DataBase Connectivity (JDBC) specifications
Structured database query languages such as SQL
Relational database concepts
Software development processes, including debugging and source code control
The Sun Java System Web Server 6.1 SP11 manuals are available as online files in PDF and HTML formats at: http://docs.sun.com/app/docs/coll/1308.8
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 | |
Information about Sun Java System Web Server 6.1 FastCGI plug-in, including information about server application functions (SAFs), installation, configuration, technical notes, and pointers to additional resources. |
Sun Java System Web Server 6.1 SP11 FastCGI Plug-in Release Notes |
Information about Sun Java System Web Server 6.1 Reverse Proxy plug-in, including information about server application functions (SAFs), installation, configuration, technical notes, and pointers to additional resources. |
Sun Java System Web Server 6.1 SP11 Reverse Proxy Plug-in 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) | |
Performing installation and migration tasks:
|
Sun Java System Web Server 6.1 SP11 Installation and Migration Guide Note: If you have the Sun JavaTM Enterprise System 1 installed on your system and you want to upgrade the Sun Java System Web Server 6.1 that is part of Sun Java Enterprise System 1 to Sun Java System Web Server 6.1 SP11, you must use the Java Enterprise System (JES) installer to perform the upgrade. Do not use the separate component installer included with Sun Java System Web Server 6.1 SP11. |
Performing the following administration tasks:
| |
Using programming technologies and APIs to do the following:
| |
Creating custom Netscape Server Application Programmer’s Interface (NSAPI) plugins |
Sun Java System Web Server 6.1 SP11 NSAPI Programmer’s Guide |
Implementing servlets and JavaServer PagesTM (JSPTM) technology in Sun Java System Web Server |
Sun Java System Web Server 6.1 SP11 Programmer’s Guide to Web Applications |
Editing configuration files |
Sun Java System Web Server 6.1 SP11 Administrator’s Configuration File Reference |
Tuning Sun Java System Web Server to optimize performance |
Sun Java System Web Server 6.1 SP11 Performance Tuning, Sizing, and Scaling Guide |
This guide provides a Sun Java System Web Server environment overview for designing web applications, and has the following chapters:
This chapter introduces web applications and describes how they are supported in Sun Java System Web Server.
This chapter describes how to create and use servlets.
Chapter 4, Using JavaServer Pages
This chapter describes how to create and use JSPs.
This chapter describes how to create and manage a session that allows users and transaction information to persist between interactions.
Chapter 6, Securing Web Applications
This chapter describes the basic security features of the Sun Java System Web Server and how to write secure web applications.
Chapter 7, Deploying Web Applications
This chapter describes how web applications are assembled and deployed in the Sun Java System Web Server.
Chapter 8, Debugging Web Applications
This chapter provides guidelines for debugging web applications in Sun Java System Web Server.
Appendix A, Internationalization Issues
This appendix discusses internationalization issues pertaining to servlets and JSPs.
Appendix B, Migrating Legacy Servlets
This appendix discusses migrating legacy servlets.
This section describes the types of 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 server's directory structure; 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
If you have problems with your system, contact customer support using one of the following mechanisms:
The online support web site at:
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.
The Sun web site provides information about the following additional resources:
Sun is interested in improving its documentation and welcomes your comments and suggestions. To share your comments, go to http://docs.sun.com and click Feedback.
The following table describes the typographic conventions that are used in this book.
Table P–2 Typographic Conventions
Typeface |
Meaning |
Example |
---|---|---|
AaBbCc123 |
The names of commands, files, and directories, and onscreen computer output |
Edit your .login file. Use ls -a to list all files. machine_name% you have mail. |
AaBbCc123 |
What you type, contrasted with onscreen computer output |
machine_name% su Password: |
aabbcc123 |
Placeholder: replace with a real name or value |
The command to remove a file is rm filename. |
AaBbCc123 |
Book titles, new terms, and terms to be emphasized |
Read Chapter 6 in the User's Guide. A cache is a copy that is stored locally. Do not save the file. Note: Some emphasized items appear bold online. |
The following table shows the default UNIX® system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.
Table P–3 Shell Prompts
Shell |
Prompt |
---|---|
C shell |
machine_name% |
C shell for superuser |
machine_name# |
Bourne shell and Korn shell |
$ |
Bourne shell and Korn shell for superuser |
# |