3.1 Servlet基本結(jié)構(gòu)

　　 下面的代碼顯示了一個(gè)簡(jiǎn)單Servlet的基本結(jié)構(gòu)。該Servlet處理的是GET請(qǐng)求，所謂的GET請(qǐng)求，如果你不熟悉HTTP，可以把它看成是當(dāng)用戶在瀏覽器地址欄輸入U(xiǎn)RL、點(diǎn)擊Web頁面中的鏈接、提交沒有指定METHOD的表單時(shí)瀏覽器所發(fā)出的請(qǐng)求。Servlet也可以很方便地處理POST請(qǐng)求。POST請(qǐng)求是提交那些指定了METHOD=“POST”的表單時(shí)所發(fā)出的請(qǐng)求，具體請(qǐng)參見稍后幾節(jié)的討論。
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;

public class SomeServlet extends HttpServlet {
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {

// 使用“request”讀取和請(qǐng)求有關(guān)的信息（比如Cookies）
// 和表單數(shù)據(jù)

// 使用“response”指定HTTP應(yīng)答狀態(tài)代碼和應(yīng)答頭
// （比如指定內(nèi)容類型，設(shè)置Cookie）

PrintWriter out = response.getWriter();
// 使用 "out"把應(yīng)答內(nèi)容發(fā)送到瀏覽器
}
}

　　 如果某個(gè)類要成為Servlet，則它應(yīng)該從HttpServlet 繼承，根據(jù)數(shù)據(jù)是通過GET還是POST發(fā)送，覆蓋doGet、doPost方法之一或全部。doGet和doPost方法都有兩個(gè)參數(shù)，分別為HttpServletRequest 類型和HttpServletResponse 類型。HttpServletRequest提供訪問有關(guān)請(qǐng)求的信息的方法，例如表單數(shù)據(jù)、HTTP請(qǐng)求頭等等。HttpServletResponse除了提供用于指定HTTP應(yīng)答狀態(tài)（200，404等）、應(yīng)答頭（Content-Type，Set-Cookie等）的方法之外，最重要的是它提供了一個(gè)用于向客戶端發(fā)送數(shù)據(jù)的PrintWriter 。對(duì)于簡(jiǎn)單的Servlet來說，它的大部分工作是通過println語句生成向客戶端發(fā)送的頁面。

　　 注意doGet和doPost拋出兩個(gè)異常，因此你必須在聲明中包含它們。另外，你還必須導(dǎo)入java.io包（要用到PrintWriter等類）、javax.servlet包（要用到HttpServlet等類）以及javax.servlet.http包（要用到HttpServletRequest類和HttpServletResponse類）。

　　 最后，doGet和doPost這兩個(gè)方法是由service方法調(diào)用的，有時(shí)你可能需要直接覆蓋service方法，比如Servlet要處理GET和POST兩種請(qǐng)求時(shí)。

　　 3.2 輸出純文本的簡(jiǎn)單Servlet

　　 下面是一個(gè)輸出純文本的簡(jiǎn)單Servlet。

　　 3.2.1 HelloWorld.java
package hall;

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;

public class HelloWorld extends HttpServlet {
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
PrintWriter out = response.getWriter();
out.println("Hello World");
}
}

　　 3.2.2 Servlet的編譯和安裝

　　 不同的Web服務(wù)器上安裝Servlet的具體細(xì)節(jié)可能不同，請(qǐng)參考Web服務(wù)器文檔了解更權(quán)威的說明。假定使用Java Web Server（JWS）2.0，則Servlet應(yīng)該安裝到JWS安裝目錄的servlets子目錄下。在本文中，為了避免同一服務(wù)器上不同用戶的Servlet命名沖突，我們把所有Servlet都放入一個(gè)獨(dú)立的包hall中；如果你和其他人共用一個(gè)服務(wù)器，而且該服務(wù)器沒有“虛擬服務(wù)器”機(jī)制來避免這種命名沖突，那么最好也使用包。把Servlet放入了包hall之后，HelloWorld.java實(shí)際上是放在servlets目錄的hall子目錄下。

　　 大多數(shù)其他服務(wù)器的配置方法也相似，除了JWS之外，本文的Servlet和JSP示例已經(jīng)在BEA WebLogic和IBM WebSphere 3.0下經(jīng)過測(cè)試。WebSphere具有優(yōu)秀的虛擬服務(wù)器機(jī)制，因此，如果只是為了避免命名沖突的話并非一定要用包。

　　 對(duì)于沒有使用過包的初學(xué)者，下面我們介紹編譯包里面的類的兩種方法。

　　 一種方法是設(shè)置CLASSPATH，使其指向?qū)嶋H存放Servlet的目錄的上一級(jí)目錄（Servlet主目錄），然后在該目錄中按正常的方式編譯。例如，如果Servlet的主目錄是C:＼JavaWebServer＼servlets，包的名字（即主目錄下的子目錄名字）是hall，在Windows下，編譯過程如下：
DOS＞ set CLASSPATH=C:＼JavaWebServer＼servlets;%CLASSPATH%
DOS＞ cd C:＼JavaWebServer＼servlets＼hall
DOS＞ javac YourServlet.java

