使用 Java 撰寫 API 概念

共计 1238 个字符，预计需要花费 4 分钟才能阅读完成。

在具備 API 基本概念的前提下，該如何去完成主管交待的 API 清單項目？相信新手感覺解完概念後還是一頭霧水吧？因此我將屬於 Java 的部份獨立拆出來筆記，針對一些專有名詞做解釋，好便於日後學習。

何謂 JAX-RS？

Java API for RESTful Web Services 是一個 Java 程式語言的應用程式接口, 支持按照 表象化狀態轉變 (REST) 架構風格創建 Web 服務. JAX-RS 使用了 Java SE 5 引入的 Java 標註來簡化 Web 服務客戶端和服務端的開發和部署。

上述是轉自維基百科的定義，其實看起來很難理解，下述我用圖表的方式來幫助理解！

從表中我們可以得知 JAX-RS 其實是說明之前文章提及的 REST Service 實做的物件並加以序列化 (marshal) 輸出給客戶端的協議，其中實現此方法的工具為 Jersey 這是一個 Java Library 裡面預先寫好底層處理相關的套件。

圖片來自 Creating RESTful Web Services with JAX-RS 有興趣的朋友們可以閱讀，但我自己本身是沒有實作，因為配置 XML 實在是很麻煩的事情，再來是他的例子並非是產生 Json 型態的資料，所以這邊只是藉由圖片來幫助自己理解整個架構。

如果閱讀英文比較困難可以選擇閱讀 Java 與 REST 的邂逅（一）淺談 Jersey 及 JAX-RS 這邊談論的都是使用 Jersey 來完成整個業務處理的部分，比較值得注意的是 annotations 註解的使用。

下列的文章我覺得挺不錯的也推薦給大家

Java Tutorial 第六堂（1）REST 與 JAX-RS
Java Tutorial 第六堂（2）使用 Jersey 實作 MVC
Java Tutorial 第六堂（3）整合 Jersey/Spring/Hibernate

這裡簡單講述 MVC 概念，他其實由三個概念所構成分別是 Model、View、Controller 將整個網頁拆成三塊獨立處理，Model 主要負責跟資料庫溝通和邏輯判斷處理，View 則是作為呈現資料的排版或樣式特效相關，Controller 負責使用者訪問的 Url 針對不同的請求呼叫不同的 Model 進行處理最後再輸出到指定的 View 上面。