安裝資料來源 Java 程式庫

本頁說明如何使用或修改 Google Visualization Java 程式庫，以及如何為專案開放原始碼貢獻心力。

目錄

1. 相關規定
2. 依附元件
3. 以原樣使用程式庫
4. 執行範例
5. 修改程式庫
6. 為開放原始碼專案貢獻心力

相關規定

您必須具備下列元件，才能使用 Google 視覺化 Java 程式庫：

• 一個 Protocol 容器和 會 WhatsApp API 2.4 或更高版本。最常用的 CR 容器之一是 Apache Tomcat，內含 剖析 API 的元件。如要下載 5.5 版的二進位檔，請參閱 http://tomcat.apache.org/download-55.cgi。您只需安裝核心模組。您還需要 Tomcat 才能完成教學課程章節：開始使用、使用外部資料儲存庫，以及定義功能和事件流。
• Java Development Kit 6.0 以上版本。

  注意：您也可以使用 JDK 5.0 版。不過，您必須從程式庫中每個覆寫介面方法的方法中移除 @Override。這是因為 JDK 6.0 版中的 @Override 註解行為有所變更。

依附元件

資料來源 Java 程式庫具有下列依附元件。該程式庫已通過下列版本測試；其他版本或許也能接受，但並未經過測試。

包含在來源或下載項目中：

• icu4j 4.0.1 版。
• Jakarta Commons lang 版本 2.4。
• Jakarta Commons Logging 1.1.1 版。
• Google 集合程式庫 1.0 版。
• javacc 4.2 版。 只有在要編譯程式庫時，才需要這麼做，例如在修改程式庫時，詳情請參閱下文。
• opencsv 1.8 版。只有在要使用 CSV 資料來源時，才需要執行此操作。

未包含在來源或下載項目中：

• 如要搭配 mySQL 資料庫使用 SqlDataSourceHelper 類別，執行階段環境中還需要 mysql.jar。詳情請參閱 http://www.mysql.com/products/connector/j/。

使用提供的程式庫

本節說明如何在不需要修改時，使用視覺化 Java 程式庫。這項程序會因建構系統而異：

如果使用 Maven，請使用下列設定在視覺化程式庫中設定依附元件：

• 群組 ID：com.google.visualization
• 構件 ID：視覺化資料來源
• 版本號碼：請使用專案頁面中列出的最新版本編號。

如果使用其他建構系統：

• 從專案頁面下載程式庫 ZIP 檔案，將檔案解壓縮，然後視建構系統需要的檔案納入專案中。

執行範例

JAR 範例檔案會與程式庫 JAR 一併包含在可下載的 ZIP 檔案中。如需執行範例的操作說明，請參閱開始使用頁面。

修改程式庫

如要修改程式庫程式碼，您必須從開放原始碼代管網站下載原始碼，然後著手建立。在這之前，請先參閱專案頁面上「程式碼授權」一節提供的授權資訊，確認該用途是否符合規定。

下載及建構程式庫的步驟如下：

1. 按照開放原始碼專案頁面中「來源」>「結帳」分頁的說明，使用 SVN 下載原始碼。
2. 建構程式碼。如果是在 Maven 中建構，請使用來源提供的 pom.xml 檔案。如果使用 Apache Ant 進行建構，請按照後續提供的操作說明進行 (請注意，程式碼已使用 Ant 1.7.0 版進行測試；如果您有舊版 Ant，可能需要升級)

Ant 版本說明

1. 修改建構屬性：

1. 前往所選安裝目錄的 build-src 子目錄。
2. 使用文字編輯器開啟 build.properties 檔案，然後進行下列變更：
   • 編輯 servlet-api.jar 屬性以指向 servlet-api.jar 檔案。舉例來說，如果您已將 Tomcat 安裝到 tomcat_home 目錄中的 c: 磁碟，就必須按照以下方式指定 servlet-api.jar 屬性：
     servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar

     注意：在檔案路徑中使用正斜線，而非反斜線，即使使用 Windows 也無妨

   • 如要使用自己的上述依附元件副本，請編輯同一個 build.properties 檔案中的路徑。

2. 建構程式庫：

前往檔案中的 build-src 子目錄，輸入下列其中一個值：

• ant datasource：建構資料來源程式庫
• ant example：建構範例
• ant - 建構資料來源和範例
• ant test：建構並執行資料來源程式庫測試。修改程式庫時非常實用。

為開放原始碼專案貢獻心力

如要修改開放原始碼專案，您必須取得該專案的提交權限。傳送電子郵件至 [e-mail]，詢問有關如何提交變更的權限和操作說明。