Lập trình trong Shade: Sử dụng Eclipse với các API dữ liệu của Google

Jeff Fisher, Nhóm Google Data API
Tháng 4 năm 2008

New Google Data API Java Eclipse Plugin – Tạo dự án chỉ trong vài giây

Ngoài ra, trong trình bổ trợ này còn có một trình bổ trợ Eclipse giúp giảm thiểu chi phí vận hành liên quan đến việc thiết lập các phần phụ thuộc Dữ liệu của Google. Thao tác này cũng tạo mã nguyên mẫu để tương tác với API mà bạn quan tâm. Cách này giúp bạn dễ dàng bắt đầu phát triển bằng API Dữ liệu của Google.


Giới thiệu

Eclipse rất hữu ích (và miễn phí!) IDE có một vị trí đặc biệt trong lòng nhiều lập trình viên Java. Không có gì ngạc nhiên khi bạn có thể muốn sử dụng nó với thư viện ứng dụng Java để tạo một ứng dụng Java có khả năng hoạt động tốt với một trong các API dữ liệu của Google.

Thiết lập Eclipse

Nếu chưa cài đặt Eclipse, bạn sẽ bỏ lỡ. Eclipse có thể giúp việc phát triển Java trở nên dễ dàng hơn rất nhiều do ứng dụng này có thể đề xuất các bản sửa lỗi, tìm các phương thức nhập bị thiếu và tự động hoàn thành. Truy cập trang tải xuống của Eclipse.org để tải trình cài đặt cho hệ điều hành của bạn. Để chạy Eclipse, bạn phải cài đặt JRE. Liên kết này được liên kết từ trang tải xuống Eclipse. Sau khi cài đặt Eclipse, bạn sẽ cần tạo một không gian làm việc. Những ví dụ này sử dụng /usr/local/eclipse/workspace.

Cài đặt thư viện bắt buộc

Eclipse cung cấp rất nhiều chức năng Java ngay từ đầu, vì vậy, việc này sẽ rất dễ dàng. Trước tiên, hãy lấy phiên bản mới nhất của thư viện ứng dụng Java trên trang tải xuống của dự án. Lưu ý rằng có hai nội dung tải xuống riêng biệt: một nội dung cho mẫu và một nội dung cho mã nguồn. Tải tệp zip mẫu xuống, vì tệp zip này bao gồm các tệp JAR được biên dịch của thư viện ứng dụng Java cần thiết để tạo chương trình của riêng bạn. Nếu muốn biết cách hoạt động của thư viện ứng dụng, bạn có thể tải tệp zip nguồn và xem qua thư mục đó, nhưng điều đó nằm ngoài phạm vi của bài viết này. Sau khi bạn tải tệp zip mẫu xuống, hãy giải nén tệp đó vào một thư mục thuận tiện nơi bạn có thể tìm thấy các tệp đó. Các ví dụ sử dụng /usr/local/eclipse. Điều này có nghĩa là hiện tại, bạn có thể truy cập vào các tệp JAR của dự án trong /usr/local/eclipse/gdata/java/lib.

Bây giờ, bạn đã cài đặt thư viện ứng dụng, việc tiếp theo bạn cần làm là tải một số phần phụ thuộc bên ngoài xuống để có thể đưa vào phần đường dẫn của bản dựng dự án. Tệp INSTALL-samples.txt chứa danh sách các tệp jar bạn cần và các vị trí để tải các tệp đó xuống. Danh sách hiện tại là:

Tên tệp Vị trí
mail.jar API JavaMail của Sun
kích hoạt.jar Khung kích hoạt JavaBeans của Sun
Bot-api.jar Apache Tomcat

Trong ví dụ này, những tệp JAR này được tải xuống và sao chép vào /usr/local/eclipse/gdata/third_party.

Thế thì tốt quá! Bây giờ, bạn đã có tất cả các phần cần thiết để bắt đầu phát triển ứng dụng Java sử dụng một trong các API Dữ liệu của Google. Hãy đọc tiếp!

Tạo ứng dụng mới

Bước đầu tiên là mở Eclipse và chọn "New > Java Project" (Mới > Dự án Java) trên trình đơn File (Tệp).

Cửa sổ dự án mới của Eclipse

Bây giờ, hãy nhấp vào Tiếp theo và chọn thẻ Thư viện. Thêm tất cả các tệp JAR phụ thuộc mà bạn đã tải xuống bằng cách nhấp vào Thêm tệp JAR bên ngoài.

Thêm các tệp JAR phụ thuộc

Bạn cũng sẽ phải thêm tệp JAR từ thư viện ứng dụng Java. Chúng nằm trong thư mục con java/lib nơi bạn đã trích xuất thư viện ứng dụng. Bạn sẽ luôn phải bao gồm các tệp JAR sau đây: gdata-client, gdata-client-meta, gdata-core và gdata-media.

Thêm tệp JAR GData

Bây giờ, hãy chọn API bạn muốn sử dụng. Ví dụ này sử dụng API Tài liệu của Google. Để làm được điều đó, bạn phải thêm các tệp JAR thích hợp: gdata-docs và gdata-docs-meta.

Thêm tệp JAR DocList

Cuối cùng, bạn có thể nhấp vào "Finish" (Hoàn tất) và tạo dự án mới.

Dự án mới tạo

Để tạo một ứng dụng kiểm thử đơn giản, hãy tạo một lớp mới bằng phương thức chính bằng cách chọn "New > Class" (Mới > Lớp) trên trình đơn Tệp.

Tạo lớp

Bây giờ, tôi sẽ dán một số mã từ Hướng dẫn dành cho nhà phát triển về API danh sách tài liệu.

Mã mẫu có lỗi

Bạn sẽ thấy rất nhiều lỗi cho đến khi bạn thêm các câu lệnh nhập thích hợp. Eclipse giúp bạn làm việc này rất dễ dàng, tất cả những gì bạn cần làm là nhấp vào các điểm đánh dấu lỗi ở bên trái để có một trình đơn hữu ích cho phép bạn thêm các lệnh nhập.

Trình đơn sửa nhanh

Sau khi xóa các mục nhập, bạn cũng phải xử lý các trường hợp ngoại lệ mà mã của chúng tôi có thể gửi. Ví dụ này chọn bao quanh toàn bộ mã mẫu bằng một trình xử lý ngoại lệ rất cơ bản.

Mã mẫu đang hoạt động

Bây giờ, giả sử bạn thay thế tên người dùng và mật khẩu bằng tài khoản thử nghiệm hợp lệ mà bạn đã tạo, bạn có thể xem danh sách tài liệu thuộc sở hữu của tài khoản thử nghiệm đó khi chọn "Chạy" trên trình đơn Chạy.

Kết quả của chương trình

Thật tuyệt!

Kết luận

Giờ đây khi đã có phiên bản Eclipse đang hoạt động và tất cả tệp JAR bắt buộc, bạn đã chắc chắn xây dựng được một ứng dụng Java tuyệt vời hoạt động với một trong các API dữ liệu của Google.

Điểm đến từ đâu? Có một số đường liên kết có thể hữu ích với bạn:

Java là nhãn hiệu của Sun Microsystems, Inc. ở Hoa Kỳ và các quốc gia khác.