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ử.
javacc phiên bản 4.2.
Việc này chỉ bắt buộc nếu bạn định biên dịch các thư viện, chẳng hạn như khi sửa đổi các thư viện như mô tả dưới đây.
opencsv phiên bản 1.8. Điều này chỉ bắt buộc nếu bạn định sử dụng nguồn dữ liệu CSV.
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:
Tải tệp ZIP của thư viện xuống từ trang dự án, giải nén các tệp và đưa các tệp đó vào dự án theo yêu cầu của hệ thống xây dựng.
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:
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ở.
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:
Chuyển đến thư mục con build-src của thư mục cài đặt mà bạn đã chọn.
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.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2024-07-10 UTC."],[[["\u003cp\u003eThis documentation guides you on utilizing and extending the Google Visualization Java library for incorporating interactive charts into your applications.\u003c/p\u003e\n"],["\u003cp\u003eIt outlines prerequisites, dependencies, and steps for utilizing the library directly or modifying it to suit your specific needs.\u003c/p\u003e\n"],["\u003cp\u003eInstructions are provided for building the library from source and running included examples for a hands-on understanding.\u003c/p\u003e\n"],["\u003cp\u003eFor those interested in contributing to the project, guidance is offered on seeking permissions and submitting changes to the open-source codebase.\u003c/p\u003e\n"]]],[],null,["# Installing the Data Source Java Library\n\nThis page describes how to use or modify the Google Visualization Java library,\nand how to contribute to the open source code for the project.\n\nContents\n--------\n\n1. [Requirements](#requirements)\n2. [Dependencies](#dependencies)\n3. [Using the Library as Provided](#usingthelibrary)\n4. [Running the Examples](#buildingexamples)\n5. [Modifying the Library](#build_self)\n6. [Contributing to the Open Source Project](#contributing)\n\nRequirements\n------------\n\nYou must have the following components in order to use the Google Visualization\nJava library:\n\n- A servlet container and the Servlet API version 2.4 or higher. One of the most commonly used servlet containers is Apache Tomcat, which includes the Servlet API. See \u003chttp://tomcat.apache.org/download-55.cgi\u003e to download the binary for version 5.5. You need install only the Core module. You also need Tomcat to complete the tutorial sections: [Getting\n Started](/chart/interactive/docs/dev/dsl_get_started), [Using an External Data Store](/chart/interactive/docs/dev/dsl_csv), and [Defining\n Capabilities and the Flow of Events](/chart/interactive/docs/dev/dsl_httpservlet).\n- The [Java Development Kit](http://java.sun.com/) version 6.0 or greater.\n\n **Note** : It is also possible to use the JDK\n version 5.0. However, you must then remove `@Override` from\n every method in the library that overrides an interface method. This is\n due to the change in the `@Override` annotation behavior in\n JDK version 6.0.\n\nDependencies\n------------\n\nThe data source Java library has the following dependencies. The library was\ntested with the versions listed; other versions might be acceptable, but have not\nbeen tested.\n\n**Included in the source or download:**\n\n- [icu4j](http://site.icu-project.org/) version 4.0.1.\n- [Jakarta commons lang](http://commons.apache.org/lang/) version 2.4.\n- [Jakarta commons logging](http://commons.apache.org/logging/) version 1.1.1.\n- [Google collections\n library](http://code.google.com/p/google-collections/) version 1.0.\n- [*javacc*](https://javacc.dev.java.net/) version 4.2. This is required only if you intend to compile the libraries, for example when modifying them as described [below](#build_self).\n- [*opencsv*](http://opencsv.sourceforge.net/) version 1.8. This is required only if you intend to use a CSV data source.\n\n**Not included in the source or download:**\n\n- To use the `SqlDataSourceHelper` class with a mySQL database, you also need `mysql.jar` in your runtime environment. See: \u003chttp://www.mysql.com/products/connector/j/\u003e for details and downloadable versions.\n\nUsing the Library as Provided\n-----------------------------\n\nThis section describes how to use the visualization Java library if you don't\nneed to modify it. This process varies with your build system:\n\n**If using [Maven](http://maven.apache.org/index.html),** set\nup a dependency on the visualization library with the following settings:\n\n- Group ID: com.google.visualization\n- Artifact ID: visualization-datasource\n- Version number: Use the latest version number listed on the [project\n page](http://code.google.com/p/google-visualization-java/).\n\n**If using any other build system**:\n\n- [Download\n the library ZIP file](http://code.google.com/p/google-visualization-java/) from the project page, unzip the files, and include them in your project as your build system requires.\n\nRunning the Examples\n--------------------\n\nThe JAR example files are included along with the library JARs in the [downloadable\nZIP file](http://code.google.com/p/google-visualization-java/). Instructions on running the examples are given on the [Getting\nStarted](/chart/interactive/docs/dev/dsl_get_started) page.\n\nModifying the Library\n---------------------\n\nIf you want to modify the library code, you'll have to download the source from\nthe open source hosting site and build it. Before doing this, read the licensing\ninformation linked to by the \"Code license\" section on the [project\npage](http://code.google.com/p/google-visualization-java/) to see whether your use case is allowed.\n\nHere are the steps for downloading and building the library:\n\n1. **Download the source code** using SVN, as described in on the **Source \\\u003e Checkout** tab on the [open\n source project page](http://code.google.com/p/google-visualization-java/source/checkout).\n2. **Build your code.** If building in Maven, use the pom.xml file provided with the source. If building with [Apache\n Ant](http://ant.apache.org/), follow the instructions given next (note that the code has been tested with Ant version 1.7.0; if you have an earlier version of Ant, you might need to upgrade)\n\n### Ant Build Instructions\n\n**1. Modify your build properties:**\n\n1. Navigate to the `build-src` subdirectory of your chosen installation directory.\n2. Using a text editor, open the `build.properties` file and make the following changes:\n - Edit the `servlet-api.jar` property to point to your `servlet-api.jar` file. For example, if you installed Tomcat to your `c:` drive in the `tomcat_home` directory, then you would specify the `servlet-api.jar` property as follows: \n `servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar`\n\n **Note**: Use forward slashes rather than\n backslashes in the file path, even when using Windows\n - To use your own copies of the dependencies described above, edit the paths in the same build.properties file.\n\n**2. Build the library:**\n\nNavigate the `build-src` subdirectory in the file and type one of the\nfollowing:\n\n- `ant datasource` - Builds the data source library\n- `ant example` - Builds the examples\n- `ant` - Builds both data source and examples\n- `ant test` - Builds and runs the data source library tests. Very useful when you are modifying the library.\n\nContributing to the Open Source\nProject\n---------------------------------------\n\nIf you want to contribute changes to the open source project, you'll have to get\nsubmission permissions to the project. Send an email to [google-visualization-api@googlegroups.com](mailto:google-visualization-api@googlegroups.com) asking\nfor permission and instructions on how to submit changes."]]
