`@RequestParam`

您可以使用 @RequestParam 註解將查詢參數綁定到控制器中的方法參數。以下程式碼片段展示了用法

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

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

	// ...
}

1	使用 `@RequestParam`。

Servlet API 的「請求參數」概念將查詢參數、表單資料和 multipart 混合在一起。然而，在 WebFlux 中，每個都透過 ServerWebExchange 單獨存取。雖然 @RequestParam 僅綁定到查詢參數，但您可以使用資料綁定將查詢參數、表單資料和 multipart 應用於命令物件。

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

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

當在 Map<String, String> 或 MultiValueMap<String, String> 參數上宣告 @RequestParam 註解時，該 Map 將會填入所有查詢參數。

請注意，使用 @RequestParam 是選用的，例如，為了設定其屬性。預設情況下，任何屬於簡單值類型（由 BeanUtils#isSimpleProperty 判斷）且未被任何其他參數解析器解析的參數，都會被視為已使用 @RequestParam 註解。