Servlet 實例


Servlet 是服務 HTTP 請求並實作 javax.servlet.Servlet 介面的 Java 類別。 Web 應用程式開發人員通常會編寫 Servlet 來擴充 javax.servlet.http.HttpServlet，並實作 Servlet 介面的抽象類別專門用來處理 HTTP 請求。

Hello World 範例程式碼

下面是Servlet 輸出Hello World 的範例原始碼：

// 导入必需的 java 库
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;

// 扩展 HttpServlet 类
public class HelloWorld extends HttpServlet {
 
  private String message;

  public void init() throws ServletException
  {
      // 执行必需的初始化
      message = "Hello World";
  }

  public void doGet(HttpServletRequest request,
                    HttpServletResponse response)
            throws ServletException, IOException
  {
      // 设置响应内容类型
      response.setContentType("text/html");

      // 实际的逻辑是在这里
      PrintWriter out = response.getWriter();
      out.println("<h1>" + message + "</h1>");
  }
  
  public void destroy()
  {
      // 什么也不做
  }
}

編譯Servlet

讓我們把上面的程式碼寫在HelloWorld.java 檔案中，把這個檔案放在C:\ServletDevel（在Windows 上）或/usr/ServletDevel（在UNIX 上）中，您還需要把這些目錄加入到CLASSPATH 中。

假設您的環境已經正確地設置，進入ServletDevel 目錄，並編譯HelloWorld.java，如下所示：

$ javac HelloWorld.java

如果Servlet 依賴任何其他程式庫，您必須在CLASSPATH 中包含那些JAR 檔案。在這裡，我只包含了 servlet-api.jar JAR 文件，因為我沒有在 Hello World 程式中使用任何其他程式庫。

此命令列使用 Sun Microsystems Java 軟體開發工具包（JDK）內建的 javac 編譯器。為使該命令正常運作，您必須 PATH 環境變數中使用的 Java SDK 的位置。

如果一切順利，上面編譯會在同一目錄下產生 HelloWorld.class 檔案。下一節將講解已編譯的 Servlet 如何部署在生產中。

Servlet 部署

預設情況下，Servlet 應用程式位於路徑<Tomcat-installation-directory>/webapps/ROOT 下，且類別檔案放在<Tomcat-installation-directory> /webapps/ROOT/WEB-INF/classes 中。

如果您有一個完全符合資格的類別名稱 com.myorg.MyServlet，那麼這個 Servlet 類別必須位於 WEB-INF/classes/com/myorg/MyServlet.class 中。

現在，讓我們把HelloWorld.class 複製到<Tomcat-installation-directory>/webapps/ROOT/WEB-INF/classes 中，並在位於<Tomcat-installation-directory>/webapps/gt;/webapps/ ROOT/WEB-INF/ 的web.xml 檔案中建立以下條目：

    <servlet>
        <servlet-name>HelloWorld</servlet-name>
        <servlet-class>HelloWorld</servlet-class>
    </servlet>

    <servlet-mapping>
        <servlet-name>HelloWorld</servlet-name>
        <url-pattern>/HelloWorld</url-pattern>
    </servlet-mapping>

上面的條目要被建立在web.xml 檔案中的<web-app>.. .</web-app> 標籤內。在該文件中可能已經有各種可用的條目，但不要在意。

到這裡，您基本上已經完成了，現在讓我們使用<Tomcat-installation-directory>\bin\startup.bat（在Windows 上）或<Tomcat-installation-directory>/bin /startup.sh（在Linux/Solaris 等上）啟動tomcat 伺服器，最後在瀏覽器的網址列中輸入http://localhost:8080/HelloWorld。如果一切順利，您會看到下面的結果：

servlet-example.jpg