Java Servlet和JSP教程（3）(轉)[@more@]

3 Servlet

3.1 Servlet基本結構

下面的程式碼顯示了一個簡單Servlet的基本結構。該Servlet處理的是GET請求，所謂的GET請求，如果你不熟悉HTTP，可以把它看成是當使用者在瀏覽器位址列輸入URL、點選Web頁面中的連結、提交沒有指定METHOD的表單時瀏覽器所發出的請求。Servlet也可以很方便地處理POST請求。POST請求是提交那些指定了 METHOD=“POST”的表單時所發出的請求，具體請參見稍後幾節的討論。

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”讀取和請求有關的資訊（比如Cookies）

// 和表單資料

// 使用“response”指定HTTP應答狀態程式碼和應答頭

// （比如指定內容型別，設定Cookie）

PrintWriter out = response.getWriter();

// 使用 "out"把應答內容傳送到瀏覽器

}

}

如果某個類要成為Servlet，則它應該從HttpServlet 繼承，根據資料是透過GET還是POST傳送，覆蓋doGet、doPost方法之一或全部。doGet和doPost方法都有兩個引數，分別為HttpServletRequest 型別和HttpServletResponse 型別。HttpServletRequest提供訪問有關請求的資訊的方法，例如表單資料、HTTP請求頭等等。HttpServletResponse除了提供用於指定HTTP應答狀態（200，404等）、應答頭（Content-Type，Set-Cookie等）的方法之外，最重要的是它提供了一個用於向客戶端傳送資料的PrintWriter 。對於簡單的Servlet來說，它的大部分工作是透過println語句生成向客戶端傳送的頁面。

注意doGet和doPost丟擲兩個異常，因此你必須在宣告中包含它們。另外，你還必須匯入java.io包（要用到PrintWriter等類）、 javax.servlet包（要用到HttpServlet等類）以及javax.servlet.http包（要用到 HttpServletRequest類和HttpServletResponse類）。

最後，doGet和doPost這兩個方法是由service方法呼叫的，有時你可能需要直接覆蓋service方法，比如Servlet要處理GET和POST兩種請求時。

3.2 輸出純文字的簡單Servlet

下面是一個輸出純文字的簡單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伺服器上安裝Servlet的具體細節可能不同，請參考Web伺服器文件瞭解更權威的說明?俁ㄊ褂?ava Web Server（JWS） 2.0，則Servlet應該安裝到JWS安裝目錄的servlets子目錄下。在本文中，為了避免同一伺服器上不同使用者的Servlet命名衝突，我們把所有Servlet都放入一個獨立的包hall中；如果你和其他人共用一個伺服器，而且該伺服器沒有“虛擬伺服器”機制來避免這種命名衝突，那麼最好也使用包。把Servlet放入了包hall之後，HelloWorld.java實際上是放在servlets目錄的hall子目錄下。

大多數其他伺服器的配置方法也相似，除了JWS之外，本文的Servlet和JSP示例已經在BEA WebLogic和 IBM WebSphere 3.0下經過測試。WebSphere具有優秀的虛擬伺服器機制，因此，如果只是為了避免命名衝突的話並非一定要用包。

對於沒有使用過包的初學者，下面我們介紹編譯包裡面的類的兩種方法。

一種方法是設定CLASSPATH，使其指向實際存放Servlet的目錄的上一級目錄（Servlet主目錄），然後在該目錄中按正常的方式編譯。例如，如果Servlet的主目錄是C:JavaWebServerservlets，包的名字（即主目錄下的子目錄名字）是hall，在 Windows下，編譯過程如下：

DOS> set CLASSPATH=C:JavaWebServerservlets;%CLASSPATH%

DOS> cd C:JavaWebServerservletshall

DOS> javac YourServlet.java

第二種編譯包裡面的Servlet的方法是進入Servlet主目錄，執行“javac directoryYourServlet.java” （Windows）或者“javac directory/YourServlet.java”（Unix）。例如，再次假定Servlet主目錄是C: JavaWebServerservlets，包的名字是hall，在Windows中編譯過程如下：

DOS> cd C:JavaWebServerservlets

DOS> javac hallYourServlet.java

注意在Windows下，大多數JDK 1.1版本的javac要求目錄名字後面加反斜槓()。JDK1.2已經改正這個問題，然而由於許多Web伺服器仍舊使用JDK 1.1，因此大量的Servlet開發者仍舊在使用JDK 1.1。

最後，Javac還有一個高階選項用於支援原始碼和.class檔案的分開放置，即你可以用javac的“-d”選項把.class檔案安裝到Web伺服器所要求的目錄。

3.2.3 執行Servlet

在Java Web Server下，Servlet應該放到JWS安裝目錄的servlets子目錄下，而呼叫Servlet的URL是http: //host/servlet/ServletName。注意子目錄的名字是servlets（帶“s”），而URL使用的是“servlet”。由於 HelloWorld Servlet放入包hall，因此呼叫它的URL應該是http: //host/servlet/hall.HelloWorld。在其他的伺服器上，安裝和呼叫Servlet的方法可能略有不同。

大多數Web伺服器還允許定義Servlet的別名，因此Servlet也可能用形式的URL呼叫?嚀迦綰謂?信渲猛耆?覽滌詵?衿骼嘈停?氬慰擠?衿魑牡盜私庀附凇?

3.3 輸出HTML的Servlet

大多數Servlet都輸出HTML，而不象上例一樣輸出純文字。要輸出HTML還有兩個額外的步驟要做：告訴瀏覽器接下來傳送的是HTML；修改println語句構造出合法的HTML頁面。

第一步透過設定Content-Type（內容型別）應答頭完成。一般地，應答頭可以透過HttpServletResponse的setHeader方法設定，但由於設定內容型別是一個很頻繁的操作，因此Servlet API提供了一個專用的方法setContentType。注意設定應答頭應該在透過PrintWriter傳送內容之前進行。下面是一個例項：

Hello

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("

"Transitional//EN">

" +

"

" +

"

" +

"

" +

"

Hello WWW

" +

"");

}

}

3.4 幾個HTML工具函式

透過println語句輸出HTML並不方便，根本的解決方法是使用JavaServer Pages（JSP）。然而，對於標準的Servlet來說，由於Web頁面中有兩個部分（DOCTYPE和HEAD）一般不會改變，因此可以用工具函式來封裝生成這些內容的程式碼。

雖然大多數主流瀏覽器都會忽略DOCTYPE行，但嚴格地說HTML規範是要求有DOCTYPE行的，它有助於HTML語法檢查器根據所宣告的HTML版本檢查 HTML文件合法性。在許多Web頁面中，HEAD部分只包含

");

}

// 其他工具函式的程式碼在本文後面介紹

}

HelloWWW2.java

下面是應用了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") +

"

" +

"

Hello WWW

" +

"");

}

}