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](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata1.png?authuser=7&hl=id)
Sekarang klik Berikutnya dan pilih tab Library. Tambahkan semua file JAR dependen yang Anda download dengan mengklik Tambahkan JAR Eksternal.
![Menambahkan JAR dependensi](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata2.png?authuser=7&hl=id)
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](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata3.png?authuser=7&hl=id)
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](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata4.png?authuser=7&hl=id)
Terakhir, Anda dapat mengklik "Finish" dan membuat project baru.
![Project yang baru dibuat](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata5.png?authuser=7&hl=id)
Untuk membuat aplikasi pengujian sederhana, buat class baru dengan metode utama dengan memilih "New > Class" dari menu File.
![Membuat kelas](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata6.png?authuser=7&hl=id)
Sekarang saya akan menempelkan beberapa kode dari Panduan Developer untuk API Daftar Dokumen.
![Kode contoh dengan error](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata7.png?authuser=7&hl=id)
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](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata8.png?authuser=7&hl=id)
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](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata9.png?authuser=7&hl=id)
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](https://developers-dot-devsite-v2-prod.appspot.com/static/gdata/articles/support/eclipse_gdata/eclipse_gdata10.png?authuser=7&hl=id)
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:
- Plugin Java Client Google Data API
- Dokumentasi protokol Data Google di code.google.com
- Project library klien Java Data Google
- Panduan Memulai untuk Library Klien Java
- Dokumentasi JavaDoc
Java adalah merek dagang Sun Microsystems, Inc. di Amerika Serikat dan negara lainnya.