Phần này giới thiệu SimpleExampleServlet
, đây là cách triển khai mẫu đơn giản nhất của nguồn dữ liệu được cung cấp cho thư viện. Phần này cũng cung cấp hướng dẫn từng bước về cách chạy và kiểm thử SimpleExampleServlet
.
Giới thiệu SimpleExampleServlet
Lớp SimpleExampleServlet
nằm trong gói examples
. Lớp này cung cấp ví dụ về cách triển khai đơn giản nhất của nguồn dữ liệu. SimpleExampleServlet
kế thừa từ DataSourceServlet
,
triển khai generateDataTable()
và phải chạy
trong vùng chứa GVP.
Đoạn mã SimpleExampleServlet
được cung cấp bên dưới. Hàm generateDataTable
hiển thị dữ liệu trong thư viện. Hàm này tạo một nội dung mô tả trong bảng dữ liệu, xác định các cột trong bảng dữ liệu và điền dữ liệu vào bảng dữ liệu.
Thư viện này xử lý mọi thao tác khác cần thiết để trả về bảng dữ liệu về hình ảnh trực quan truy vấn.
// This example extends DataSourceServlet public class SimpleExampleServlet extends DataSourceServlet { @Override public DataTable generateDataTable(Query query, HttpServletRequest request) { // Create a data table, DataTable data = new DataTable(); ArrayListcd = new ArrayList (); cd.add(new ColumnDescription("name", ValueType.TEXT, "Animal name")); cd.add(new ColumnDescription("link", ValueType.TEXT, "Link to wikipedia")); cd.add(new ColumnDescription("population", ValueType.NUMBER, "Population size")); cd.add(new ColumnDescription("vegeterian", ValueType.BOOLEAN, "Vegetarian?")); data.addColumns(cd); // Fill the data table. try { data.addRowFromValues("Aye-aye", "http://en.wikipedia.org/wiki/Aye-aye", 100, true); data.addRowFromValues("Sloth", "http://en.wikipedia.org/wiki/Sloth", 300, true); data.addRowFromValues("Leopard", "http://en.wikipedia.org/wiki/Leopard", 50, false); data.addRowFromValues("Tiger", "http://en.wikipedia.org/wiki/Tiger", 80, false); } catch (TypeMismatchException e) { System.out.println("Invalid type!"); } return data; } }
Chạy và thử nghiệm SimpleExampleServlet
Phần này cung cấp hướng dẫn về cách chạy và kiểm thử SimpleExampleServlet
.
Hãy xem phần Cài đặt để biết thông tin về các điều kiện tiên quyết và hướng dẫn về cách tải xuống và xây dựng thư viện nếu bạn chưa thực hiện việc này. Đảm bảo bạn cài đặt một máy chủ web cũng hoạt động như vùng chứa Carousel, chẳng hạn như Apache Tomcat, nếu bạn chưa có một hệ thống trên hệ thống của mình. Hướng dẫn trong phần này là dành riêng cho Apache Tomcat trên hệ thống Windows.
Để chạy và kiểm thử SimpleExampleServlet
, hãy tạo một ứng dụng web chạy nguồn dữ liệu SimpleExampleServlet
rồi chạy trang web mẫu với hình ảnh trực quan hoá dữ liệu được truy vấn từ nguồn dữ liệu. Nội dung này được mô tả trong các phần sau:
Tạo ứng dụng web trên Apache Tomcat
Làm theo hoặc điều chỉnh hướng dẫn dưới đây để tạo một ứng dụng web trên Apache Tomcat. Hướng dẫn dành riêng cho Apache Tomcat trên hệ thống Windows:
- Chuyển đến thư mục mà bạn đã cài đặt Tomcat. Nội dung này được viết
trong tài liệu này là
<tomcat_home>
.
- Chuyển đến thư mục con
webapps
.
- Tạo thư mục con có tên là
myWebApp
.
- Thay đổi đối với thư mục con bạn vừa tạo và tạo một thư mục con khác có tên là
WEB-INF
.
- Thay đổi sang thư mục con
WEB-INF
rồi tạo một thư mục con khác có tên làlib
.
Đường dẫn đầy đủ phải là<tomcat_home>/webapps/myWebApp/WEB-INF/lib
.
- Sao chép
web.xml
từ<data_source_library_install>/examples/src/html
vào thư mụcWEB-INF
. Trong đó<data_source_library_install>
là thư mục mà bạn đã cài đặt thư viện nguồn dữ liệu. Các dòng sau trongweb.xml
xác định và ánh xạSimpleExampleServlet
:
<servlet> <servlet-name>My Servlet</servlet-name> <description>My servlet description.</description> <servlet-class>SimpleExampleServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>My Servlet</servlet-name> <url-pattern>/simpleexample</url-pattern> </servlet-mapping>
- Chuyển đến thư mục mà bạn đã cài đặt thư viện nguồn dữ liệu.
Tài liệu này được viết trong tài liệu này là
<data_source_library_install>
.
- Sao chép tất cả các gói phụ thuộc
vào
<tomcat_home>/webapps/myWebApp/WEB-INF/lib
. Các gói được cài đặt trong<data_source_library_install>/lib
, trừ khi bạn đặt các gói đó trong một thư mục khác.
- Nếu bạn đã tự xây dựng thư viện, hãy sao chép
visualization-datasource-1.0.2.jar
vàvisualization-datasource-examples.jar
từ<data_source_library_install>/build
sang<tomcat_home>/webapps/myWebApp/WEB-INF/lib
.
Nếu bạn đã giải nén tệp zip, hãy sao chépvisualization-datasource-1.0.2.jar
vàvisualization-datasource-examples.jar
từ<data_source_library_install>
vào<tomcat_home>/webapps/myWebApp/WEB-INF/lib
.
Lưu ý rằng số phiên bản trong tên tệp jar có thể khác nhau tùy thuộc vào số phiên bản mới nhất. - Khởi động Tomcat hoặc khởi động lại Tomcat nếu nó đang chạy.
- Nhấp vào đường liên kết sau:
http://localhost:8080/myWebApp/Simpleexample
Màn hình sẽ hiển thị 6 – 7 dòng văn bản, tuỳ thuộc vào chiều rộng màn hình.
Văn bản bắt đầu bằnggoogle.visualization.Query.setResponse
và kết thúc bằng/Tiger'},{v:80.0},{v:false}]}]}});
Đây là dữ liệu mà nguồn dữ liệu của bạn trả về cho một hình ảnh trực quan truy vấn.
Sử dụng hình ảnh để xem dữ liệu
Bạn có thể dùng tệp getting_started.html
trong thư mục <data_source_library_install>/examples/src/html
để xem hình ảnh dữ liệu. Dòng sau đây, được lấy từ getting_started.html
, chỉ định Trình sử dụng tài khoản đó để sử dụng. Việc ánh xạ GVP được thiết lập ở bước 8 trong bài viết Tạo Ứng dụng web trên Apache Tomcat.
var query = new google.visualization.Query('simpleexample');
Để biết thêm thông tin về cách chỉ định hình ảnh và sử dụng ngôn ngữ truy vấn, xem nội dung Sử dụng biểu đồ và Tài liệu tham khảo về ngôn ngữ truy vấn.
Hãy làm theo hoặc điều chỉnh các hướng dẫn dưới đây để xem hình ảnh dữ liệu do nguồn dữ liệu cung cấp:
- Sao chép tệp
getting_started.html
từ thư mục<data_source_library_install>/examples/src/html
vào thư mục<tomcat_home>/webapps/myWebApp/
.
- Nhấp vào đường liên kết sau http://localhost:8080/myWebApp/getting_started.html,
bạn sẽ thấy như sau:
Đó là xong! Bạn đã thiết lập nguồn dữ liệu đầu tiên của mình.
Bước tiếp theo
Ví dụ tiếp theo được mô tả trong phần Sử dụng Kho dữ liệu bên ngoài. Ngoài ra, bạn có thể quay lại phần Giới thiệu hoặc khám phá các đường liên kết sau:
- Để biết thông tin giới thiệu về các lớp được sử dụng phổ biến nhất của thư viện, hãy xem Lớp chính.
- Để biết ví dụ về cách triển khai luồng sự kiện của riêng bạn và các khả năng truy vấn, hãy xem phần Xác định khả năng và luồng sự kiện.
- Nếu không muốn kế thừa từ
DataSourceServlet
, bạn có thể triển khai một nguồn dữ liệu như mô tả trong phần Sử dụng dịch vụ của riêng bạn. Ví dụ: bạn có thể không muốn kế thừa nhồi bông từDataSourceServlet
nếu kế thừa GVP từ một lớp khác. - Nếu bạn không muốn sử dụng GVP, hãy xem phần Triển khai nguồn dữ liệu không phải GVP.
- Để tìm hiểu cách truyền tham số từ một ứng dụng đến nguồn dữ liệu, hãy xem bài viết Truyền tham số đến
DataTableGenerator.generateDataTable
.