Instalowanie biblioteki Java źródła danych

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

  1. Wymagania
  2. Zależności
  3. Jak korzystać z Biblioteki jako udostępnionej
  4. Przykłady
  5. Modyfikowanie biblioteki
  6. Udział w projekcie open source

Wymagania

Aby korzystać z biblioteki Java Google wizualizacji, musisz mieć:

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:

Nieuwzględnione w źródle ani nie pobrane:

  • Aby używać klasy SqlDataSourceHelper w bazie danych mySQL, potrzebujesz też środowiska mysql.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:

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ę:

  1. Pobierz kod źródłowy za pomocą SVN, zgodnie z opisem na karcie Źródło > Checkout na stronie projektu typu open source.
  2. 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:

  1. Przejdź do podkatalogu build-src wybranego katalogu instalacji.
  2. W edytorze tekstu otwórz plik build.properties i wprowadź te zmiany:
    • Zmień właściwość servlet-api.jar, aby wskazywała plik servlet-api.jar. Jeśli na przykład zainstalowano Tomcata na dysku c: w katalogu tomcat_home, właściwości servlet-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.

2. Utwórz bibliotekę:

Przejdź do podkatalogu build-src i wpisz jeden z tych adresów:

  • ant datasource – tworzy bibliotekę źródeł danych
  • ant example – przykłady
  • ant – 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.