Servlet 表单数据

很多情况下，需要传递一些信息，从浏览器到 Web 服务器，最终到后台程序。浏览器使用两种方法可将这些信息传递到 Web 服务器，分别为 GET 方法和 POST 方法。

GET 方法

GET 方法向页面请求发送已编码的用户信息。页面和已编码的信息中间用 ? 字符分隔，如下所示：

  1. http://localhost:8080/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/TomcatTest/HelloForm?name=Servlet教程&url=https://www.jishuchi.com/books/servlet-lang

下面是处理 Web 浏览器输入的 HelloForm.java Servlet 程序。我们将使用 getParameter() 方法，可以很容易地访问传递的信息：

  1. package com.servlet.test;
  3. import java.io.IOException;
  4. import java.io.PrintWriter;
  6. import javax.servlet.ServletException;
  7. import javax.servlet.annotation.WebServlet;
  8. import javax.servlet.http.HttpServlet;
  9. import javax.servlet.http.HttpServletRequest;
  10. import javax.servlet.http.HttpServletResponse;
  12. /**
  13.  * Servlet implementation class HelloForm
  14.  */
  15. @WebServlet("/HelloForm")
  16. public class HelloForm extends HttpServlet {
  17.     private static final long serialVersionUID = 1L;
  19.     /**
  20.      * @see HttpServlet#HttpServlet()
  21.      */
  22.     public HelloForm() {
  23.         super();
  24.         // TODO Auto-generated constructor stub
  25.     }
  27.     /**
  28.      * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)
  29.      */
  30.     protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
  31.         // 设置响应内容类型
  32.         response.setContentType("text/html;charset=UTF-8");
  34.         PrintWriter out = response.getWriter();
  35.         String title = "使用 GET 方法读取表单数据";
  36.         // 处理中文
  37.         String name =new String(request.getParameter("name").getBytes("ISO8859-1"),"UTF-8");
  38.         String docType = "<!DOCTYPE html> \n";
  39.         out.println(docType +
  40.             "<html>\n" +
  41.             "<head><title>" + title + "</title></head>\n" +
  42.             "<body bgcolor=\"#f0f0f0\">\n" +
  43.             "<h1 align=\"center\">" + title + "</h1>\n" +
  44.             "<ul>\n" +
  45.             "  <li><b>站点名</b>："
  46.             + name + "\n" +
  47.             "  <li><b>网址</b>："
  48.             + request.getParameter("url") + "\n" +
  49.             "</ul>\n" +
  50.             "</body></html>");
  51.     }
  53.     // 处理 POST 方法请求的方法
  54.     public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
  55.         doGet(request, response);
  56.     }
  57. }

然后我们在 web.xml 文件中创建以下条目：

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <web-app>
  3.   <servlet>
  4.     <servlet-name>HelloForm</servlet-name>
  5.     <servlet-class>com.servlet.test.HelloForm</servlet-class>
  6.   </servlet>
  7.   <servlet-mapping>
  8.     <servlet-name>HelloForm</servlet-name>
  9.     <url-pattern>/TomcatTest/HelloForm</url-pattern>
  10.   </servlet-mapping>
  11. </web-app>

现在在浏览器的地址栏中输入 http://localhost:8080/TomcatTest/HelloForm?name=Servlet教程&url=https://www.jishuchi.com/books/servlet-lang ，并在触发上述命令之前确保已经启动 Tomcat 服务器。如果一切顺利，您会得到下面的结果：

Servlet 表单数据 - 图1

使用表单的 GET 方法实例

下面是一个简单的实例，使用 HTML 表单和提交按钮传递两个值。我们将使用相同的 Servlet HelloForm 来处理输入。

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="utf-8">
  5. <title>Servlet教程</title>
  6. </head>
  7. <body>
  8. <form action="HelloForm" method="GET">
  9. 网址名：<input type="text" name="name">
  10. <br />
  11. 网址：<input type="text" name="url" />
  12. <input type="submit" value="提交" />
  13. </form>
  14. </body>
  15. </html>

