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(); 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; } }
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:
- Przejdź do katalogu, w którym zainstalowano Tomcat. Ten dokument jest zapisany w tym dokumencie jako
<tomcat_home>
.
- Przejdź do podkatalogu
webapps
.
- Utwórz podkatalog o nazwie
myWebApp
.
- Przejdź do właśnie utworzonego podkatalogu i utwórz kolejny podkatalog
WEB-INF
.
- Przejdź do podkatalogu
WEB-INF
i utwórz kolejny podkataloglib
.
Pełna ścieżka powinna wyglądać tak:<tomcat_home>/webapps/myWebApp/WEB-INF/lib
.
- Skopiuj
web.xml
z katalogu<data_source_library_install>/examples/src/html
do kataloguWEB-INF
. Gdzie<data_source_library_install>
to katalog, w którym zainstalowano bibliotekę źródła danych. Te wiersze wweb.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>
- Przejdź do katalogu, w którym zainstalowano bibliotekę źródła danych.
Ten dokument jest zapisany jako
<data_source_library_install>
.
- 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.
- Jeśli biblioteka została utworzona przez Ciebie, skopiuj
visualization-datasource-1.0.2.jar
ivisualization-datasource-examples.jar
z<data_source_library_install>/build
do<tomcat_home>/webapps/myWebApp/WEB-INF/lib
.
Jeśli rozpakowano plik ZIP, skopiujvisualization-datasource-1.0.2.jar
ivisualization-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. - Uruchom program Tomcat lub uruchom ponownie Tomcata, jeśli jest już uruchomiony.
- 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ę odgoogle.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:
- Skopiuj plik
getting_started.html
z katalogu<data_source_library_install>/examples/src/html
do katalogu<tomcat_home>/webapps/myWebApp/
.
- 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:
- Wprowadzenie do najczęściej używanych zajęć w bibliotece znajdziesz w artykule Najważniejsze zajęcia.
- Przykład implementacji własnego przepływu zdarzeń i funkcji zapytań znajdziesz w artykule Definiowanie możliwości i przepływ zdarzeń.
- Jeśli nie chcesz dziedziczyć źródła z zasobu
DataSourceServlet
, możesz zaimplementować źródło danych w sposób opisany w artykule Korzystanie z własnego serwletu. Na przykład możesz nie chcieć dziedziczyć elementuDataSourceServlet
, jeśli dziedziczysz serwlet z innej klasy. - Jeśli nie chcesz korzystać ze serwletu, zapoznaj się z artykułem Implementowanie źródła danych bez obsługi serwletu.
- Aby dowiedzieć się, jak przekazywać parametry z aplikacji do źródła danych, zapoznaj się z artykułem Przekazywanie parametrów do
DataTableGenerator.generateDataTable
.