安裝資料來源 Java 程式庫

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

目錄

  1. 需求條件
  2. 依附元件
  3. 使用系統提供的程式庫
  4. 執行範例
  5. 修改程式庫
  6. 支援開放原始碼專案

相關規定

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

依附元件

資料來源 Java 程式庫具有下列依附元件。已根據列出的版本測試程式庫；其他版本或許都可接受，但尚未經過測試。

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

未包含在來源或下載內容中：

  • 如要將 SqlDataSourceHelper 類別與 mySQL 資料庫搭配使用，您的執行階段環境也需要 mysql.jar。如需詳細資料及可下載的版本，請參閱 http://www.mysql.com/products/connector/j/。

使用所提供的程式庫

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

如果您使用的是 Maven，請透過下列設定對視覺化程式庫設定依附元件：

  • 群組 ID：com.google.visualization
  • 構件 ID：visual--source
  • 版本號碼：請使用專案頁面中所列的最新的版本號碼。

使用其他建構系統：

  • 從專案頁面下載程式庫 ZIP 檔案，解壓縮檔案，然後將其加入建構系統，以符合您的建構系統要求。

執行範例

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

修改程式庫

如要修改程式庫程式碼，您必須從開放原始碼代管網站下載原始程式碼，然後進行建構。在開始之前，請先參閱專案頁面中「程式碼授權」一節所連結的授權資訊，瞭解您是否允許這類用途。

以下是下載及建立程式庫的步驟：

  1. 使用 SVN 下載原始碼 (如開放原始碼專案頁面上的「來源 > Checkout」分頁所述)。
  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_home 目錄中將 Tomcat 安裝至 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：建構並執行資料來源資料庫測試。修改程式庫時特別實用。

支援開放原始碼專案

如要對開放原始碼專案做出變更，您必須取得專案的提交權限。傳送電子郵件至 google-visualization-api@googlegroups.com，要求取得權限說明與提交變更的方法。