Coding di Shade: Menggunakan Eclipse dengan Google Data API

Jeff Fisher, Tim Google Data API
April 2008

Baru Plugin Data Google Java Client Eclipse : Buat project dalam hitungan detik

Sebagai pelengkap artikel ini, plugin Eclipse tersedia untuk meminimalkan overhead yang diperlukan dalam menyiapkan dependensi Data Google. API ini juga membuat kode boilerplate untuk berinteraksi dengan API yang Anda minati. Dengan cara ini, Anda dapat mulai mengembangkan dengan mudah menggunakan Google Data API.


Pengantar

Eclipse sangat praktis (dan gratis) IDE yang memiliki tempat khusus di hati banyak programmer Java. Tidaklah mengherankan jika Anda mungkin ingin menggunakannya dengan library klien Java untuk membuat aplikasi Java tepat yang berfungsi dengan salah satu Google Data API.

Menyiapkan Eclipse

Jika Anda belum menginstal Eclipse, berarti Anda mungkin masih ketinggalan. Eclipse dapat membuat pengembangan Java jauh lebih mudah, karena kemampuannya untuk menyarankan perbaikan, menemukan impor yang hilang, dan metode pelengkapan otomatis. Buka halaman download Eclipse.org untuk mendapatkan penginstal bagi sistem operasi Anda. Untuk menjalankan Eclipse, Anda harus menginstal JRE, yang tertaut dari halaman download Eclipse. Setelah menginstal Eclipse, Anda harus membuat ruang kerja. Contoh ini menggunakan /usr/local/eclipse/workspace.

Menginstal library yang diperlukan

Eclipse menyediakan banyak fungsionalitas Java secara langsung, sehingga ini akan mudah. Pertama-tama, ambil library klien Java versi terbaru dari halaman download project. Perhatikan bahwa ada dua download terpisah: satu untuk contoh dan satu untuk kode sumber. Download zip contoh, karena file tersebut mencakup file JAR yang dikompilasi dari library klien Java yang diperlukan untuk membuat program Anda sendiri. Jika ingin tahu cara kerja library klien itu sendiri, Anda dapat mendownload zip sumber dan mempelajarinya, tetapi hal itu berada di luar cakupan artikel ini. Setelah Anda mendownload sampel zip, ekstrak file ke direktori yang mudah untuk menemukan file tersebut. Contoh ini menggunakan /usr/local/eclipse. Ini berarti file JAR untuk project sekarang dapat diakses di /usr/local/eclipse/gdata/java/lib.

Setelah Anda menginstal library klien, hal berikutnya yang harus dilakukan adalah mendownload beberapa dependensi eksternal sehingga kita dapat menyertakannya dalam jalur build project. File INSTALL-samples.txt berisi daftar jar yang akan Anda butuhkan dan lokasi untuk mendownloadnya. Daftar saat ini adalah:

Nama file Lokasi
mail.jar JavaMail API milik Sun
aktivasi.jar Framework Aktivasi JavaBeans Sun
servlet-api.jar Apache Tomcat

Dalam contoh ini, file JAR ini didownload dan disalin ke /usr/local/eclipse/gdata/third_party.

Baguslah! Sekarang Anda telah memiliki semua bagian yang diperlukan untuk mulai mengembangkan aplikasi Java yang menggunakan salah satu Google Data API. Lanjutkan membaca!

Membuat aplikasi baru

Langkah pertama adalah membuka Eclipse dan memilih "New > Java Project" dari menu File.

Jendela project baru Eclipse

Sekarang klik Berikutnya dan pilih tab Library. Tambahkan semua file JAR dependen yang Anda download dengan mengklik Tambahkan JAR Eksternal.

Menambahkan JAR dependensi

Anda juga harus menambahkan file JAR dari library klien Java. File tersebut berada di subdirektori java/lib, tempat Anda mengekstrak library klien. Anda selalu harus menyertakan file JAR berikut: gdata-client, gdata-client-meta, gdata-core, dan gdata-media.

Menambahkan JAR GData

Sekarang pilih API yang ingin Anda gunakan. Contoh ini menggunakan Google Docs List API. Untuk melakukannya, Anda perlu menambahkan file JAR yang sesuai: gdata-docs dan gdata-docs-meta.

Menambahkan JAR DocList

Terakhir, Anda dapat mengklik "Finish" dan membuat project baru.

Project yang baru dibuat

Untuk membuat aplikasi pengujian sederhana, buat class baru dengan metode utama dengan memilih "New > Class" dari menu File.

Membuat kelas

Sekarang saya akan menempelkan beberapa kode dari Panduan Developer untuk API Daftar Dokumen.

Kode contoh dengan error

Anda akan melihat banyak error sampai Anda menambahkan pernyataan impor yang sesuai. Eclipse memudahkan proses ini. Anda hanya perlu mengklik penanda error di sebelah kiri untuk mendapatkan menu bermanfaat yang memungkinkan Anda menambahkan impor.

Menu Quickfix

Setelah menghapus impor, Anda juga harus menangani pengecualian yang dapat ditampilkan oleh kode. Contoh ini memilih untuk mengelilingi seluruh kode contoh dengan pengendali pengecualian yang sangat dasar.

Kode contoh yang berfungsi

Sekarang, dengan asumsi Anda mengganti nama pengguna dan sandi dengan akun pengujian valid yang telah Anda buat, Anda akan dapat melihat daftar dokumen yang dimiliki oleh akun pengujian tersebut saat memilih "Run" dari menu Run.

Output program

Hore!

Kesimpulan

Setelah Anda memiliki instance Eclipse yang berfungsi dan semua file JAR yang diperlukan, Anda siap mem-build aplikasi Java yang keren dan kompatibel dengan salah satu Google Data API.

Apa yang harus dilakukan dari sini? Ada beberapa link yang mungkin berguna bagi Anda:

Java adalah merek dagang Sun Microsystems, Inc. di Amerika Serikat dan negara lainnya.