`@RequestParam`

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

Java

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

	// ...

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

	// ...
}

<1>  使用 `@RequestParam`。

Kotlin

import org.springframework.ui.set

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

	// ...

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

	// ...
}

<1>  使用 `@RequestParam`。

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

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

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

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

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