保存这个 HTML 到 hello.html 文件中，目录结构如下所示:

Servlet 表单数据 - 图2

使用表单的 POST 方法实例

让我们对上面的 Servlet 做小小的修改，以便它可以处理 GET 和 POST 方法。下面的 HelloForm.java Servlet 程序使用 GET 和 POST 方法处理由 Web 浏览器给出的输入。

注意：如果表单提交的数据中有中文数据则需要转码： 
  1. String name =new String(request.getParameter(“name”).getBytes(“ISO8859-1”),”UTF-8”);
  1. package com.servlet.test;
  3. import java.io.IOException;
  4. import java.io.PrintWriter;
  6. import javax.servlet.ServletException;
  7. import javax.servlet.annotation.WebServlet;
  8. import javax.servlet.http.HttpServlet;
  9. import javax.servlet.http.HttpServletRequest;
  10. import javax.servlet.http.HttpServletResponse;
  12. /**
  13.  * Servlet implementation class HelloForm
  14.  */
  15. @WebServlet("/HelloForm")
  16. public class HelloForm extends HttpServlet {
  17.     private static final long serialVersionUID = 1L;
  19.     /**
  20.      * @see HttpServlet#HttpServlet()
  21.      */
  22.     public HelloForm() {
  23.         super();
  24.         // TODO Auto-generated constructor stub
  25.     }
  27.     /**
  28.      * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)
  29.      */
  30.     protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
  31.         // 设置响应内容类型
  32.         response.setContentType("text/html;charset=UTF-8");
  34.         PrintWriter out = response.getWriter();
  35.         String title = "使用 POST 方法读取表单数据";
  36.         // 处理中文
  37.         String name =new String(request.getParameter("name").getBytes("ISO8859-1"),"UTF-8");
  38.         String docType = "<!DOCTYPE html> \n";
  39.         out.println(docType +
  40.             "<html>\n" +
  41.             "<head><title>" + title + "</title></head>\n" +
  42.             "<body bgcolor=\"#f0f0f0\">\n" +
  43.             "<h1 align=\"center\">" + title + "</h1>\n" +
  44.             "<ul>\n" +
  45.             "  <li><b>站点名</b>："
  46.             + name + "\n" +
  47.             "  <li><b>网址</b>："
  48.             + request.getParameter("url") + "\n" +
  49.             "</ul>\n" +
  50.             "</body></html>");
  51.     }
  53.     // 处理 POST 方法请求的方法
  54.     public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
  55.         doGet(request, response);
  56.     }
  57. }

现在，编译部署上述的 Servlet，并使用带有 POST 方法的 hello.html 进行测试，如下所示：

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="utf-8">
  5. <title>Servlet教程</title>
  6. </head>
  7. <body>
  8. <form action="HelloForm" method="POST">
  9. 网址名：<input type="text" name="name">
  10. <br />
  11. 网址：<input type="text" name="url" />
  12. <input type="submit" value="提交" />
  13. </form>
  14. </body>
  15. </html>

将复选框数据传递到 Servlet 程序

当需要选择一个以上的选项时，则使用复选框。

下面是一个 HTML 代码实例 checkbox.html，一个带有两个复选框的表单。

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="utf-8">
  5. <title>Servlet教程</title>
  6. </head>
  7. <body>
  8. <form action="CheckBox" method="POST" target="_blank">
  9. <input type="checkbox" name="servlet" checked="checked" />Servlet
  10. <input type="checkbox" name="google"  /> Google
  11. <input type="checkbox" name="taobao" checked="checked" /> 淘宝
  12. <input type="submit" value="选择站点" />
  13. </form>
  14. </body>
  15. </html>

