Sun Java System Web Server 6.1 SP12 Administrator's Guide

Appendix B Hypertext Transfer Protocol

This appendix provides a short introduction to a few Hypertext Transfer Protocol (HTTP) basics. For more information on HTTP, see the Internet Engineering Task Force (IETF) home page at:

This appendix contains the following sections:

About Hypertext Transfer Protocol

HTTP is a protocol (a set of rules that describe how information is exchanged on a network) that allows a web browser and a web server to “talk” to each other using the ISO Latin1 alphabet, which is ASCII with extensions for European languages.

HTTP is based on a request/response model. The client connects to the server and sends a request to the server. The request contains the following: request method, URI, and protocol version. The client then sends some header information. The server’s response includes the return of the protocol version, status code, followed by a header that contains server information, and then the requested data. The connection is then closed.

The iPlanet Web Server 4.x supports HTTP 1.1. Previous versions of the server supported HTTP 1.0. The server is conditionally compliant with the HTTP 1.1 proposed standard, as approved by the Internet Engineering Steering Group (IESG) and the Internet Engineering Task Force (IETF) HTTP working group. For more information on the criteria for being conditionally compliant, see the Hypertext Transfer Protocol—HTTP/1.1 specification (RFC 2068) at the IETF Web site.


A request from a client to a server includes the following information:

Request Method

A client can request information using a number of methods. The commonly used methods include the following:

Request Header

The client can send header fields to the server. Most are optional. Some commonly used request headers are shown in Request Header.

Table B–1 Common request headers

Request header  



The file types the client can accept. 


Used if the client wants to authenticate itself with a server; information such as the username and password are included. 


The name and version of the client software. 


The URL of the document where the user clicked on the link. 


The Internet host and port number of the resource being requested. 

Request Data

If the client has made a POST or PUT request, it can send data after the request header and a blank line. If the client sends a GET or HEAD request, there is no data to send; the client waits for the server’s response.


The server’s response includes the following:

Status Code

When a client makes a request, one item the server sends back is a status code, which is a three-digit numeric code. There are four categories of status codes:

Status Code contains some common status codes.

Table B–2 Common HTTP status codes

Status code  



OK; successful transmission. This is not an error. 


Found. Redirection to a new URL. The original URL has moved. This is not an error; most browsers will get the new page. 


Use a local copy. If a browser already has a page in its cache, and the page is requested again, some browsers (such as Netscape Navigator) relay to the web server the “last-modified” timestamp on the browser’s cached copy. If the copy on the server is not newer than the browser’s copy, the server returns a 304 code instead of returning the page, reducing unnecessary network traffic. This is not an error. 


Unauthorized. The user requested a document but didn’t provide a valid username or password. 


Forbidden. Access to this URL is forbidden. 


Not found. The document requested isn’t on the server. This code can also be sent if the server has been told to protect the document by telling unauthorized people that it doesn’t exist. 


Server error. A server-related error occurred. The server administrator should check the server’s error log to see what happened. 

Response Header

The response header contains information about the server and information about the document that will follow. Common response headers are shown in Response Header.

Table B–3 Common response headers

Response header  



The name and version of the web server. 


The current date (in Greenwich Mean Time). 


The date when the document was last modified. 


The date when the document expires. 


The length of the data that follows (in bytes). 


The MIME type of the following data. 


Used during authentication and includes information that tells the client software what is necessary for authentication (such as username and password). 

Response Data

The server sends a blank line after the last header field. The server then sends the document data.