`@RequestParam`

您可以使用 @RequestParam 註解將 Servlet 請求引數（即查詢引數或表單資料）繫結到控制器中的方法引數。

以下示例展示瞭如何實現

Java
Kotlin

@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`。

預設情況下，使用此註解的方法引數是必需的，但您可以透過將 @RequestParam 註解的 required 標誌設定為 false 或透過使用 java.util.Optional 包裝器宣告引數來指定方法引數是可選的。

如果目標方法引數型別不是 String，則會自動應用型別轉換。請參見型別轉換。

將引數型別宣告為陣列或列表允許解析相同引數名稱的多個引數值。

當 @RequestParam 註解被宣告為 Map<String, String> 或 MultiValueMap<String, String>，且未在註解中指定引數名時，Map 將填充每個給定引數名的請求引數值。以下示例展示瞭如何使用表單資料處理來實現這一點

Java
Kotlin

@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 註解。