Kwiecień 2008 r.
- Wprowadzenie
- Konfigurowanie Eclipse
- Instalowanie wymaganych bibliotek
- Tworzenie nowej aplikacji
- Podsumowanie
Nowość Wtyczka Java Client Eclipse wtyczki Google Data API : twórz projekty w kilka sekund
Oprócz tego artykułu dostępna jest wtyczka Eclipse, która minimalizuje nakład pracy związany z konfigurowaniem zależności danych Google. Tworzy też powtarzalny kod do interakcji z interfejsem API, który Cię interesuje. Dzięki temu można łatwo zacząć korzystać z interfejsów Google Data API.
- Film instruktażowy
- Pobierz
- Instalowanie wtyczki
- Rozpoczynanie nowego projektu interfejsu Google Data API
Wprowadzenie
Zaćmienie jest bardzo przydatne (i bezpłatne!) IDE, które ma specjalne miejsce w sercach wielu programistów Java. Nic więc dziwnego, że warto wykorzystać go w bibliotece klienta Java do utworzenia niesamowitej aplikacji w języku Java, która współpracuje z jednym z interfejsów API danych Google.
Konfigurowanie Eclipse
Nie masz jeszcze zainstalowanego programu Eclipse Możliwość tworzenia javy znacznie ułatwia programowanie w języku Java ze względu na możliwość sugerowania poprawek, znajdowania brakujących importów i automatycznego uzupełniania. Wejdź na stronę pobierania Eclipse.org, aby pobrać instalator na Twój system operacyjny. Aby uruchomić Eclipse, musisz zainstalować JRE, do którego link znajdziesz na stronie pobierania Eclipse. Po zainstalowaniu Eclipse musisz utworzyć obszar roboczy. W tych przykładach użyto /usr/local/eclipse/workspace.
Instalowanie wymaganych bibliotek
Eclipse od razu udostępnia wiele funkcji Java, więc nie powinno tak być. Zacznij od pobrania najnowszej wersji biblioteki klienta w języku Java ze strony pobierania projektu. Pamiętaj, że masz 2 osobne pliki do pobrania – jeden z przykładami, a drugi – z kodu źródłowego. Pobierz przykładowy plik ZIP, ponieważ zawiera on skompilowany plik JAR biblioteki klienta w języku Java wymagany do utworzenia własnych programów. Jeśli chcesz się dowiedzieć, jak działa biblioteka klienta, możesz pobrać źródłowy plik ZIP i przejrzeć go poza zakresem, ale nie jest to częścią tego artykułu. Po pobraniu przykładowych plików ZIP rozpakuj je do wygodnego katalogu, w którym znajdziesz pliki. W przykładach użyto właściwości /usr/local/eclipse. Oznacza to, że pliki JAR w tym projekcie powinny być teraz dostępne w lokalizacji /usr/local/eclipse/gdata/java/lib.
Gdy masz już zainstalowaną bibliotekę klienta, pobierz teraz zależności zewnętrzne, abyśmy mogli uwzględnić je w ścieżce kompilacji projektu. Plik INSTALL-samples.txt zawiera listę plików jar, których potrzebujesz, oraz lokalizacje, z których chcesz je pobrać. Obecna lista:
| Nazwa pliku | Lokalizacja |
|---|---|
| poczta.jar | Sun's JavaMail API |
| aktywację.jar | Schemat aktywacji środowiska JavaBeans |
| serwlet-api.jar | Apache Tomcat |
W tym przykładzie te pliki JAR są pobierane i kopiowane do /usr/local/eclipse/gdata/third_party.
Uff! Teraz masz wszystko, czego potrzebujesz, aby rozpocząć tworzenie aplikacji w Javie używającej jednego z interfejsów API danych Google. Czytaj dalej!
Tworzenie nowej aplikacji
Najpierw otwórz Eclipse i z menu Plik wybierz „Nowy > Projekt Java”.
Kliknij Dalej i wybierz kartę Biblioteki. Dodaj wszystkie zależne pliki JAR pobrane przez kliknięcie Dodaj zewnętrzne pliki JAR.
Musisz też dodać pliki JAR z biblioteki klienta w języku Java. Znajdują się one w podkatalogu java/lib, z którego wyodrębniono bibliotekę klienta. Zawsze musisz uwzględnić te pliki JAR: gdata-client, gdata-client-meta, gdata-core oraz gdata-media.
Wybierz interfejs API, którego chcesz używać. W tym przykładzie wykorzystano interfejs Google Documents List API. Wymaga to dodania odpowiednich plików JAR: gdata-docs i gdata-docs-meta.
Na koniec możesz kliknąć „Zakończ” i utworzyć nowy projekt.
Aby utworzyć prostą aplikację testową, utwórz nową klasę za pomocą głównej metody, wybierając „Nowa > Klasa” z menu Plik.
Wkleję teraz fragment kodu z Przewodnika po interfejsie API dla programistów.
Dopóki nie dodasz odpowiednich instrukcji importu, będzie pojawiać się wiele błędów. Dzięki Eclipse wystarczy kliknąć znaczniki błędów po lewej stronie i otworzyć przydatne menu, które umożliwi dodawanie importów.
Po wyczyszczeniu importów musisz też obsługiwać wyjątki, które mogą zostać zgłoszone przez nasz kod. Przykład otaczający cały przykładowy kod zawiera bardzo podstawowy element obsługi wyjątku.
Teraz, przy założeniu, że zastąpisz nazwę użytkownika i hasło prawidłowym utworzonym kontem testowym, po wybraniu w menu „Uruchom” powinno być możliwe wyświetlenie listy dokumentów należących do tego konta testowego.
Świetnie.
Podsumowanie
Masz już działającą instancję Eclipse i wszystkie wymagane pliki JAR, więc możesz zacząć tworzyć świetną aplikację w Javie, która współpracuje z jednym z interfejsów API danych Google.
Co dalej? Kilka przydatnych linków:
- Wtyczka Java Data Eclipse dla klienta Google Data API
- Dokumentacja protokołu danych Google na stronie code.google.com
- Projekt biblioteki klienta Java Google Data
- Przewodnik dla początkujących dotyczący biblioteki klienta w języku Java
- Dokumentacja języka JavaDoc
Java jest znakiem towarowym firmy Sun Microsystems, Inc. w Stanach Zjednoczonych i innych krajach.