апрель 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» в меню «Файл».
Теперь нажмите «Далее» и выберите вкладку «Библиотеки». Добавьте все зависимые файлы JAR, которые вы загрузили, нажав «Добавить внешние JAR».
Вам также придется добавить файлы JAR из клиентской библиотеки Java. Они расположены в подкаталоге java/lib того места, куда вы распаковали клиентскую библиотеку. Вам всегда нужно будет включать следующие файлы JAR: gdata-client, gdata-client-meta, gdata-core и gdata-media.
Теперь выберите, какой API вы хотите использовать. В этом примере используется API списка документов Google. Для этого необходимо добавить соответствующие файлы JAR: gdata-docs и gdata-docs-meta.
Наконец, вы можете нажать «Готово» и создать новый проект.
Чтобы создать простое тестовое приложение, создайте новый класс с основным методом, выбрав «Создать > Класс» в меню «Файл».
Теперь я собираюсь вставить код из Руководства разработчика для API списка документов .
Вы увидите много ошибок, пока не добавите соответствующие операторы импорта. Eclipse делает это легко, все, что вам нужно сделать, это щелкнуть маркеры ошибок слева, чтобы открыть полезное меню, позволяющее добавить импорт.
После того, как вы очистили импорт, вам также нужно обработать исключения, которые могут быть вызваны нашим кодом. В этом примере весь примерный код окружен очень примитивным обработчиком исключений.
Теперь, предполагая, что вы заменили имя пользователя и пароль действительной тестовой учетной записью, которую вы создали, вы сможете увидеть список документов, принадлежащих этой тестовой учетной записи, когда вы выберете «Выполнить» в меню «Выполнить».
Ура!
Заключение
Теперь, когда у вас есть работающий экземпляр Eclipse и все необходимые JAR-файлы, вы уже на пути к созданию великолепного Java-приложения, которое работает с одним из API данных Google.
Куда пойти отсюда? Вот несколько ссылок, которые могут оказаться полезными:
- Подключаемый модуль Java-клиента Eclipse API данных Google
- Документация по протоколу данных Google на code.google.com
- Проект клиентской библиотеки Google Data Java
- Руководство по началу работы с клиентской библиотекой Java
- Документация по JavaDoc
Java является товарным знаком Sun Microsystems, Inc. в США и других странах.