Установка библиотеки Java источника данных

На этой странице описывается, как использовать или изменять библиотеку Java для визуализаций Google и как внести свой вклад в открытый исходный код проекта.

Содержание

  1. Требования
  2. Зависимости
  3. Использование библиотеки по назначению
  4. Запуск примеров
  5. Изменение библиотеки
  6. Участие в проекте с открытым исходным кодом

Требования

Для использования библиотеки Google Visualization Java необходимы следующие компоненты:

  • Контейнер сервлетов и API сервлетов версии 2.4 или выше. Одним из наиболее часто используемых контейнеров сервлетов является Apache Tomcat, который включает в себя Servlet API. См. http://tomcat.apache.org/download-55.cgi , чтобы загрузить двоичный файл для версии 5.5. Вам нужно установить только основной модуль. Вам также потребуется Tomcat для выполнения разделов руководства: Начало работы , Использование внешнего хранилища данных и Определение возможностей и потока событий .
  • Java Development Kit версии 6.0 или более поздней.

    Примечание . Также можно использовать JDK версии 5.0. Однако затем вы должны удалить @Override из каждого метода в библиотеке, который переопределяет метод интерфейса. Это связано с изменением поведения аннотации @Override в JDK версии 6.0.

Зависимости

Библиотека Java источника данных имеет следующие зависимости. Библиотека тестировалась с перечисленными версиями; другие версии могут быть приемлемыми, но они не тестировались.

Входит в исходный код или загружается:

Не включено в источник или загрузку:

  • Чтобы использовать класс SqlDataSourceHelper с базой данных mySQL, вам также потребуется mysql.jar в среде выполнения. См. http://www.mysql.com/products/connector/j/ для получения подробной информации и загружаемых версий.

Использование библиотеки по назначению

В этом разделе описывается, как использовать библиотеку Java для визуализации, если вам не нужно ее модифицировать. Этот процесс зависит от вашей системы сборки:

При использовании Maven установите зависимость от библиотеки визуализации со следующими параметрами:

  • Идентификатор группы: com.google.visualization
  • Идентификатор артефакта: визуализация-источник данных
  • Номер версии: используйте последний номер версии, указанный на странице проекта .

При использовании любой другой системы сборки :

Запуск примеров

Файлы примеров JAR включены вместе с JAR-файлами библиотек в загружаемый ZIP-файл . Инструкции по запуску примеров приведены на странице « Начало работы ».

Изменение библиотеки

Если вы хотите изменить код библиотеки, вам придется загрузить исходный код с сайта хостинга с открытым исходным кодом и собрать его. Прежде чем сделать это, прочитайте информацию о лицензировании, указанную в разделе «Лицензия на код» на странице проекта, чтобы узнать, разрешен ли ваш вариант использования.

Вот шаги для загрузки и создания библиотеки:

  1. Загрузите исходный код с помощью SVN, как описано на вкладке « Источник» > «Извлечь » на странице проекта с открытым исходным кодом .
  2. Создайте свой код. При сборке в Maven используйте файл pom.xml, поставляемый с исходным кодом. При сборке с помощью Apache Ant следуйте приведенным ниже инструкциям (обратите внимание, что код был протестирован с версией Ant 1.7.0; если у вас более ранняя версия Ant, вам может потребоваться обновление).

Инструкции по сборке Ant

1. Измените свойства сборки:

  1. Перейдите в подкаталог build-src выбранного вами каталога установки.
  2. С помощью текстового редактора откройте файл build.properties и внесите следующие изменения:
    • Измените свойство servlet-api.jar , чтобы оно указывало на ваш файл servlet-api.jar . Например, если вы установили Tomcat на свой диск c: в каталог tomcat_home , вы должны указать свойство servlet-api.jar следующим образом:
      servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar

      Примечание . Используйте прямую косую черту, а не обратную косую черту в пути к файлу, даже при использовании Windows.

    • Чтобы использовать собственные копии описанных выше зависимостей, отредактируйте пути в том же файле build.properties.

2. Соберите библиотеку:

Перейдите в подкаталог build-src в файле и введите одно из следующего:

  • ant datasource — создает библиотеку источников данных
  • ant example — строит примеры
  • ant — строит как источник данных, так и примеры
  • ant test — создает и запускает тесты библиотеки источников данных. Очень полезно, когда вы модифицируете библиотеку.

Участие в проекте с открытым исходным кодом

Если вы хотите внести изменения в проект с открытым исходным кодом, вам необходимо получить разрешение на отправку в проект. Отправьте электронное письмо на адрес google-visualization-api@googlegroups.com с запросом разрешения и инструкциями по внесению изменений.