Bắt đầu sử dụng Nguồn dữ liệu

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();
    ArrayList cd = 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:

  1. 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>.
     
  2. Chuyển đến thư mục con webapps.
     
  3. Tạo thư mục con có tên là myWebApp.
     
  4. 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.
     
  5. 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.
     
  6. Sao chép web.xml từ <data_source_library_install>/examples/src/html vào thư mục WEB-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 trong web.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>
  7. 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>.
     
  8. 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.
     
  9. 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ép visualization-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.
  10. Khởi động Tomcat hoặc khởi động lại Tomcat nếu nó đang chạy.
     
  11. 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ằng google.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:

  1. 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/.
     
  2. 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: