@RequestParam

DeepSeek V3 中英对照 @RequestParam @RequestParam

查看 Servlet 栈中的等效内容

你可以使用 @RequestParam 注解将查询参数绑定到控制器方法的参数上。以下代码片段展示了其用法：

Java

@Controller
@RequestMapping("/pets")
public class EditPetForm {

    // ...

    @GetMapping
    public String setupForm(@RequestParam("petId") int petId, Model model) { 1
        Pet pet = this.clinic.loadPet(petId);
        model.addAttribute("pet", pet);
        return "petForm";
    }

    // ...
}

java

• 使用 @RequestParam。

Kotlin

import org.springframework.ui.set

@Controller
@RequestMapping("/pets")
class EditPetForm {

    // ...

    @GetMapping
    fun setupForm(@RequestParam("petId") petId: Int, model: Model): String { 1
        val pet = clinic.loadPet(petId)
        model["pet"] = pet
        return "petForm"
    }

    // ...
}

kotlin

• 使用 @RequestParam。

提示

Servlet API 中的“请求参数”概念将查询参数、表单数据和 multipart 数据合并为一个。然而，在 WebFlux 中，每个部分都通过 ServerWebExchange 单独访问。虽然 @RequestParam 仅绑定到查询参数，但你可以使用数据绑定将查询参数、表单数据和 multipart 数据应用到 命令对象。

默认情况下，使用 @RequestParam 注解的方法参数是必需的，但你可以通过将 @RequestParam 的 required 标志设置为 false，或者使用 java.util.Optional 包装器来声明参数，从而指定方法参数为可选的。

如果目标方法参数类型不是 String，则会自动应用类型转换。请参阅类型转换。

当在 Map<String, String> 或 MultiValueMap<String, String> 参数上声明 @RequestParam 注解时，该映射将填充所有的查询参数。

请注意，@RequestParam 的使用是可选的——例如，用于设置其属性。默认情况下，任何简单值类型的参数（由 BeanUtils#isSimpleProperty 确定）且未被任何其他参数解析器解析的参数，都会被当作已用 @RequestParam 注解处理。