sqlRest：零代碼將資料庫暴露為 REST 風格 Web 服務

從資料表到 REST 資源：sqlRest 輕量級資料庫服務化實戰

在 Web 2.0 時代，REST 風格服務已成主流，但傳統資料庫操作仍需大量樣板代碼 (Entity、DAO、Controller)。sqlRest 開源框架打破這一慣例：透過一個 Servlet + 簡單配置，自動將資料表映射為 REST 資源，CRUD 操作直接對應 HTTP 動詞 (GET/POST/PUT/DELETE)。本文完整記錄從部署、配置、測試到 DB2 整合的全流程實踐。

快速啟動：二進制包部署

1. 下載 sqlrest-0.3.2 (SourceForge 唯一可用版本)
2. 解壓後將 webapps/sqlrest 複製至 Tomcat webapps/
3. 啟動 Tomcat，瀏覽 https://localhost:8080/sqlrest 見到資源列表即成功
   

坑點預警：若 Tomcat 啟動報 UnsupportedClassVersionError (JDK 版本不符)，需從 CVS 檢出源碼重新編譯部署。

源碼模式：Eclipse WTP 專案建置 (推薦)

1. Eclipse CVS 配置連接 :pserver:anonymous@sqlrest.cvs.sourceforge.net:/cvsroot/sqlrest
   
2. 檢出專案，轉為 Dynamic Web Project (需 WTP 1.5+)
3. 專案結構參考：
   
4. 關鍵配置：Java Build Path → Output folder 設為 WEB-INF/classes
   
5. 部署至 Tomcat 5.5 + JDK 1.5 環境驗證

核心配置：sqlrestconf.xml

<database>
  <jdbc-driver-class>org.hsqldb.jdbcDriver</jdbc-driver-class>  <!-- 預設 HSQLDB -->
  <database-url>jdbc:hsqldb:file:data/exampledb</database-url>
  <user>sa</user>
  <password></password>
</database>

內建範例資料庫 data/exampledb.script 包含 4 張表：CUSTOMER、PRODUCT、INVOICE、ITEM (複合主鍵)。

REST API 速查表

複合主鍵限制：ITEM 表主鍵為 (INVOICEID, ITEMID)，但當前版本僅解析第一個參數，/sqlrest/ITEM/1/ 返回該發票所有明細，無法精確到單筆明細。

四大測試策略

1. 原生 Java HTTP Client：零依賴，適合單元測試
   

   URL url = new URL("https://localhost:8080/sqlrest/INVOICE/");
   HttpURLConnection con = (HttpURLConnection) url.openConnection();
   con.setRequestMethod("GET"); // 或 POST/PUT/DELETE
   // 處理回應流...

2. sqlRest 內建 RestClient：rest.client.RestClient 封裝佳，可輕鬆擴充回傳 String
3. Firefox Poster 外掛：免寫代碼圖形化發送任意 HTTP 請求，檢視原始回應
   
4. JUnit + Apache HttpClient 自動化：專案 MainServletTest 覆蓋全介面，可整合 Ant 持續集成

<database>
  <jdbc-driver-class>com.ibm.db2.jcc.DB2Driver</jdbc-driver-class>
  <database-url>jdbc:db2:sample</database-url>
  <user>your_user</user>
  <password>your_pwd</password>
</database>