下面是 CheckBox.java Servlet 程序，处理 Web 浏览器给出的复选框输入。

  1. package com.servlet.test;
  3. import java.io.IOException;
  4. import java.io.PrintWriter;
  6. import javax.servlet.ServletException;
  7. import javax.servlet.annotation.WebServlet;
  8. import javax.servlet.http.HttpServlet;
  9. import javax.servlet.http.HttpServletRequest;
  10. import javax.servlet.http.HttpServletResponse;
  12. /**
  13.  * Servlet implementation class CheckBox
  14.  */
  15. @WebServlet("/CheckBox")
  16. public class CheckBox extends HttpServlet {
  17.     private static final long serialVersionUID = 1L;
  19.     protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
  21.         // 设置响应内容类型
  22.         response.setContentType("text/html;charset=UTF-8");
  24.         PrintWriter out = response.getWriter();
  25.         String title = "读取复选框数据";
  26.         String docType = "<!DOCTYPE html> \n";
  27.             out.println(docType +
  28.                 "<html>\n" +
  29.                 "<head><title>" + title + "</title></head>\n" +
  30.                 "<body bgcolor=\"#f0f0f0\">\n" +
  31.                 "<h1 align=\"center\">" + title + "</h1>\n" +
  32.                 "<ul>\n" +
  33.                 "  <li><b>Servlet 标识：</b>: "
  34.                 + request.getParameter("servlet") + "\n" +
  35.                 "  <li><b>Google 标识：</b>: "
  36.                 + request.getParameter("google") + "\n" +
  37.                 "  <li><b>淘宝 标识：</b>: "
  38.                 + request.getParameter("taobao") + "\n" +
  39.                 "</ul>\n" +
  40.                 "</body></html>");
  41.     }
  43.     // 处理 POST 方法请求的方法
  44.     public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
  45.         doGet(request, response);
  46.     }
  47. }

设置对应的 web.xml：

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <web-app>
  3.   <servlet>
  4.     <servlet-name>CheckBox</servlet-name>
  5.     <servlet-class>com.servlet.test.CheckBox</servlet-class>
  6.   </servlet>
  7.   <servlet-mapping>
  8.     <servlet-name>CheckBox</servlet-name>
  9.     <url-pattern>/TomcatTest/CheckBox</url-pattern>
  10.   </servlet-mapping>
  11. </web-app>

读取所有的表单参数

以下是通用的实例，使用 HttpServletRequest 的 getParameterNames() 方法读取所有可用的表单参数。该方法返回一个枚举，其中包含未指定顺序的参数名。

