js|servlet|教程
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伺服器文檔瞭解更權威的說明?俁ㄊ褂?Java 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:\JavaWebServer\servlets,包的名字(即主目錄下的子目錄名字)是hall,在Windows下,編譯過程如下:
DOS> set CLASSPATH=C:\JavaWebServer\servlets;%CLASSPATH%
DOS> cd C:\JavaWebServer\servlets\hall
DOS> javac YourServlet.java
第二種編譯包裡面的Servlet的方法是進入Servlet主目錄,執行“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下,大多數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也可能用http://host/any-path/any-file.html形式的URL調用並且進行配置完全依賴於伺服器類型,請參考伺服器文檔瞭解細節??