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

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

Содержание

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

Требования

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

Зависимости

Библиотека 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, возможно, вам придется обновить ее).

Инструкции по сборке муравья

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 с просьбой предоставить разрешение и инструкции по отправке изменений.