апрель 2008 г.
Новый подключаемый модуль Java Client Eclipse API данных Google: создавайте проекты за считанные секунды
В качестве дополнения к этой статье доступен подключаемый модуль Eclipse для минимизации накладных расходов, связанных с настройкой зависимостей данных Google. Он также создает шаблонный код для взаимодействия с интересующим вас API. Это обеспечивает простой способ начать разработку с помощью API данных Google.
Введение
Eclipse — очень удобная (и бесплатная!) IDE, которая занимает особое место в сердцах многих Java-программистов. Поэтому неудивительно, что вы можете захотеть использовать его с клиентской библиотекой Java для создания потрясающего Java-приложения, которое работает с одним из API данных Google.
Настройка затмения
Если у вас еще не установлен Eclipse, вы многое упускаете. Eclipse может значительно упростить разработку Java благодаря своей способности предлагать исправления, находить отсутствующие импорты и использовать методы автозаполнения. Перейдите на страницу загрузок Eclipse.org, чтобы получить программу установки для вашей операционной системы. Чтобы запустить Eclipse, вам необходимо установить JRE, ссылку на которую можно найти на странице загрузок Eclipse. После установки Eclipse вам необходимо создать рабочее пространство. В этих примерах используется /usr/local/eclipse/workspace
.
Установка необходимых библиотек
Eclipse предоставляет множество функций Java из коробки, так что это должно быть легко. Прежде всего, скачайте последнюю версию клиентской библиотеки Java со страницы загрузки проекта. Обратите внимание, что есть две отдельные загрузки: одна для образцов и одна для исходного кода. Загрузите ZIP-файл с примерами, так как он включает в себя скомпилированные JAR-файлы клиентской библиотеки Java, необходимые для создания ваших собственных программ. Если вам интересно, как работает сама клиентская библиотека, вы можете скачать исходный zip и просмотреть его, но это выходит за рамки данной статьи. После того, как вы скачали zip-архив с примерами, разархивируйте файл в удобный каталог, где вы сможете найти файлы. В примерах используется /usr/local/eclipse
. Это означает, что файлы JAR для проекта теперь должны быть доступны в /usr/local/eclipse/gdata/java/lib
.
Теперь, когда вы установили клиентскую библиотеку, следующее, что нужно сделать, это загрузить некоторые внешние зависимости, чтобы мы могли включить их в путь сборки проекта. Файл INSTALL-samples.txt
содержит список необходимых вам jar-файлов и мест, откуда их можно загрузить. Текущий список:
Имя файла | Расположение |
---|---|
mail.jar | Sun JavaMail API |
активация.jar | Инфраструктура активации Sun JavaBeans |
сервлет-api.jar | Апач Томкэт |
В этом примере эти JAR-файлы загружаются и копируются в /usr/local/eclipse/gdata/third_party
.
Вау! Теперь у вас должно быть все необходимое для разработки приложения Java, использующего один из API данных Google. Читай дальше!
Создание нового приложения
Первый шаг — открыть Eclipse и выбрать «Создать > Проект Java» в меню «Файл».
![Окно нового проекта Eclipse](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata1.png?authuser=8&hl=ru)
Теперь нажмите «Далее» и выберите вкладку «Библиотеки». Добавьте все зависимые файлы JAR, которые вы загрузили, нажав «Добавить внешние JAR».
![Добавление JAR зависимостей](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata2.png?authuser=8&hl=ru)
Вам также придется добавить файлы JAR из клиентской библиотеки Java. Они расположены в подкаталоге java/lib
того места, куда вы распаковали клиентскую библиотеку. Вам всегда нужно будет включать следующие файлы JAR: gdata-client, gdata-client-meta, gdata-core и gdata-media.
![Добавление JAR-файлов GData](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata3.png?authuser=8&hl=ru)
Теперь выберите, какой API вы хотите использовать. В этом примере используется API списка документов Google. Для этого необходимо добавить соответствующие файлы JAR: gdata-docs и gdata-docs-meta.
![Добавление JAR-файлов DocList](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata4.png?authuser=8&hl=ru)
Наконец, вы можете нажать «Готово» и создать новый проект.
![Недавно созданный проект](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata5.png?authuser=8&hl=ru)
Чтобы создать простое тестовое приложение, создайте новый класс с основным методом, выбрав «Создать > Класс» в меню «Файл».
![Создание класса](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata6.png?authuser=8&hl=ru)
Теперь я собираюсь вставить код из Руководства разработчика для API списка документов .
![Пример кода с ошибками](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata7.png?authuser=8&hl=ru)
Вы увидите много ошибок, пока не добавите соответствующие операторы импорта. Eclipse делает это легко, все, что вам нужно сделать, это щелкнуть маркеры ошибок слева, чтобы открыть полезное меню, позволяющее добавить импорт.
![Меню быстрого исправления](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata8.png?authuser=8&hl=ru)
После того, как вы очистили импорт, вам также нужно обработать исключения, которые могут быть вызваны нашим кодом. В этом примере весь примерный код окружен очень примитивным обработчиком исключений.
![Рабочий пример кода](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata9.png?authuser=8&hl=ru)
Теперь, предполагая, что вы заменили имя пользователя и пароль действительной тестовой учетной записью, которую вы создали, вы сможете увидеть список документов, принадлежащих этой тестовой учетной записи, когда вы выберете «Выполнить» в меню «Выполнить».
![Вывод программы](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata10.png?authuser=8&hl=ru)
Ура!
Заключение
Теперь, когда у вас есть работающий экземпляр Eclipse и все необходимые JAR-файлы, вы уже на пути к созданию великолепного Java-приложения, которое работает с одним из API данных Google.
Куда пойти отсюда? Вот несколько ссылок, которые могут оказаться полезными:
- Подключаемый модуль Java-клиента Eclipse API данных Google
- Документация по протоколу данных Google на code.google.com
- Проект клиентской библиотеки Google Data Java
- Руководство по началу работы с клиентской библиотекой Java
- Документация по JavaDoc
Java является товарным знаком Sun Microsystems, Inc. в США и других странах.