此版本仍在开发中,尚不被认为是稳定的。对于最新的稳定版本,请使用 Spring Framework 6.2.10spring-doc.cadn.net.cn

@RequestParam

您可以使用@RequestParam注释,将 Servlet 请求参数(即查询参数或表单数据)绑定到控制器中的方法参数。spring-doc.cadn.net.cn

以下示例显示了如何执行此作:spring-doc.cadn.net.cn

@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";
	}

	// ...

}
1 @RequestParam绑定petId.
import org.springframework.ui.set

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

	// ...

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

	// ...

}
1 @RequestParam绑定petId.

默认情况下,使用此注释的方法参数是必需的,但您可以指定method 参数是可选的,方法是将@RequestParam注释的requiredflag 到false或者通过使用java.util.Optional包装纸。spring-doc.cadn.net.cn

如果目标方法参数类型不是String. 请参阅类型转换spring-doc.cadn.net.cn

将参数类型声明为数组或列表允许解析多个参数相同参数名称的值。spring-doc.cadn.net.cn

@RequestParam注释被声明为Map<String, String>MultiValueMap<String, String>,而不在注释中指定参数名称,然后,映射将填充每个给定参数名称的请求参数值。以下示例显示了如何使用表单数据处理来执行此作:spring-doc.cadn.net.cn

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

	// ...

	@PostMapping(path = "/process", consumes = MediaType.APPLICATION_FORM_URLENCODED_VALUE)
	public String processForm(@RequestParam MultiValueMap<String, String> params) {
		// ...
	}

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

	// ...

	@PostMapping("/process", consumes = [MediaType.APPLICATION_FORM_URLENCODED_VALUE])
	fun processForm(@RequestParam params: MultiValueMap<String, String>): String {
		// ...
	}

	// ...

}

请注意,使用@RequestParam是可选的(例如,设置其属性)。默认情况下,任何简单值类型(由 BeanUtils#isSimpleProperty 确定)且未由任何其他参数解析器解析的参数都被视为已注释 跟@RequestParam.spring-doc.cadn.net.cn