Spring Boot @RequestParam 教程

来源：这里教程网时间：2026-02-17 21:33:19 作者：

在本教程中，我们将在控制器中使用@RequestParam注解来读取请求参数。

Spring 是流行的 Java 应用框架，而 Spring Boot 是 Spring 的演进，可以帮助轻松地创建独立的，生产级的基于 Spring 的应用。

Spring @RequestParam

@RequestParam 是一个 Spring 注解，用于将 Web 请求参数绑定到方法参数。

它具有以下可选元素：

defaultValue-当没有提供 request 参数或值为空时用作备用name-要绑定到的请求参数的名称required-告诉参数是否为必需值-名称的别名

Spring @RequestParam示例

以下示例创建一个使用@RequestParam的 Spring Boot Web 应用。我们有一个带有两个标签的 HTML 表单：文本输入和复选框。这两个标记创建请求参数，该参数在控制器中通过@RequestParam读取。

$ tree.├── pom.xml└── src    ├── main    │   ├── java    │   │   └── com    │   │       └── zetcode    │   │           ├── Application.java    │   │           └── controller    │   │               └── MyController.java    │   └── resources    │       └── static    │           └── index.html    └── test        └── java

这是 Spring Boot 应用的项目结构。

pom.xml

<?xml version="1.0" encoding="UTF-8"?><project xmlns="http://maven.apache.org/POM/4.0.0"         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0         http://maven.apache.org/xsd/maven-4.0.0.xsd">    <modelVersion>4.0.0</modelVersion>    <groupId>com.zetcode</groupId>    <artifactId>requestparamex</artifactId>    <version>1.0-SNAPSHOT</version>    <packaging>jar</packaging>    <properties>        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>        <maven.compiler.source>11</maven.compiler.source>        <maven.compiler.target>11</maven.compiler.target>    </properties>    <parent>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-boot-starter-parent</artifactId>        <version>2.1.1.RELEASE</version>    </parent>    <dependencies>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-devtools</artifactId>            <optional>true</optional>        </dependency>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter-web</artifactId>        </dependency>    </dependencies>    <build>        <plugins>            <plugin>                <groupId>org.springframework.boot</groupId>                <artifactId>spring-boot-maven-plugin</artifactId>            </plugin>        </plugins>    </build></project>

在 Maven 构建文件中，我们有spring-boot-starter-web，它是使用 Spring MVC 构建 Web 应用的入门。它使用 Tomcat 作为默认的嵌入式容器。 spring-boot-devtools是在开发 Spring Boot 应用时有用的构件。它允许自动重启或实时重新加载应用。该应用打包到一个 JAR 文件中。

com/zetcode/MyController.java

package com.zetcode.controller;import org.springframework.http.MediaType;import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RequestParam;import org.springframework.web.bind.annotation.ResponseBody;@Controllerpublic class MyController {    @RequestMapping(path="/message", produces=MediaType.TEXT_PLAIN_VALUE)    @ResponseBody    public String processForm(@RequestParam(defaultValue="Guest") String name,                              @RequestParam(required = false) String adult) {        var greet = "on".equals(adult) ? "Good morning" : "Hi";        var message = String.format("%s %s!", greet, name);        return message;    }}

控制器处理 HTML 表单。它从请求中读取两个参数。

@Controllerpublic class MyController {

在 Spring 中，控制器类使用@Controller注解进行注解。

@RequestMapping(path="/message", produces=MediaType.TEXT_PLAIN_VALUE)@ResponseBody

processForm()方法映射到/message路径并返回纯文本。 @ResponseBody注解指示方法返回值已绑定到 Web 响应正文。

public String processForm(@RequestParam(defaultValue="Guest") String name,        @RequestParam(required = false) String adult) {

使用@RequestParam注解，我们将 request 参数绑定到方法变量。如果参数不可用（文本输入为空），则defaultValue选项将提供默认值。 required选项表明该参数是必需的。该方法重新调整字符串。

var greet = "on".equals(adult) ? "Good morning" : "Hi";var message = String.format("%s %s!", greet, name);return message;

我们构建消息并返回。

resources/static/index.html

<!DOCTYPE html><html lang="en">    <head>        <title>Home page</title>        <meta charset="UTF-8"/>        <meta name="viewport" content="width=device-width, initial-scale=1.0"/>    </head>    <body>        <form action="message">            <div>                <label>Name:</label>                <input type="text" name="name">            </div>            <div>                <label><input type="checkbox" name="adult">Adult</label>            </div>            <button type="submit">Submit</button>        </form>    </body></html>

index.html文件是主页。该文件位于src/main/resources/static目录中，Spring Boot 在该目录中需要静态资源，例如 HTML 或 CSS 文件。我们有一个带有输入文本和复选框标签的简单 HTML 表单。

<form action="message">

action选项包含在控制器方法映射中使用的字符串。

com/zetcode/Application.java

package com.zetcode;import org.springframework.boot.SpringApplication;import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplicationpublic class Application  {    public static void main(String[] args) {        SpringApplication.run(Application.class, args);    }}

Application是设置 Spring Boot 应用的入口。 @SpringBootApplication注解启用自动配置和组件扫描。