Shade in the Shade: Eclipse'i Google Veri API'leriyle kullanma

Jeff Fisher, Google Veri API'leri Ekibi
Nisan 2008

Yeni Google Veri API'ları Java Client Eclipse Eklentisi : Saniyeler içinde proje oluşturun

Bu makaleye ek olarak, Eclipse eklentisi ile Google Veri bağımlılıklarını ayarlamanın getirdiği ek yükü en aza indirebilirsiniz. Ayrıca, ilgilendiğiniz API'yle etkileşimde bulunmak için ortak metin kodu oluşturur. Bu sayede, Google Veri API'lerini geliştirmeye kolayca başlayabilirsiniz.


Giriş

Tutulma çok kullanışlı (ve ücretsiz!) Birçok Java programcısının kalbinde özel bir yeri bulunan IDE. Bu durumda, Google Veri API'lerinden biriyle çalışan etkileyici bir Java uygulaması oluşturmak için Java istemci kitaplığıyla birlikte kullanmak isteyebilirsiniz.

Eclipse kurulumu

Eclipse'i henüz yüklemediyseniz YouTube'un sunduğu avantajlardan yararlanıyorsunuzdur. Düzeltme önerme, eksik içe aktarma işlemlerini bulma ve otomatik tamamlama yöntemleri sayesinde Eclipse, Java geliştirme sürecini çok daha kolay hale getirebilir. İşletim sisteminizin yükleyicisini edinmek için Eclipse.org indirmeler sayfasına gidin. Eclipse'i çalıştırmak için Eclipse indirmeleri sayfasından bağlanan bir JRE yüklü olmalıdır. Eclipse'i yükledikten sonra bir çalışma alanı oluşturmanız gerekir. Bu örneklerde /usr/local/eclipse/workspace kullanılmıştır.

Gerekli kitaplıklar yükleniyor

Eclipse, kullanıma hazır birçok Java işlevi sağlar. Bu nedenle bu işlem kolayca yapılabilir. İlk olarak proje indirmeler sayfasından Java istemci kitaplığının en son sürümünü edinin. Biri örnekler, diğeri kaynak kodu için olmak üzere iki ayrı indirme işlemi olduğunu unutmayın. Örnek programlarınızı oluşturmak için gereken Java istemci kitaplığının derlenmiş JAR dosyalarını içerdiğinden, örnekleri ZIP dosyası olarak indirin. İstemci kitaplığının nasıl çalıştığını merak ediyorsanız kaynak zip dosyasını indirip bu reklama göz atabilirsiniz. Ancak bu makale bu makalenin kapsamı dışındadır. Örnekleri zip dosyası olarak indirdiğinizde, dosyaları bulabileceğiniz bir dizinde açın. Örnekler /usr/local/eclipse kullanır. Bu durumda, projenin JAR dosyalarına artık /usr/local/eclipse/gdata/java/lib bölümünden erişilebilir.

İstemci kitaplığını yüklediğinize göre sonraki adım, bunları proje derleme yoluna dahil edebilmemiz için bazı harici bağımlılıkları indirmektir. INSTALL-samples.txt dosyası, ihtiyacınız olan kavanozların ve bunları indirebileceğiniz konumların listesini içerir. Şu anki liste:

Dosya adı Konum
posta.jar Sun'un JavaMail API'si
aktivasyon.jar Sun'un JavaBeans Etkinleştirme Çerçevesi
servlet-api.jar Apache Tomcat

Bu örnekte, bu JAR dosyaları indirilir ve /usr/local/eclipse/gdata/third_party konumuna kopyalanır.

Sevindim! Şimdi, Google Data API'lerinden birini kullanan bir Java uygulaması geliştirmeye başlamak için ihtiyacınız olan her şeyi öğrendiniz. Devamını okuyun.

Yeni uygulama oluşturma

İlk adım Eclipse'i açmak ve Dosya menüsünden "Yeni > Java Projesi"ni seçmektir.

Yeni proje penceresini ayırma

Şimdi Sonraki'yi tıklayın ve Kitaplıklar sekmesini seçin. Harici JAR'ları Ekle'yi tıklayarak indirdiğiniz tüm bağımlı JAR dosyalarını ekleyin.

Bağımlılık yapan JAR'lar ekleme

JAR dosyalarını Java istemci kitaplığından da eklemeniz gerekir. İstemci kitaplığını çıkardığınız yerin java/lib alt dizininde bulunur. Şu JAR dosyalarını her zaman eklemeniz gerekir: gdata-client, gdata-client-meta, gdata-core ve gdata-media.

GData JAR'ları ekleme

Şimdi, kullanmak istediğiniz API'yi seçin. Bu örnekte Google Documents List API'sı kullanılmaktadır. Bunun için uygun JAR dosyalarının (gdata-docs ve gdata-docs-meta) eklenmesi gerekir.

Doküman Listesi JAR'ları Ekleme

Son olarak "Son"u tıklayıp yeni projenizi oluşturabilirsiniz.

Yeni oluşturulan proje

Basit bir test uygulaması oluşturmak için Dosya menüsünden "Yeni > Sınıf"ı seçerek ana yöntemle yeni bir sınıf oluşturun.

Sınıf oluşturma

Şimdi Dokümanlar Liste API'sı için Geliştirici Kılavuzu'ndaki bazı kodları yapıştıracağım.

Hatalı örnek kod

Uygun içe aktarma ifadelerini ekleyene kadar çok sayıda hata göreceksiniz. Eclipse bunu kolaylaştırır. Tek yapmanız gereken sol taraftaki hata işaretçilerini tıklayarak içe aktarma işlemleri eklemenize yardımcı olan kullanışlı bir menü oluşturmaktır.

Düzeltme menüsü

İçe aktarımları temizledikten sonra, kodumuz tarafından atılabilecek istisnaları da ele almanız gerekir. Örnekte, tüm örnek kodu çok ilkel bir istisna işleyiciyle çevrelemektedir.

Çalışma örnek kodu

Şimdi, kullanıcı adını ve şifreyi oluşturduğunuz geçerli bir test hesabıyla değiştirdiğiniz varsayıldığında, Çalıştır menüsünden "Çalıştır"ı seçtiğinizde söz konusu test hesabının sahip olduğu belgelerin listesini görebilmeniz gerekir.

Program çıkışı

Tebrikler!

Sonuç

Eclipse'in çalışan bir örneğini ve gerekli tüm JAR dosyalarını kullanmaya başladığınıza göre, Google Veri API'lerinden biriyle çalışan muhteşem bir Java uygulaması oluşturma yolunda ilerliyorsunuz.

Sonraki adımlar Yararlı bulabileceğiniz birkaç bağlantı var:

Java, ABD'de ve diğer ülkelerde Sun Microsystems, Inc.'in ticari markasıdır.