Cài đặt Thư viện Java nguồn dữ liệu

Trang này mô tả cách sử dụng hoặc sửa đổi thư viện Google trực quan hoá Java cũng như cách đóng góp mã nguồn mở cho dự án.

Nội dung

  1. Yêu cầu
  2. Phần phụ thuộc
  3. Sử dụng Thư viện theo cách được cung cấp
  4. Chạy ví dụ
  5. Sửa đổi Thư viện
  6. Đóng góp cho Dự án nguồn mở

Yêu cầu

Bạn phải có các thành phần sau để sử dụng thư viện Java của Google rõ ràng:

  • Vùng chứa servlet và API Servlet phiên bản 2.4 trở lên. Một trong những vùng chứa servlet thường được dùng nhất là Apache Tomcat, trong đó có cả API Servlet. Truy cập vào http://tomcat.apache.org/download-55.cgi để tải tệp nhị phân xuống cho phiên bản 5.5. Bạn chỉ cần cài đặt mô-đun Core. Bạn cũng cần Tomcat hoàn thành các phần hướng dẫn: Bắt đầu, Sử dụng kho dữ liệu bên ngoài và Xác định khả năng và luồng sự kiện.
  • Bộ phát triển Java phiên bản 6.0 trở lên.

    Lưu ý: Bạn cũng có thể sử dụng JDK phiên bản 5.0. Tuy nhiên, sau đó, bạn phải xoá @Override khỏi mọi phương thức trong thư viện có ghi đè một phương thức giao diện. Nguyên nhân là do có sự thay đổi trong hành vi chú giải @Override trong JDK phiên bản 6.0.

Phần phụ thuộc

Thư viện Java nguồn dữ liệu có các phần phụ thuộc sau đây. Thư viện này đã được kiểm thử với các phiên bản được liệt kê; các phiên bản khác có thể được chấp nhận, nhưng chưa được kiểm thử.

Được bao gồm trong nguồn hoặc tệp tải xuống:

Không được thêm vào nguồn hoặc tệp tải xuống:

  • Để sử dụng lớp SqlDataSourceHelper với cơ sở dữ liệu mySQL, bạn cũng cần có mysql.jar trong môi trường thời gian chạy. Hãy truy cập: http://www.mysql.com/products/connector/j/ để biết chi tiết và các phiên bản có thể tải xuống.

Sử dụng Thư viện theo dịch vụ

Phần này mô tả cách sử dụng thư viện Java trực quan hoá nếu bạn không cần sửa đổi thư viện đó. Quy trình này thay đổi tuỳ theo hệ thống xây dựng của bạn:

Nếu sử dụng Maven, hãy thiết lập phần phụ thuộc trên thư viện hình ảnh với các chế độ cài đặt sau:

  • Mã nhóm: com.google.Visualization
  • Mã nhận dạng cấu phần phần mềm: trực quan hoá-dữ liệu
  • Số phiên bản: Sử dụng số phiên bản mới nhất được nêu trên trang dự án.

Nếu sử dụng bất kỳ hệ thống xây dựng nào khác:

Chạy ví dụ

Các tệp ví dụ JAR đi kèm cùng với các JAR thư viện trong tệp ZIP có thể tải xuống. Trang Bắt đầu có hướng dẫn cách chạy các ví dụ.

Sửa đổi thư viện

Nếu muốn sửa đổi mã thư viện, bạn sẽ phải tải mã nguồn xuống từ trang web lưu trữ nguồn mở và tạo mã đó. Trước khi thực hiện việc này, hãy đọc thông tin cấp phép được liên kết đến phần "Giấy phép mã" trên trang dự án để xem trường hợp sử dụng của bạn có được cho phép hay không.

Dưới đây là các bước để tải xuống và tạo thư viện:

  1. Tải mã nguồn xuống bằng SVN, như mô tả trong thẻ Nguồn > Thanh toán trên trang dự án nguồn mở.
  2. Tạo bản dựng mã của bạn. Nếu tạo bản dựng trong Maven, hãy dùng tệp pom.xml được cung cấp cùng với nguồn. Nếu tạo bằng Apache Ant, hãy làm theo các hướng dẫn được nêu tiếp theo (lưu ý rằng mã đã được kiểm thử với Ant phiên bản 1.7.0; nếu dùng phiên bản Ant cũ hơn, bạn có thể cần phải nâng cấp)

Hướng dẫn tạo Ant

1. Sửa đổi thuộc tính bản dựng:

  1. Chuyển đến thư mục con build-src của thư mục cài đặt mà bạn đã chọn.
  2. Sử dụng trình chỉnh sửa văn bản, mở tệp build.properties và thực hiện các thay đổi sau:
    • Chỉnh sửa thuộc tính servlet-api.jar để trỏ đến tệp servlet-api.jar. Ví dụ: nếu bạn đã cài đặt Tomcat vào ổ c: trong thư mục tomcat_home, thì bạn sẽ chỉ định thuộc tính servlet-api.jar như sau:
      servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar

      Lưu ý: Hãy sử dụng dấu gạch chéo lên thay vì dấu gạch chéo ngược trong đường dẫn tệp, ngay cả khi sử dụng Windows

    • Để sử dụng bản sao của riêng bạn cho các phần phụ thuộc như mô tả ở trên, hãy chỉnh sửa các đường dẫn trong cùng tệp build.properties.

2. Xây dựng thư viện:

Chuyển đến thư mục con build-src trong tệp rồi nhập một trong các nội dung sau:

  • ant datasource – Xây dựng thư viện nguồn dữ liệu
  • ant example – Xây dựng các ví dụ
  • ant – Xây dựng cả nguồn dữ liệu và các ví dụ
  • ant test – Tạo và chạy các bài kiểm thử thư viện nguồn dữ liệu. Rất hữu ích khi bạn sửa đổi thư viện.

Đóng góp cho Dự án nguồn mở

Nếu muốn đóng góp nội dung thay đổi cho dự án nguồn mở này, bạn sẽ phải có quyền gửi đối với dự án. Gửi email đến google-visualization-api@googlegroups.com để yêu cầu cấp quyền và hướng dẫn về cách gửi nội dung thay đổi.