На этой странице описывается, как использовать или изменять библиотеку Java для визуализации Google, а также как внести свой вклад в открытый исходный код проекта.
Содержание
Требования
Для использования библиотеки 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-файл . Инструкции по запуску примеров приведены на странице «Начало работы» .
Изменение библиотеки
Если вы хотите изменить код библиотеки, вам придется загрузить исходный код с сайта хостинга с открытым исходным кодом и собрать его. Прежде чем сделать это, прочтите информацию о лицензировании, указанную в разделе «Лицензия на код» на странице проекта, чтобы узнать, разрешен ли ваш вариант использования.
Вот шаги для загрузки и сборки библиотеки:
- Загрузите исходный код с помощью SVN, как описано на вкладке «Источник» > «Оформить заказ» на странице проекта с открытым исходным кодом .
- Создайте свой код. При сборке в Maven используйте файл pom.xml, прилагаемый к исходному коду. При сборке с помощью Apache Ant следуйте инструкциям, приведенным ниже (обратите внимание, что код был протестирован с использованием Ant версии 1.7.0; если у вас более ранняя версия Ant, возможно, вам придется обновить ее).
Инструкции по сборке муравья
1. Измените свойства сборки:
- Перейдите в подкаталог
build-src
выбранного вами каталога установки. - С помощью текстового редактора откройте файл
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 с просьбой предоставить разрешение и инструкции по отправке изменений.