Pierwsze kroki ze źródłami danych

W tej sekcji przedstawiamy SimpleExampleServlet – najprostszą przykładową implementację źródła danych dostarczanego z biblioteką. W tej sekcji znajdziesz także szczegółowe instrukcje uruchamiania i testowania środowiska SimpleExampleServlet.

Przedstawiamy SimpleExampleServlet

Klasa SimpleExampleServlet znajduje się w pakiecie examples. Ta klasa zawiera przykład najprostszej implementacji źródła danych. Ustawienie SimpleExampleServlet dziedziczy z kontenera DataSourceServlet, implementuje metodę generateDataTable() i musi być uruchamiane w kontenerze serwletu.

Fragment kodu SimpleExampleServlet znajdziesz poniżej. Funkcja generateDataTable udostępnia dane w bibliotece. Ta funkcja tworzy opis tabeli danych, definiuje kolumny tabeli danych i uzupełnia tabelę danymi danymi. Biblioteka obsługuje wszystkie pozostałe działania niezbędne do przywrócenia tabeli danych do wizualizacji zapytań.

// 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;
  }
}

Uruchamianie i testowanie SimpleExampleServlet

W tej sekcji znajdziesz instrukcje dotyczące uruchamiania i testowania środowiska SimpleExampleServlet.

Informacje dotyczące wymagań wstępnych oraz instrukcje pobierania i kompilowania biblioteki znajdziesz w sekcji Instalacja. Jeśli nie masz jeszcze systemu serwletu, takiego jak Apache Tomcat, zainstaluj serwer WWW, jeśli jeszcze go nie masz w swoim systemie. Instrukcje w tej sekcji dotyczą Apache Tomcat w systemie Windows.

Aby uruchomić i przetestować SimpleExampleServlet, utwórz aplikację internetową, która będzie uruchamiała źródło danych SimpleExampleServlet, a następnie uruchom przykładową stronę internetową z wizualizacją danych, które są objęte zapytaniem ze źródła danych. Zostało to opisane w poniższych sekcjach:

Tworzenie aplikacji internetowej na serwerze Apache Tomcat

Aby utworzyć aplikację internetową na serwerze Apache Tomcat lub postępuj zgodnie z tymi instrukcjami, wykonaj poniższe instrukcje. Te instrukcje dotyczą Apache Tomcat w systemie Windows:

  1. Przejdź do katalogu, w którym zainstalowano Tomcat. Ten dokument jest zapisany w tym dokumencie jako <tomcat_home>.
     
  2. Przejdź do podkatalogu webapps.
     
  3. Utwórz podkatalog o nazwie myWebApp.
     
  4. Przejdź do właśnie utworzonego podkatalogu i utwórz kolejny podkatalog WEB-INF.
     
  5. Przejdź do podkatalogu WEB-INF i utwórz kolejny podkatalog lib.
    Pełna ścieżka powinna wyglądać tak: <tomcat_home>/webapps/myWebApp/WEB-INF/lib.
     
  6. Skopiuj web.xml z katalogu <data_source_library_install>/examples/src/html do katalogu WEB-INF. Gdzie <data_source_library_install> to katalog, w którym zainstalowano bibliotekę źródła danych. Te wiersze w web.xml definiują i mapują właściwość 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. Przejdź do katalogu, w którym zainstalowano bibliotekę źródła danych. Ten dokument jest zapisany jako <data_source_library_install>.
     
  8. Skopiuj wszystkie pakiety zależności do <tomcat_home>/webapps/myWebApp/WEB-INF/lib. Pakiety są instalowane w <data_source_library_install>/lib, chyba że umieścisz je w innym katalogu.
     
  9. Jeśli biblioteka została utworzona przez Ciebie, skopiuj visualization-datasource-1.0.2.jar i visualization-datasource-examples.jar
    z <data_source_library_install>/build
    do <tomcat_home>/webapps/myWebApp/WEB-INF/lib.

    Jeśli rozpakowano plik ZIP, skopiuj visualization-datasource-1.0.2.jar i visualization-datasource-examples.jar
    z <data_source_library_install>
    do <tomcat_home>/webapps/myWebApp/WEB-INF/lib.
    Pamiętaj, że numer wersji w nazwie pliku jar może się różnić w zależności od najnowszego numeru wersji.
  10. Uruchom program Tomcat lub uruchom ponownie Tomcata, jeśli jest już uruchomiony.
     
  11. Kliknij ten link:

    http://localhost:8080/myWebApp/simpleexample

    Ekran zawiera 6–7 wierszy tekstu (w zależności od szerokości ekranu).
    Tekst zaczyna się od google.visualization.Query.setResponse
    i kończy na /Tiger'},{v:80.0},{v:false}]}]}});

    To dane, które źródło zwraca na potrzeby wizualizacji zapytań.

Wizualizacja do wyświetlania danych

Plik getting_started.html w katalogu <data_source_library_install>/examples/src/html może służyć do wyświetlania wizualizacji danych. Poniższy wiersz, pochodzący z zasady getting_started.html, określa serwlet do użycia. Mapowanie serwletu zostało skonfigurowane w kroku 8 tworzenia aplikacji internetowej na serwerze Apache Tomcat.

var query = new google.visualization.Query('simpleexample');

Więcej informacji o tym, jak określić wizualizację i używać języka zapytania, znajdziesz w artykułach Korzystanie z wykresów i Informacje o języku zapytań.

Aby wyświetlić wizualizację danych dostarczonych przez źródło, wykonaj te instrukcje lub dostosuj je:

  1. Skopiuj plik getting_started.html z katalogu <data_source_library_install>/examples/src/html
    do katalogu <tomcat_home>/webapps/myWebApp/.
     
  2. Kliknij ten link http://localhost:8080/myWebApp/getting_started.html. Powinno ono pojawić się:



    To wszystko! Udało Ci się skonfigurować pierwsze źródło danych.

Następne kroki

Następny przykład znajdziesz w sekcji Korzystanie z zewnętrznego magazynu danych. Możesz też wrócić do wprowadzenia lub sprawdzić te linki: