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

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

Содержание

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

Требования

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

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

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

Зависимости

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

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

• icu4j версии 4.0.1.
• Язык Jakarta Commons, версия 2.4.
• Версия журнала Jakarta Commons 1.1.1.
• Библиотека коллекций Google версии 1.0.
• javacc версии 4.2. Это требуется только в том случае, если вы собираетесь скомпилировать библиотеки, например, при их изменении, как описано ниже .
• opencsv версии 1.8. Это необходимо только в том случае, если вы собираетесь использовать источник данных CSV.

Не включено в исходный код или загрузку:

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

Использование библиотеки в том виде, в каком она предоставлена

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

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

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

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

• Загрузите ZIP-файл библиотеки со страницы проекта, разархивируйте файлы и включите их в свой проект, как того требует ваша система сборки.

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

Файлы примеров 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 — строит и запускает тесты библиотеки источников данных. Очень полезно при изменении библиотеки.

Вклад в проект с открытым исходным кодом

Если вы хотите внести изменения в проект с открытым исходным кодом, вам необходимо получить разрешения на отправку проекта. Отправьте электронное письмо на адрес [e-mail] с просьбой предоставить разрешение и инструкции по отправке изменений.