Instalowanie biblioteki Java źródła danych

Na tej stronie znajdują się informacje o tym, jak używać i modyfikować bibliotekę Java Google Wizualizacja w Javie oraz jak wziąć udział w tworzeniu kodu open source projektu.

Spis treści

  1. Wymagania
  2. Zależności
  3. Korzystanie z Biblioteki
  4. Przykłady
  5. Modyfikowanie biblioteki
  6. Udział w projekcie open source

Wymagania

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

Zależności

Biblioteka Java źródła danych ma poniższe zależności. Biblioteka została przetestowana z użyciem wymienionych wersji. Inne wersje mogą być dopuszczalne, ale nie zostały przetestowane.

Umieszczone w źródle lub pobranym pliku:

Nieuwzględnione w źródle lub pobranym pliku:

  • Aby używać klasy SqlDataSourceHelper z bazą danych mySQL, musisz też mieć mysql.jar w środowisku wykonawczym. Szczegóły i wersje do pobrania znajdziesz na stronie http://www.mysql.com/products/connector/j/.

Korzystanie z biblioteki w takiej postaci, w jakiej została udostępniona

W tej sekcji dowiesz się, jak korzystać z biblioteki Java do wizualizacji, jeśli nie musisz jej modyfikować. Ten proces różni się w zależności od systemu kompilacji:

Jeśli używasz narzędzia Maven, skonfiguruj zależność od biblioteki wizualizacji, korzystając z tych ustawień:

  • Identyfikator grupy: com.google.visualization
  • Identyfikator artefaktu: Wizualizacja-źródło danych
  • Numer wersji: użyj najnowszej wersji wymienionej na stronie projektu.

Jeśli używasz innego systemu kompilacji:

Uruchamianie przykładów

Przykładowe pliki JAR są dołączane do plików JAR biblioteki w pliku ZIP do pobrania. Instrukcje uruchamiania przykładów znajdziesz na stronie Pierwsze kroki.

Modyfikowanie biblioteki

Jeśli chcesz zmodyfikować kod biblioteki, musisz pobrać źródło z witryny hostującej typu open source i je utworzyć. Zanim to zrobisz, przeczytaj informacje o licencjach, do których link znajdziesz 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 > Płatność na stronie projektu open source.
  2. Budowanie kodu. Jeśli tworzysz kompilację w Maven, użyj pliku pom.xml dostarczonego ze źródłem. Jeśli tworzysz kompilację przy użyciu Apache Ant, postępuj zgodnie z podanymi niżej instrukcjami (pamiętaj, że kod został przetestowany z użyciem Ant w wersji 1.7.0 – jeśli masz starszą wersję Ant, konieczne może być uaktualnienie).

Instrukcje kompilacji Ant

1. Zmień właściwości kompilacji:

  1. Przejdź do podkatalogu build-src wybranego katalogu instalacji.
  2. Otwórz plik build.properties za pomocą edytora tekstu i wprowadź te zmiany:
    • Edytuj właściwość servlet-api.jar, aby wskazywała plik servlet-api.jar. Jeśli na przykład zainstalujesz program Tomcat na dysku c: w katalogu tomcat_home, określ właściwość servlet-api.jar w ten sposób:
      servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar

      Uwaga: w ścieżce pliku używaj ukośników zamiast ukośnika wstecznego, nawet w systemie Windows

    • Aby użyć własnych kopii zależności opisanych powyżej, zmodyfikuj ścieżki w tym samym pliku build.properties.

2. Budowanie biblioteki:

Przejdź do podkatalogu build-src w pliku i wpisz jedną z tych wartości:

  • ant datasource – tworzy bibliotekę źródeł danych.
  • ant example – tworzy przykłady.
  • ant – tworzy zarówno źródło danych, jak i przykłady
  • ant test – tworzy i uruchamia testy biblioteki źródeł danych. To bardzo przydatne podczas modyfikowania biblioteki.

Udział w projekcie open source

Jeśli chcesz przekazywać zmiany do projektu open source, musisz uzyskać do niego uprawnienia do przesyłania. Wyślij e-maila na adres google-visualization-api@googlegroups.com z prośbą o zgodę i instrukcje dotyczące wprowadzania zmian.