Servlet 表單數據


很多情況下,需要傳遞一些訊息,從瀏覽器到 Web 伺服器,最終到後台程式。瀏覽器使用兩種方法可將這些資訊傳遞到 Web 伺服器,分別為 GET 方法和 POST 方法。

GET 方法

GET 方法向頁面請求發送已編碼的使用者資訊。頁面和已編碼的訊息中間以? 字元分隔,如下所示:

http://www.test.com/hello?key1=value1&key2=value2

GET 方法是預設的從瀏覽器向Web 伺服器傳遞訊息的方法,它會產生一個很長的字串,出現在瀏覽器的網址列中。如果您要向伺服器傳遞的是密碼或其他的敏感訊息,請不要使用 GET 方法。 GET 方法有大小限制:請求字串中最多只能有 1024 個字元。

這些資訊使用 QUERY_STRING  頭傳遞,並且可以透過 QUERY_STRING 環境變數訪問,Servlet 使用 doGet() 方法處理這種類型的請求。

POST 方法

另一個向後台程式傳遞訊息的比較可靠的方法是 POST 方法。 POST 方法打包資訊的方式與 GET 方法基本上相同,但是 POST 方法不是把訊息當作 URL 中 ? 字元後的文字字串進行傳送,而是把這些訊息當作一個單獨的訊息。訊息以標準輸出的形式傳到後台程序,您可以解析和使用這些標準輸出。 Servlet 使用 doPost() 方法處理這種類型的請求。

使用Servlet 讀取表單資料

Servlet 處理表單數據,這些資料會根據不同的情況使用不同的方法自動解析:

  • getParameter():您可以呼叫request.getParameter() 方法來取得表單參數的值。

  • getParameterValues():如果參數出現一次以上,則呼叫該方法,並傳回多個值,例如核取方塊。

  • getParameterNames():如果您想要得到目前請求中的所有參數的完整列表,則呼叫該方法。

使用 URL 的 GET 方法實例

下面是一個簡單的 URL,將使用 GET 方法向 HelloForm 程式傳遞兩個值。

http://localhost:8080/HelloForm?first_name=ZARA&last_name=ALI

##以下是處理Web 瀏覽器輸入的

HelloForm.java# Servlet 程式。我們將使用getParameter()  方法,可以輕鬆存取傳遞的訊息:

import java.io.IOException;
import java.io.PrintWriter;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
 * Servlet implementation class HelloForm
 */
@WebServlet("/HelloForm")
public class HelloForm extends HttpServlet {
	private static final long serialVersionUID = 1L;
       
    /**
     * @see HttpServlet#HttpServlet()
     */
    public HelloForm() {
        super();
        // TODO Auto-generated constructor stub
    }

	/**
	 * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)
	 */
	protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
		// 设置响应内容类型
		response.setContentType("text/html;charset=UTF-8");

		PrintWriter out = response.getWriter();
		String title = "使用 GET 方法读取表单数据";
		String docType =
		"<!doctype html public \"-//w3c//dtd html 4.0 " +
		"transitional//en\">\n";
		out.println(docType +
		    "<html>\n" +
		    "<head><title>" + title + "</title></head>\n" +
		    "<body bgcolor=\"#f0f0f0\">\n" +
		    "<h1 align=\"center\">" + title + "</h1>\n" +
		    "<ul>\n" +
		    "  <li><b>名字</b>:"
		    + request.getParameter("first_name") + "\n" +
		    "  <li><b>姓氏</b>:"
		    + request.getParameter("last_name") + "\n" +
		    "</ul>\n" +
		    "</body></html>");
	}

}

假設您的環境已經正確地設置,編譯HelloForm.java,如下所示:

$ javac HelloForm.java

如果一切順利,上述編譯會產生

HelloForm.class 檔案。接下來,您必須把該類別檔案複製到<Tomcat-installation-directory>/webapps/ROOT/WEB-INF/classes 中,並在位於<Tomcat-installation-directory>/webapps/ROOT/WEB- INF/ 的web.xml 檔案中建立以下條目:

    <servlet>
        <servlet-name>HelloForm</servlet-name>
        <servlet-class>HelloForm</servlet-class>
    </servlet>

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

現在在瀏覽器的網址列中輸入 http://localhost:8080/HelloForm?first_name=ZARA&last_name=ALI ,並在觸發上述命令之前確保已經啟動 Tomcat 伺服器。如果一切順利,您會得到下面的結果:

使用GET 方法讀取表單資料

  • 名字:ZARA

  • #姓氏:ALI

使用表單的GET 方法實例

下面是一個簡單的實例,使用HTML 表單和提交按鈕傳遞兩個值。我們將使用相同的 Servlet HelloForm 來處理輸入。

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>php中文网(php.cn)</title>
</head>
<body>
<form action="HelloForm" method="GET">
名字:<input type="text" name="first_name">
<br />
姓氏:<input type="text" name="last_name" />
<input type="submit" value="提交" />
</form>
</body>
</html>

將這個 HTML 保存到 hello.htm 檔案中,並把它放在 <Tomcat-installation-directory>/webapps/ROOT 目錄下。當您造訪 http://localhost:8080/Hello.htm 時,以下是上面表單的實際輸出。

嘗試輸入名字和姓氏,然後點擊"提交"按鈕,在您本機上查看輸出結果。基於所提供的輸入,它會產生與上一個實例類似的結果。

使用表單的 POST 方法實例

讓我們對上面的 Servlet 做小小的修改,以便它可以處理 GET 和 POST 方法。下面的 HelloForm.java Servlet 程式使用 GET 和 POST 方法處理由 Web 瀏覽器給予的輸入。

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

// 扩展 HttpServlet 类
public class HelloForm extends HttpServlet {
 
  // 处理 GET 方法请求的方法
  public void doGet(HttpServletRequest request,
                    HttpServletResponse response)
            throws ServletException, IOException
  {
      // 设置响应内容类型
      response.setContentType("text/html;charset=UTF-8");

      PrintWriter out = response.getWriter();
	  String title = "Using GET Method to Read Form Data";
      String docType =
      "<!doctype html public \"-//w3c//dtd html 4.0 " +
      "transitional//en\">\n";
      out.println(docType +
                "<html>\n" +
                "<head><title>" + title + "</title></head>\n" +
                "<body bgcolor=\"#f0f0f0\">\n" +
                "<h1 align=\"center\">" + title + "</h1>\n" +
                "<ul>\n" +
                "  <li><b>名字</b>:"
                + request.getParameter("first_name") + "\n" +
                "  <li><b>姓氏</b>:"
                + request.getParameter("last_name") + "\n" +
                "</ul>\n" +
                "</body></html>");
  }
  // 处理 POST 方法请求的方法
  public void doPost(HttpServletRequest request,
                     HttpServletResponse response)
      throws ServletException, IOException {
     doGet(request, response);
  }
}

現在,編譯部署上述的Servlet,並使用帶有POST 方法的Hello.htm 進行測試,如下所示:

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>php中文网(php.cn)</title>
</head>
<body>
<form action="HelloForm" method="POST">
名字:<input type="text" name="first_name">
<br />
姓氏:<input type="text" name="last_name" />
<input type="submit" value="提交" />
</form>
</body>
</html>

下面是上面表單的實際輸出,嘗試輸入名字和姓氏,然後點擊"提交"按鈕,在您本機上查看輸出結果。

是基於所提供的輸入,它會產生與上一個實例類似的結果。

將複選框資料傳遞到 Servlet 程式

#當需要選擇一個以上的選項時,則使用複選框。

下面是一個 HTML 程式碼實例 CheckBox.htm,一個有兩個複選框的表單。

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>php中文网(php.cn)</title>
</head>
<body>
<form action="CheckBox" method="POST" target="_blank">
<input type="checkbox" name="maths" checked="checked" /> 数学
<input type="checkbox" name="physics"  /> 物理
<input type="checkbox" name="chemistry" checked="checked" /> 
                                                化学
<input type="submit" value="选择学科" />
</form>
</body>
</html>

這段程式碼的結果是下面的表單:

以下是 CheckBox.java Servlet 程序,處理 Web 瀏覽器給出的複選框輸入。

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

// 扩展 HttpServlet 类
public class CheckBox extends HttpServlet {
 