　　 第二種編譯包里面的Servlet的方法是進(jìn)入Servlet主目錄，執(zhí)行“javac directory＼YourServlet.java”（Windows）或者“javac directory/YourServlet.java”（Unix）。例如，再次假定Servlet主目錄是C:＼JavaWebServer＼servlets，包的名字是hall，在Windows中編譯過程如下：
DOS＞ cd C:＼JavaWebServer＼servlets
DOS＞ javac hall＼YourServlet.java

　　 注意在Windows下，大多數(shù)JDK 1.1版本的javac要求目錄名字后面加反斜杠(＼)。JDK1.2已經(jīng)改正這個(gè)問題，然而由于許多Web服務(wù)器仍舊使用JDK 1.1，因此大量的Servlet開發(fā)者仍舊在使用JDK 1.1。

　　 最后，Javac還有一個(gè)高級(jí)選項(xiàng)用于支持源代碼和.class文件的分開放置，即你可以用javac的“-d”選項(xiàng)把.class文件安裝到Web服務(wù)器所要求的目錄。

　　 3.2.3 運(yùn)行Servlet

　　 在Java Web Server下，Servlet應(yīng)該放到JWS安裝目錄的servlets子目錄下，而調(diào)用Servlet的URL是http://host/servlet/ServletName。注意子目錄的名字是servlets（帶“s”），而URL使用的是“servlet”。由于HelloWorld Servlet放入包hall，因此調(diào)用它的URL應(yīng)該是http://host/servlet/hall.HelloWorld。在其他的服務(wù)器上，安裝和調(diào)用Servlet的方法可能略有不同。

　　 大多數(shù)Web服務(wù)器還允許定義Servlet的別名，因此Servlet也可能用http://host/any-path/any-file.html形式的URL調(diào)用。具體如何進(jìn)行配置完全依賴于服務(wù)器類型，請(qǐng)參考服務(wù)器文檔了解細(xì)節(jié)。

　　 3.3 輸出HTML的Servlet

　　 大多數(shù)Servlet都輸出HTML，而不象上例一樣輸出純文本。要輸出HTML還有兩個(gè)額外的步驟要做：告訴瀏覽器接下來發(fā)送的是HTML；修改println語句構(gòu)造出合法的HTML頁面。

　　 第一步通過設(shè)置Content-Type（內(nèi)容類型）應(yīng)答頭完成。一般地，應(yīng)答頭可以通過HttpServletResponse的setHeader方法設(shè)置，但由于設(shè)置內(nèi)容類型是一個(gè)很頻繁的操作，因此Servlet API提供了一個(gè)專用的方法setContentType。注意設(shè)置應(yīng)答頭應(yīng)該在通過PrintWriter發(fā)送內(nèi)容之前進(jìn)行。下面是一個(gè)實(shí)例：

　　 HelloWWW.java
package hall;

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;

public class HelloWWW extends HttpServlet {
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html");
PrintWriter out = response.getWriter();
out.println("＜!DOCTYPE HTML PUBLIC ＼"-//W3C//DTD HTML 4.0 " +
"Transitional//EN＼"＞＼n" +
"＜HTML＞＼n" +
"＜HEAD＞＜TITLE＞Hello WWW＜/TITLE＞＜/HEAD＞＼n" +
"＜BODY＞＼n" +
"＜H1＞Hello WWW＜/H1＞＼n" +
"＜/BODY＞＜/HTML＞");
}
}

　　 3.4 幾個(gè)HTML工具函數(shù)

　　 通過println語句輸出HTML并不方便，根本的解決方法是使用JavaServer Pages（JSP）。然而，對(duì)于標(biāo)準(zhǔn)的Servlet來說，由于Web頁面中有兩個(gè)部分（DOCTYPE和HEAD）一般不會(huì)改變，因此可以用工具函數(shù)來封裝生成這些內(nèi)容的代碼。

　　 雖然大多數(shù)主流瀏覽器都會(huì)忽略DOCTYPE行，但嚴(yán)格地說HTML規(guī)范是要求有DOCTYPE行的，它有助于HTML語法檢查器根據(jù)所聲明的HTML版本檢查HTML文檔合法性。在許多Web頁面中，HEAD部分只包含＜TITLE＞。雖然許多有經(jīng)驗(yàn)的編寫者都會(huì)在HEAD中包含許多META標(biāo)記和樣式聲明，但這里只考慮最簡(jiǎn)單的情況。

　　 下面的Java方法只接受頁面標(biāo)題為參數(shù)，然后輸出頁面的DOCTYPE、HEAD、TITLE部分。清單如下：

　　 ServletUtilities.java
package hall;

public class ServletUtilities {
public static final String DOCTYPE =
"＜!DOCTYPE HTML PUBLIC ＼"-//W3C//DTD HTML 4.0 Transitional//EN＼"＞";

public static String headWithTitle(String title) {
return(DOCTYPE + "＼n" +
"＜HTML＞＼n" +
"＜HEAD＞＜TITLE＞" + title + "＜/TITLE＞＜/HEAD＞＼n");
}

// 其他工具函數(shù)的代碼在本文后面介紹
}

　　 HelloWWW2.java

　　 下面是應(yīng)用了ServletUtilities之后重寫HelloWWW類得到的HelloWWW2：
package hall;

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;

public class HelloWWW2 extends HttpServlet {
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html");
PrintWriter out = response.getWriter();
out.println(ServletUtilities.headWithTitle("Hello WWW") +
"＜BODY＞＼n" +
"＜H1＞Hello WWW＜/H1＞＼n" +
"＜/BODY＞＜/HTML＞");
}
}