Spring MVC vs JAX-RS (JSR 311) 深度對比：RESTful 服務開發兩大框架選型指南

Spring 3 引入全面 REST 支援，與 JAX-RS (Jersey 參考實現) 形成兩大主流選擇。本文從引導程序、資源/控制器模型、請求映射、參數綁定、內容協商、異常處理六大維度系統對比，助你根據場景選型。

架構定位差異

引導與依賴注入 (共同基礎)

兩者均使用 `ContextLoaderListener` 載入業務/持久層 Spring 容器：

<context-param>
  <param-name>contextConfigLocation</param-name>
  <param-value>classpath:META-INF/spring/module-config.xml</param-value>
</context-param>
<listener>
  <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

JAX-RS 資源模型

@Path("/accounts/")
@Component @Scope("prototype")  // 每請求實例
public class AccountResource {
  @Context UriInfo uriInfo;
  @Autowired AccountRepository repo;
  
  @GET @Path("{username}")
  public Account getAccount(@PathParam("username") String username) { ... }
  
  @Path("{username}/portfolios/")
  public PortfolioResource getPortfolioResource(@PathParam("username") String username) {
    return new PortfolioResource(repo, username, uriInfo); // 子資源手動實例化
  }
}

• 根資源由 JAX-RS 運行時 (Spring) 管理，支援 `@Context` 注入請求上下文
• 子資源由應用代碼 `new` 建立，依賴透過建構子傳遞
• 形成處理鏈：`AccountResource` → `PortfolioResource`

Spring MVC 控制器模型

@Controller @RequestMapping("/accounts")
public class AccountController {
  @Autowired AccountRepository repo;
  
  @RequestMapping(value="/{username}", method=GET)
  public @ResponseBody Account getAccount(@PathVariable String username) { ... }
}

@Controller @RequestMapping("/accounts/{username}/portfolios")
public class PortfolioController {  // 獨立控制器，無鏈式關係
  @Autowired AccountRepository repo;
  ...
}

• 控制器皆為 Spring 單例 Bean，請求數據通過方法參數注入
• 無子資源概念，路徑直接映射到獨立控制器
• 可選擇在單一控制器處理所有子路徑

請求映射能力對比

Spring MVC 請求匹配條件更豐富，適合複雜 Web 應用路由。

參數綁定與類型轉換

Spring MVC 亮點：參數名與註解值同名時可省略註解值 (`@RequestParam String q`)，需編譯時保留參數名 (`-parameters` / debug symbols)。

類型轉換機制

• JAX-RS：尋找 `valueOf(String)` 靜態方法、單參構造函數、基本類型、集合泛型
• Spring 3：繼承 JAX-RS 規則，新增 `Formatter` / `Converter` 註解驅動格式化體系 (`@DateTimeFormat`、`@NumberFormat` 等)