`@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 的“request parameter”概念將查詢引數、表單資料和 Multipart 合併為一個。然而，在 WebFlux 中，每個都是透過 ServerWebExchange 單獨訪問的。雖然 @RequestParam 只繫結到查詢引數，但你可以使用資料繫結將查詢引數、表單資料和 Multipart 應用到命令物件。

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

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

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

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