本示例演示了如何使用 Servlet 的doPost()方法来处理 POST 请求

在我们以前的教程的 Java Servlet 实现示例中我展示了doGet()方法的使用。 现在，我将向您展示如何使用doPost()方法来处理表单 POST 提交。 Java Servlet 可以处理各种类型的请求。 下面的列表显示了所有方法及其用途

方法 SERVLET 方法 目的
GET doGet() 在指定的 URL 检索资源
HEAD doHead() 与 GET 相同，只返回标头
POST doPost() 通常用于 Web 表单提交
PUT doPut() 将提供的实体存储在 URL
DELETE doDelete() 删除 URL 标识的资源
OPTIONS doOptions() 返回允许的 HTTP 方法
TRACE doTrace() 用于诊断

项目结构

在我们的项目中，我们确实需要三个文件。pom.xml – 设置 Maven 依赖关系和构建属性，web.xml – 将 Servlet 和 Servlet 本身配置为 java 类

Java Servlet POST 示例 - 图1

Servlet POST 示例项目结构

pom.xml文件

  1. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  2.     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  3.     <modelVersion>4.0.0</modelVersion>
  5.     <groupId>net.javatutorial.tutorials</groupId>
  6.     <artifactId>ServletPOSTExample</artifactId>
  7.     <version>1</version>
  8.     <packaging>war</packaging>
  10.     <name>Servlet POST Example</name>
  11.     <url>https://javatutorial.net</url>
  13.     <properties>
  14.         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  15.     </properties>
  17.     <dependencies>
  18.         <dependency>
  19.             <groupId>javax.servlet</groupId>
  20.             <artifactId>javax.servlet-api</artifactId>
  21.             <version>3.1.0</version>
  22.             <scope>provided</scope>
  23.         </dependency>
  24.     </dependencies>
  26.     <build>
  27.         <finalName>servletpost</finalName>
  28.         <sourceDirectory>src/main/java</sourceDirectory>
  30.         <plugins>
  31.             <plugin>
  32.                 <groupId>org.apache.maven.plugins</groupId>
  33.                 <artifactId>maven-war-plugin</artifactId>
  34.                 <version>2.3</version>
  35.                 <configuration>
  36.                     <warSourceDirectory>src/main/webapp</warSourceDirectory>
  37.                 </configuration>
  38.             </plugin>
  39.             <plugin>
  40.                 <groupId>org.apache.maven.plugins</groupId>
  41.                 <artifactId>maven-compiler-plugin</artifactId>
  42.                 <version>3.1</version>
  43.                 <configuration>
  44.                     <source>1.8</source>
  45.                     <target>1.8</target>
  46.                 </configuration>
  47.             </plugin>
  48.         </plugins>
  49.     </build>
  50. </project>

与上一教程一样，我们将 Servlet 的依赖项javax.servlet-api和maven-war-plugin的依赖关系用于构建网络应用

在web.xml文件中映射 Servlet

  1. <?xml version="1.0" encoding="UTF-8"?>
  3. <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" 
  4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  5.     xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
  6.     version="3.1">
  8.     <display-name>Simple Servlet Application</display-name>
  10.     <servlet>
  11.         <servlet-name>servletPost</servlet-name>
  12.         <servlet-class>net.javatutorial.tutorials.ServletPOST</servlet-class>
  13.         <load-on-startup>1</load-on-startup>
  14.     </servlet>
  16.     <servlet-mapping>
  17.         <servlet-name>servletPost</servlet-name>
  18.         <url-pattern>/welcome</url-pattern>
  19.     </servlet-mapping>
  21. </web-app>

Servlet 被赋予一个名为ServletPost的名称，该名称指向 Java 类ServletPOST。

在 servlet 映射中，我们将 url /welcome分配给 servlet

Servlet 类

  1. package net.javatutorial.tutorials;
  3. import java.io.IOException;
  4. import java.io.PrintWriter;
  6. import javax.servlet.ServletException;
  7. import javax.servlet.http.HttpServlet;
  8. import javax.servlet.http.HttpServletRequest;
  9. import javax.servlet.http.HttpServletResponse;
  11. public class ServletPOST extends HttpServlet {
  13.     private static final long serialVersionUID = -1641096228274971485L;
  15.     @Override
  16.     protected void doGet(HttpServletRequest request, HttpServletResponse response) 
  17.             throws ServletException, IOException {
  19.         // set response headers
  20.         response.setContentType("text/html");
  21.         response.setCharacterEncoding("UTF-8");
  23.         // create HTML form
  24.         PrintWriter writer = response.getWriter();
  25.         writer.append("<!DOCTYPE html>\r\n")
  26.               .append("<html>\r\n")
  27.               .append("        <head>\r\n")
  28.               .append("            <title>Form input</title>\r\n")
  29.               .append("        </head>\r\n")
  30.               .append("        <body>\r\n")
  31.               .append("            <form action=\"welcome\" method=\"POST\">\r\n")
  32.               .append("                Enter your name: \r\n")
  33.               .append("                <input type=\"text\" name=\"user\" />\r\n")
  34.               .append("                <input type=\"submit\" value=\"Submit\" />\r\n")
  35.               .append("            </form>\r\n")
  36.               .append("        </body>\r\n")
  37.               .append("</html>\r\n");
  38.     }
  40.     @Override
  41.     protected void doPost(HttpServletRequest request, HttpServletResponse response) 
  42.             throws ServletException, IOException {
  43.         String user = request.getParameter("user");
  45.         response.setContentType("text/html");
  46.         response.setCharacterEncoding("UTF-8");
  48.         // create HTML response
  49.         PrintWriter writer = response.getWriter();
  50.         writer.append("<!DOCTYPE html>\r\n")
  51.               .append("<html>\r\n")
  52.               .append("        <head>\r\n")
  53.               .append("            <title>Welcome message</title>\r\n")
  54.               .append("        </head>\r\n")
  55.               .append("        <body>\r\n");
  56.         if (user != null && !user.trim().isEmpty()) {
  57.             writer.append("    Welcome " + user + ".\r\n");
  58.             writer.append("    You successfully completed this javatutorial.net example.\r\n");
  59.         } else {
  60.             writer.append("    You did not entered a name!\r\n");
  61.         }
  62.         writer.append("        </body>\r\n")
  63.               .append("</html>\r\n");
  64.     }    
  66. }

在上面的代码中，doGet()方法用于显示表单。 客户端（浏览器）使用 GET 请求调用网址 http://yoururl.com:8080/servletpost/welcome ，它显示以下形式

Java Servlet POST 示例 - 图2

输入表单

该 servlet 在客户端的浏览器中呈现为 HTML，如下所示：

  1. <!DOCTYPE html>
  2. <html>
  3.         <head>
  4.             <title>Form input</title>
  5.         </head>
  6.         <body>
  7.             <form action="welcome" method="POST">
  8.                 Enter your name: 
  9.                 <input type="text" name="user" />
  10.                 <input type="submit" value="Submit" />
  11.             </form>
  12.         </body>
  13. </html>

提交后，将调用 servlet 中的doPost()方法。 在这里，我们根据用户的输入来建立响应。 如果正确填写了姓名字段，则用户会收到问候消息

Java Servlet POST 示例 - 图3

响应后

…或警告消息（如果表单中的名称字段留空）

Java Servlet POST 示例 - 图4

如果缺少名称，则会出现错误消息

您可以在我们的 GitHub 存储库中找到项目源。