Latest web development tutorials

Servlet 包

涉及到WEB-INF 子目錄的Web 應用程序結構是所有的Java web 應用程序的標準,並由Servlet API 規範指定。 給定一個頂級目錄名myapp,目錄結構如下所示:

/myapp
    /images
    /WEB-INF
        /classes
        /lib

WEB-INF 子目錄中包含應用程序的部署描述符,名為web.xml。 所有的HTML文件都位於頂級目錄myapp下。 對於admin 用戶,您會發現ROOT 目錄是myApp 的父目錄。

創建包中的Servlet

WEB-INF/classes 目錄包含了所有的Servlet 類和其他類文件,類文件所在的目錄結構與他們的包名稱匹配。 例如,如果您有一個完全合格的類名稱com.myorg.MyServlet ,那麼這個Servlet類必須位於以下目錄中:

/myapp/WEB-INF/classes/com/myorg/MyServlet.class

下面的例子創建包名為com.myorg的MyServlet類。

// 為包命名package com.myorg;  

// 導入必需的java 庫import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
 
public class MyServlet 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;charset=UTF-8");
 
      // 實際的邏輯是在這裡PrintWriter out = response.getWriter();
      out.println("<h1>" + message + "</h1>");
  }
  
  public void destroy()
  {
      // 什麼也不做}
}

編譯包中的Servlet

編譯包中的類與編譯其他的類沒有什麼大的不同。 最簡單的方法是讓您的java 文件保留完全限定路徑,如上面提到的類,將被保留在com.myorg 中。 您還需要在CLASSPATH 中添加該目錄。

假設您的環境已正確設置,進入<Tomcat-installation-directory>/webapps/ROOT/WEB-INF/classes目錄,並編譯MyServlet.java,如下所示:

$ javac MyServlet.java

如果Servlet 依賴於其他庫,那麼您必須在CLASSPATH 中也要引用那些JAR 文件。 這裡我只引用了servlet-api.jar JAR 文件,因為我在Hello World 程序中並沒有使用任何其他庫。

該命令行使用內置的javac 編譯器,它是Sun Microsystems Java 軟件開發工具包(JDK,全稱Java Software Development Kit)附帶的。 Microsystems的Java軟件開發工具包(JDK)。 為了讓該命令正常工作,必須包括您在PATH 環境變量中所使用的Java SDK 的位置。

如果一切順利,上述編譯會在同一目錄下生成MyServlet.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中,您需要在位於<Tomcat-installation-directory>/webapps/ ROOT/WEB-INF/ 的web.xml 文件中創建以下條目:

    <servlet>
        <servlet-name>MyServlet</servlet-name>
        <servlet-class>com.myorg.MyServlet</servlet-class>
    </servlet>
 
    <servlet-mapping>
        <servlet-name>MyServlet</servlet-name>
        <url-pattern>/MyServlet</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/MyServlet 。 如果一切順利,您會看到下面的結果:

Hello World