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 Java Hình ảnh của Google và cách đóng góp cho 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 như đượ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 Visual:

  • Vùng chứa GVP và API Servlet phiên bản 2.4 trở lên. Một trong những vùng chứa GVP thường được sử dụng nhất là Apache Tomcat, trong đó có API Servlet. Vui lòng xem http://tomcat.apache.org/download-55.cpc để 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 chức năng và Luồng sự kiện.
  • Java Development Kit (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 mà sẽ ghi đè một phương thức giao diện. Nguyên nhân là do có sự thay đổi về hành vi của chú thích @Override trong JDK phiên bản 6.0.

Phần phụ thuộc

Thư viện Java của nguồn dữ liệu có các phần phụ thuộc sau. 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 thử nghiệm.

Có trong nguồn hoặc tệp tải xuống:

Không được đưa 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 thông tin chi tiết và các phiên bản có thể tải xuống.

Sử dụng Thư viện như đã cung cấp

Phần này mô tả cách sử dụng thư viện Java trực quan nếu bạn không cần sửa đổi. Quá trình này sẽ khác nhau tùy 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 trực quan với các chế độ cài đặt sau:

  • Mã nhóm: com.google.Visualization
  • Mã cấu phần phần mềm: image-datasource
  • Số phiên bản: Sử dụng số phiên bản mới nhất liệt kê 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 JAR mẫu được bao gồm cùng với JAR thư viện trong tệp ZIP có thể tải xuống. Bạn có thể xem hướng dẫn về cách chạy ví dụ trên trang Bắt đầu.

Sửa đổi Thư viện

Nếu muốn sửa đổi mã thư viện, bạn sẽ phải tải nguồn xuống từ trang web lưu trữ nguồn mở và tạo nguồn. Trước khi làm việc này, hãy đọc thông tin cấp phép liên kết với mục "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à xây dựng 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 mã của bạn. Nếu tạo bằng Maven, hãy dùng tệp pom.xml được cung cấp kèm theo nguồn. Nếu tạo bằng Apache Ant, hãy làm theo hướng dẫn tiếp theo (lưu ý rằng mã đã được kiểm tra với Ant phiên bản 1.7.0; nếu bạn có phiên bản Ant trước đó, bạn có thể cần phải nâng cấp)

Hướng dẫn xây dựng kiến

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

  1. Chuyển đến thư mục con build-src của thư mục cài đặt đã chọn.
  2. Sử dụng một 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 riêng của các phần phụ thuộc được mô tả ở trên, hãy chỉnh sửa các đường dẫn trong cùng một tệp build.properties.

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

Di chuyển thư mục con build-src trong tệp đó rồi nhập một trong những thông tin sau:

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

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

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