一旦我们有一个枚举，我们可以以标准方式循环枚举，使用 hasMoreElements() 方法来确定何时停止，使用 nextElement() 方法来获取每个参数的名称。

  1. import java.io.IOException;
  2. import java.io.PrintWriter;
  3. import java.util.Enumeration;
  5. import javax.servlet.ServletException;
  6. import javax.servlet.annotation.WebServlet;
  7. import javax.servlet.http.HttpServlet;
  8. import javax.servlet.http.HttpServletRequest;
  9. import javax.servlet.http.HttpServletResponse;
  11. /**
  12.  * Servlet implementation class ReadParams
  13.  */
  14. @WebServlet("/ReadParams")
  15. public class ReadParams extends HttpServlet {
  16.     private static final long serialVersionUID = 1L;
  18.     /**
  19.      * @see HttpServlet#HttpServlet()
  20.      */
  21.     public ReadParams() {
  22.         super();
  23.         // TODO Auto-generated constructor stub
  24.     }
  26.     /**
  27.      * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)
  28.      */
  29.     protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
  30.         // 设置响应内容类型
  31.         response.setContentType("text/html;charset=UTF-8");
  32.         PrintWriter out = response.getWriter();
  33.         String title = "读取所有的表单数据";
  34.         String docType =
  35.             "<!doctype html public \"-//w3c//dtd html 4.0 " +
  36.             "transitional//en\">\n";
  37.             out.println(docType +
  38.             "<html>\n" +
  39.             "<head><meta charset=\"utf-8\"><title>" + title + "</title></head>\n" +
  40.             "<body bgcolor=\"#f0f0f0\">\n" +
  41.             "<h1 align=\"center\">" + title + "</h1>\n" +
  42.             "<table width=\"100%\" border=\"1\" align=\"center\">\n" +
  43.             "<tr bgcolor=\"#949494\">\n" +
  44.             "<th>参数名称</th><th>参数值</th>\n"+
  45.             "</tr>\n");
  47.         Enumeration paramNames = request.getParameterNames();
  49.         while(paramNames.hasMoreElements()) {
  50.             String paramName = (String)paramNames.nextElement();
  51.             out.print("<tr><td>" + paramName + "</td>\n");
  52.             String[] paramValues =
  53.             request.getParameterValues(paramName);
  54.             // 读取单个值的数据
  55.             if (paramValues.length == 1) {
  56.                 String paramValue = paramValues[0];
  57.                 if (paramValue.length() == 0)
  58.                     out.println("<td><i>没有值</i></td>");
  59.                 else
  60.                     out.println("<td>" + paramValue + "</td>");
  61.             } else {
  62.                 // 读取多个值的数据
  63.                 out.println("<td><ul>");
  64.                 for(int i=0; i < paramValues.length; i++) {
  65.                 out.println("<li>" + paramValues[i]);
  66.             }
  67.                 out.println("</ul></td>");
  68.             }
  69.             out.print("</tr>");
  70.         }
  71.         out.println("\n</table>\n</body></html>");
  72.     }
  74.     /**
  75.      * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse response)
  76.      */
  77.     protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
  78.         // TODO Auto-generated method stub
  79.         doGet(request, response);
  80.     }
  82. }

现在，通过下面的表单尝试上面的 Servlet：

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="utf-8">
  5. <title>Servlet教程</title>
  6. </head>
  7. <body>
  9. <form action="ReadParams" method="POST" target="_blank">
  10. <input type="checkbox" name="maths" checked="checked" /> 数学
  11. <input type="checkbox" name="physics"  /> 物理
  12. <input type="checkbox" name="chemistry" checked="checked" /> 化学
  13. <input type="submit" value="选择学科" />
  14. </form>
  16. </body>
  17. </html>

设置相应的 web.xml:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <web-app>
  3.   <servlet>
  4.     <servlet-name>ReadParams</servlet-name>
  5.     <servlet-class>com.servlet.test.ReadParams</servlet-class>
  6.   </servlet>
  7.   <servlet-mapping>
  8.     <servlet-name>ReadParams</servlet-name>
  9.     <url-pattern>/TomcatTest/ReadParams</url-pattern>
  10.   </servlet-mapping>
  11. </web-app>

您可以尝试使用上面的 Servlet 来读取其他的表单数据，比如文本框、单选按钮或下拉框等。

request.getParameterValues(String name) 是获得如 checkbox 类（名字相同，但值有多个）的数据，接收数组变量 ，如 checkobx 类型。

request.getParameter(String name) 是获得相应名的数据，如果有重复的名，则返回第一个的值，接收一般变量 ，如 text 类型。

如果用 getparameter() 获取中文只有问号

  1. String name =new String(request.getParameter("name").getBytes("ISO8859-1"),"UTF-8");

由于 tomcat8 默认编码是 utf-8，而这个过滤器把他当成 ISO8859-1 解码时（即解码了两次），就会出现问题，导致所有中文变成问号

所以我们只需要不使用这个过滤器就可以了。

也就是采用以下代码：

  1. String name =new String(request.getParameter("name"));

这样就能正常显示中文。

解决 POST 中文乱码

  1. //请求解决乱码
  2. response.setContentType("text/html;charset=utf-8");
  4. //响应解决乱码
  5. request.setCharacterEncoding("utf-8");