Z tego artykułu dowiesz się, jak korzystać z biblioteki Java wizualizacji Google oraz jak z niej korzystać i jak dodawać treści do kodu open source projektu.
Spis treści
Wymagania
Aby korzystać z biblioteki Java Google wizualizacji, musisz mieć:
- Kontener serwletu i interfejs API Servlet w wersji 2.4 lub nowszej. Jednym z najczęściej używanych kontenerów serwletu jest Apache Tomcat, który zawiera interfejs API Servlet. Wejdź na http://tomcat.apache.org/download-55.cgi, aby pobrać plik binarny w wersji 5.5. Musisz zainstalować tylko moduł podstawowy. Oprócz tego Tomcat musi wykonać te sekcje samouczka: Pierwsze kroki, Korzystanie z zewnętrznego magazynu danych oraz Definiowanie możliwości i przepływu zdarzeń.
- Pakiet Java Development Kit w wersji 6.0 lub nowszej.
Uwaga: możesz też użyć pakietu JDK w wersji 5.0. Musisz jednak usunąć właściwość
@Override
z każdej metody w bibliotece, która zastępuje metodę interfejsu. Wynika to ze zmiany sposobu działania adnotacji@Override
w JDK w wersji 6.0.
Zależności
Biblioteka Java źródła danych ma następujące zależności. Biblioteka została przetestowana z wymienionymi wersjami. Inne wersje mogą być akceptowalne, ale nie zostały przetestowane.
Źródło lub pobrane:
- icu4j w wersji 4.0.1.
- Jakartacommons lang w wersji 2.4.
- Jakarta wspólny plik danych w wersji 1.1.1.
- Biblioteka Google Collection w wersji 1.0.
- javacc w wersji 4.2. Jest to wymagane tylko wtedy, gdy chcesz skompilować biblioteki, np. gdy modyfikujesz je zgodnie z instrukcjami podanymi poniżej.
- opencsv w wersji 1.8. Jest to wymagane tylko wtedy, gdy chcesz użyć źródła danych CSV.
Nieuwzględnione w źródle ani nie pobrane:
- Aby używać klasy
SqlDataSourceHelper
w bazie danych mySQL, potrzebujesz też środowiskamysql.jar
w środowisku wykonawczym. Więcej informacji i wersje do pobrania znajdziesz na http://www.mysql.com/products/connector/j/.
Korzystanie z Biblioteki jako udostępnionej
W tej sekcji dowiesz się, jak korzystać z wizualizacji w bibliotece Java, jeśli nie musisz jej modyfikować. Ten proces różni się w zależności od systemu kompilacji:
Jeśli używasz Maven, skonfiguruj zależność od biblioteki wizualizacji przy użyciu tych ustawień:
- Identyfikator grupy: com.google.visualization
- Identyfikator artefaktu: source-datasource
- Numer wersji: użyj najnowszego numeru wersji wymienionego na stronie projektu.
Jeśli korzystasz z innego systemu kompilacji:
- Pobierz plik ZIP biblioteki ze strony projektu, rozpakuj je i uwzględnij w projekcie zgodnie z wymaganiami systemu kompilacji.
Uruchamianie przykładów
Przykładowe pliki JAR są dołączone do plików JAR biblioteki w pliku ZIP do pobrania. Instrukcje wyświetlania przykładów znajdziesz na stronie Pierwsze kroki.
Modyfikowanie biblioteki
Jeśli chcesz zmodyfikować kod biblioteki, musisz pobrać źródło z witryny hostingowej typu open source i utworzyć kompilację. Zanim to zrobisz, zapoznaj się z informacjami o licencji, do których link znajduje się w sekcji „Licencja kodu” na stronie projektu, aby sprawdzić, czy Twój przypadek użycia jest dozwolony.
Aby pobrać i utworzyć bibliotekę:
- Pobierz kod źródłowy za pomocą SVN, zgodnie z opisem na karcie Źródło > Checkout na stronie projektu typu open source.
- Utwórz kod. W przypadku tworzenia witryny w Maven użyj pliku pom.xml dostarczonego wraz ze źródłem. Jeśli kompilujesz za pomocą Apache Ant, postępuj zgodnie z instrukcjami podanymi poniżej (pamiętaj, że kod został przetestowany za pomocą Ant w wersji 1.7.0; jeśli masz starszą wersję Ant, konieczne może być uaktualnienie).
Instrukcje dotyczące tworzenia mrówek
1. Zmodyfikuj właściwości kompilacji:
- Przejdź do podkatalogu
build-src
wybranego katalogu instalacji. - W edytorze tekstu otwórz plik
build.properties
i wprowadź te zmiany:- Zmień właściwość
servlet-api.jar
, aby wskazywała plikservlet-api.jar
. Jeśli na przykład zainstalowano Tomcata na dyskuc:
w katalogutomcat_home
, właściwościservlet-api.jar
należy podać w ten sposób:servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar
Uwaga: w pliku pliku używaj ukośników prawych zamiast ukośników, nawet w systemie Windows.
- Aby użyć własnych kopii zależności wymienionych powyżej, zmień ścieżki w tym samym pliku build.property.
- Zmień właściwość
2. Utwórz bibliotekę:
Przejdź do podkatalogu build-src
i wpisz jeden z tych adresów:
ant datasource
– tworzy bibliotekę źródeł danychant example
– przykładyant
– tworzy zarówno źródło danych, jak i przykłady.ant test
– tworzy i przeprowadza testy w bibliotece źródeł danych. Bardzo przydatna podczas modyfikowania biblioteki.
Udział w projekcie open source
Jeśli chcesz wprowadzić zmiany w projekcie open source, musisz mieć uprawnienia do przesyłania projektu. Wyślij e-maila na adres google-visualization-api@googlegroups.com z prośbą o pozwolenie oraz instrukcje dotyczące przesyłania zmian.