  // 处理 GET 方法请求的方法
  public void doGet(HttpServletRequest request,
                    HttpServletResponse response)
            throws ServletException, IOException
  {
      // 设置响应内容类型
      response.setContentType("text/html;charset=UTF-8");

      PrintWriter out = response.getWriter();
	  String title = "读取复选框数据";
      String docType =
      "<!doctype html public \"-//w3c//dtd html 4.0 " +
      "transitional//en\">\n";
      out.println(docType +
                "<html>\n" +
                "<head><title>" + title + "</title></head>\n" +
                "<body bgcolor=\"#f0f0f0\">\n" +
                "<h1 align=\"center\">" + title + "</h1>\n" +
                "<ul>\n" +
                "  <li><b>数学标识:</b>: "
                + request.getParameter("maths") + "\n" +
                "  <li><b>物理标识:</b>: "
                + request.getParameter("physics") + "\n" +
                "  <li><b>化学标识:</b>: "
                + request.getParameter("chemistry") + "\n" +
                "</ul>\n" +
                "</body></html>");
  }
  // 处理 POST 方法请求的方法
  public void doPost(HttpServletRequest request,
                     HttpServletResponse response)
      throws ServletException, IOException {
     doGet(request, response);
  }
}

上面的實例將顯示下面的結果:

#讀取複選框資料

  • 數學標識:on

  • 物理標識:null

  • 化學標識:on

讀取所有的表單參數

以下是通用的實例,使用 HttpServletRequest 的 getParameterNames() 方法讀取所有可用的表單參數。此方法傳回一個枚舉,其中包含未指定順序的參數名。

一旦我們有一個枚舉,我們可以以標準方式循環枚舉,使用hasMoreElements() 方法來確定何時停止,使用nextElement() 方法來取得每個參數的名稱。

import java.io.IOException;
import java.io.PrintWriter;
import java.util.Enumeration;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
 * Servlet implementation class ReadParams
 */
@WebServlet("/ReadParams")
public class ReadParams extends HttpServlet {
	private static final long serialVersionUID = 1L;
       
    /**
     * @see HttpServlet#HttpServlet()
     */
    public ReadParams() {
        super();
        // TODO Auto-generated constructor stub
    }

	/**
	 * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)
	 */
	protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
		// 设置响应内容类型
		response.setContentType("text/html;charset=UTF-8");
		PrintWriter out = response.getWriter();
		String title = "读取所有的表单数据";
		String docType =
			"<!doctype html public \"-//w3c//dtd html 4.0 " +
			"transitional//en\">\n";
			out.println(docType +
			"<html>\n" +
			"<head><meta charset=\"utf-8\"><title>" + title + "</title></head>\n" +
			"<body bgcolor=\"#f0f0f0\">\n" +
			"<h1 align=\"center\">" + title + "</h1>\n" +
			"<table width=\"100%\" border=\"1\" align=\"center\">\n" +
			"<tr bgcolor=\"#949494\">\n" +
			"<th>参数名称</th><th>参数值</th>\n"+
			"</tr>\n");

		Enumeration paramNames = request.getParameterNames();

		while(paramNames.hasMoreElements()) {
			String paramName = (String)paramNames.nextElement();
			out.print("<tr><td>" + paramName + "</td>\n");
			String[] paramValues =
			request.getParameterValues(paramName);
			// 读取单个值的数据
			if (paramValues.length == 1) {
				String paramValue = paramValues[0];
				if (paramValue.length() == 0)
					out.println("<td><i>没有值</i></td>");
				else
					out.println("<td>" + paramValue + "</td>");
			} else {
				// 读取多个值的数据
				out.println("<td><ul>");
				for(int i=0; i < paramValues.length; i++) {
				out.println("<li>" + paramValues[i]);
			}
				out.println("</ul></td>");
			}
			out.print("</tr>");
		}
		out.println("\n</table>\n</body></html>");
	}

	/**
	 * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse response)
	 */
	protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
		// TODO Auto-generated method stub
		doGet(request, response);
	}

}

現在,透過下面的表單嘗試上面的Servlet:

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>php中文网(php.cn)</title>
</head>
<body>

<form action="ReadParams" method="POST" target="_blank">
<input type="checkbox" name="maths" checked="checked" /> 数学
<input type="checkbox" name="physics"  /> 物理
<input type="checkbox" name="chemistry" checked="checked" /> 化学
<input type="submit" value="选择学科" />
</form>

</body>
</html>

現在使用上面的表單呼叫Servlet,將產生以下結果:

您可以嘗試使用上面的Servlet 來讀取其他的表單數據,例如文字方塊、單選按鈕或下拉方塊等。