Spring Boot 常用註解速查表

目錄

隨便點選下方其中一個主題便能直接快速跳到該主題的教學區

1. 應用啟動與配置類
2. 控制器與 API 路由
3. 服務層與依賴注入
4. 資料庫與 DAO 層（JPA）
5. 驗證與例外處理
6. 安全性與授權
7. 建議學習順序
8. 延伸閱讀（本Github Pages專案的其他內容）

1. 應用啟動與配置類

註解	用途
@SpringBootApplication	啟動主類（含組件掃描、配置、自動設定）
@Configuration	用來建立設定類別
@Bean	註冊自定義 Bean
@Value	從 application.yml/properties 注入變數

2. 控制器與 API 路由

註解	用途
@RestController	建立 REST API 控制器
@RequestMapping, @GetMapping, @PostMapping 等	設定 API 路由
@RequestParam	讀取 URL 查詢參數
@PathVariable	讀取 URL 中的路徑變數
@RequestBody	接收 JSON 格式的 request body
@ResponseBody	回傳 JSON 結果（內含於 @RestController）

3. 服務層與依賴注入

註解	用途
@Service	標記服務層類別
@Autowired	自動注入元件
@Component	泛用元件標記

4. 資料庫與 DAO 層（JPA）

註解	用途
@Entity	對應資料表的 Entity 類
@Table(name="...")	指定資料表名稱
@Id	主鍵標記
@GeneratedValue	自動生成主鍵策略
@Column	欄位對應
@Repository	標記 DAO 類別
@Transactional	交易控制，確保資料一致性

5. 驗證與例外處理

註解	用途
@Valid	啟用參數驗證
@NotNull, @Size, @Email 等	常見欄位驗證註解
@ControllerAdvice	全域例外處理配置
@ExceptionHandler	自訂例外處理方法

6. 安全性與授權

註解	用途
@EnableWebSecurity	啟用 Spring Security
@PreAuthorize("hasRole('ROLE_ADMIN')")	方法級權限驗證
@Secured("ROLE_USER")	基於角色的存取控制

建議學習順序

優先級	重點註解	說明
⭐ 必學	@SpringBootApplication, @RestController, @GetMapping, @Service, @Autowired	基本 CRUD 與 API 應用
👍 進階	@RequestBody, @Valid, @Transactional, @Repository	資料處理與驗證
🔐 安全性	@PreAuthorize, @ControllerAdvice	登入驗證與錯誤控制