2015-07-03
Tags:
程式語言
,
github
,
java
這陣子用 java 去呼叫 github restful api 之後有些心得，將它做個簡單記錄
- github api v3 說明文件在這裡
- github 推薦的 java library 有下列三個
- java library 對 github api v3 支援度
- kohsuke-github-api > jcabi-github > egit-github
- kohsuke-github-api 實作最完整
- jcabi-github 缺少很多實作
- egit-github 的目標是 100% 支援 github api v3，可是 source code 裡反而還存留一堆呼叫 github legacy api 的 code
- java library 操作便捷性
- jcabi-github > kohsuke-github-api > egit-github
- kohsuke-github-api 與 jcabi-github 在操作上比 egit-github 好很多，egit-github 這方面顯的過時
- java library 說明文件完整度
- 三者都很爛，沒啥文件說明。要查怎麼使用要去看 source code 裡 junit test 相關 class
- 因為 egit-github 出來時間最早，所以 stackoverflow 裡比較能找到 egit-github 相關問題的解答
- 總結
- 以現況而言，個人推薦使用 kohsuke-github-api。它對 github api v3 支援最完整，在 libray 操作上也蠻直覺的
- 如果不介意 library 是否用到 github api v3，而是要找白老鼠最多的 library，那選 egit-github 就對了。它最早出來，所以功能最完整，白老鼠最多
- 從設計角度來看，jcabi-github 設計最好。但是因為它太年輕，欠缺很多功能
- github search api 有 bug，我遇過查詢條件正確，但是查詢結果是錯誤的狀況。如果用 java library 去呼叫 github api 卻發現結果總是錯的，這時除了要懷疑 library 本身有 bug 之外，最好要用 restful client 去驗証 github api 是不是一開始就回傳錯誤資料