2008 年 4 月
新功能 Google Data API Java 用戶端 Eclipse 外掛程式:只需幾秒鐘就能建立專案
本文將補充 Eclipse 外掛程式,以減少設定 Google 資料依附元件所衍生的負擔。也會建立樣板程式碼,以便與您感興趣的 API 互動。 這可讓您輕鬆開始使用 Google Data API 進行開發。
簡介
Eclipse 非常方便 (而且免費!)IDE 是許多 Java 程式設計師的核心。這並不意外,建議您將其與 Java 用戶端程式庫搭配使用,以建立與其中一個 Google Data API 搭配使用的殺手式 Java 應用程式。
設定 Eclipse
如果尚未安裝 Eclipse,安裝時會消失。Eclipse 可以提出修正建議、尋找缺少的匯入內容,以及自動完成方法,讓 Java 開發作業更加輕鬆。前往 Eclipse.org 的下載頁面,取得您作業系統的安裝程式。如要執行 Eclipse,您必須安裝 JRE,並透過 Eclipse 下載頁面連結到該 JRE。安裝 Eclipse 後,您必須建立工作區。這些範例使用 /usr/local/eclipse/workspace
。
安裝所需程式庫
Eclipse 立即提供許多 Java 功能,因此很容易。首先,請從專案下載頁面取得最新版本的 Java 用戶端程式庫。請注意,有兩種不同的下載:分別用於範例及原始碼。下載範例 ZIP 檔案,因為其中含有建立程式所需的 Java 用戶端程式庫經過編譯的 JAR 檔案。如果您想知道用戶端程式庫本身的運作方式,可以下載來源 Zip 並查看,但是這不在本文的討論範圍內。下載範例 ZIP 檔案後,將檔案解壓縮到方便的目錄,即可找到檔案。這些範例使用 /usr/local/eclipse
。這表示專案的 JAR 檔案現在應可透過 /usr/local/eclipse/gdata/java/lib
存取。
現在您已安裝用戶端程式庫,下一步就是下載一些外部依附元件,好讓它們包含在專案建構路徑中。INSTALL-samples.txt
檔案包含您需要的 jar 清單和下載位置。目前的清單為:
檔案名稱 | 位置 |
---|---|
mail.jar | Sun's JavaMail API |
啟用.jar | Sun's JavaBeans Activation Framework |
Servlet-api.jar | Apache Tomcat |
在這個範例中,系統會下載這些 JAR 檔案並複製到 /usr/local/eclipse/gdata/third_party
。
呼!現在,您應該擁有開發使用 Google Data API 的 Java 應用程式所需的一切資訊。請繼續閱讀!
建立新的應用程式
首先,請開啟 Eclipse,然後從「File」(檔案) 選單中選取 [New] (新增) > [Java Project] (Java 專案)。
![Eclipse 新專案視窗](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata1.png?authuser=1&hl=zh-tw)
接著,請按一下 [下一步],然後選取 [程式庫] 標籤。按一下 [新增外部 JAR],新增您下載的所有相依 JAR 檔案。
![新增依附元件 JAR](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata2.png?authuser=1&hl=zh-tw)
您還必須從 Java 用戶端程式庫新增 JAR 檔案。這些變數位於您擷取用戶端程式庫的 java/lib
子目錄中。您「必須」包含以下 JAR 檔案:gdata-client、gdata-client-meta、gdata-core 和 gdata-media。
![新增 GData JAR](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata3.png?authuser=1&hl=zh-tw)
現在請選擇您要使用的 API。此範例使用 Google Documents List API。這需要新增適當的 JAR 檔案:gdata-docs 和 gdata-docs-meta。
![新增 DocList JAR](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata4.png?authuser=1&hl=zh-tw)
最後,您可以點選 [完成] 並建立新專案。
![新建立的專案](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata5.png?authuser=1&hl=zh-tw)
如要建立簡易的測試應用程式,請在 [檔案] 選單中選取 [新增] > [類別],使用主要方法建立新的類別。
![建立類別](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata6.png?authuser=1&hl=zh-tw)
我現在要貼到 Documents List API 開發人員指南,為您貼上一些程式碼。
![含有錯誤的程式碼範例](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata7.png?authuser=1&hl=zh-tw)
您新增許多匯入陳述式前,會有許多錯誤。使用 Eclipse 時,只要按一下左側的錯誤標記就能取得實用的匯入選單,讓您輕鬆完成匯入作業。
![快速修正選單](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata8.png?authuser=1&hl=zh-tw)
清理匯入作業後,您還必須處理程式碼所擲回的例外狀況。這個範例選擇使用一個非常複雜的例外狀況處理常式包圍整個程式碼範例。
![使用程式碼範例](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata9.png?authuser=1&hl=zh-tw)
現在,假設您將使用者名稱和密碼替換成您建立的有效測試帳戶,當您從「Run」(執行) 選單中選擇「Run」(執行) 時,應該會看到該測試帳戶擁有的文件清單。
![程式輸出](https://google-developers.gonglchuangl.net/static/gdata/articles/support/eclipse_gdata/eclipse_gdata10.png?authuser=1&hl=zh-tw)
訂閱成功!
結語
現在您已具備可正常運作的 Eclipse 執行個體和所有必要的 JAR 檔案,可以開始建立適用於各種 Google Data API 的強大 Java 應用程式。
下一步該做什麼?以下提供幾個可能有用的連結:
- Google Data API Java 用戶端 Eclipse 外掛程式
- code.google.com 上的 Google Data 通訊協定說明文件
- Google Data Java 用戶端程式庫專案
- Java 用戶端程式庫入門指南
- JavaDoc 說明文件
Java 是 Sun Microsystems, Inc. 在美國和其他國家/地區的商標。