เมษายน 2008
ใหม่ Google Data API ปลั๊กอิน Java Client Eclipse : สร้างโปรเจ็กต์ได้ในไม่กี่วินาที
ส่วนเสริมของบทความนี้มีปลั๊กอิน Eclipse ที่สามารถใช้ลดค่าใช้จ่ายในการดําเนินการการตั้งค่าทรัพยากร Dependency ของข้อมูล Google นอกจากนี้ยังสร้างโค้ด Boilerplate เพื่อโต้ตอบกับ API ที่คุณสนใจด้วย ซึ่งเป็นวิธีง่ายๆ ในการเริ่มต้นใช้งาน Google Data API
บทนำ
สุริยุปราคามีประโยชน์มาก (และฟรี) IDE ที่มีพื้นที่พิเศษในใจของโปรแกรมโปรแกรม Java มากมาย จึงไม่น่าแปลกใจที่คุณอาจต้องการนําไปใช้กับไลบรารีของไคลเอ็นต์ Java เพื่อสร้างแอปพลิเคชัน Java ฆาตกรรมที่ทํางานร่วมกับ Google Data API ตัวใดตัวหนึ่ง
การตั้งค่าวงรี
หากคุณยังไม่ได้ติดตั้ง Eclipse คุณพลาดไป วงรีช่วยให้การพัฒนา Java ง่ายขึ้นมาก เนื่องจากสามารถแนะนําการแก้ไข ค้นหาการนําเข้าที่หายไป และวิธีการเติมข้อความอัตโนมัติได้ ไปที่หน้าดาวน์โหลดของ Eclipse.org เพื่อรับโปรแกรมติดตั้งสําหรับระบบปฏิบัติการ ในการเรียกใช้ Eclipse คุณจะต้องติดตั้ง JRE ซึ่งลิงก์มาจากหน้าการดาวน์โหลด Eclipse เมื่อติดตั้ง Eclipse แล้ว คุณจะต้องสร้างพื้นที่ทํางาน ตัวอย่างเหล่านี้ใช้ /usr/local/eclipse/workspace
การติดตั้งไลบรารีที่จําเป็น
Eclipse มีฟังก์ชันการทํางานต่างๆ สําหรับ Java ทันทีที่เริ่มใช้งาน ก่อนอื่น นําไลบรารีไคลเอ็นต์ Java เวอร์ชันล่าสุดออกจากหน้าดาวน์โหลดของโปรเจ็กต์ โปรดทราบว่าจะมีการดาวน์โหลด 2 รายการ ได้แก่ การดาวน์โหลด 1 รายการสําหรับการสุ่มตัวอย่าง และ 1 รายการสําหรับซอร์สโค้ด ดาวน์โหลดไฟล์ ZIP ตัวอย่าง เนื่องจากมีไฟล์ JAR ที่รวบรวมของไลบรารีของไคลเอ็นต์ Java ที่จําเป็นต่อการสร้างโปรแกรมของคุณเอง หากคุณมีข้อสงสัยเกี่ยวกับวิธีการทํางานของไลบรารีของไคลเอ็นต์ คุณสามารถดาวน์โหลดไฟล์ ZIP ของต้นทางและดูรายละเอียดได้ แต่อยู่นอกเหนือขอบเขตของบทความนี้ เมื่อดาวน์โหลดไฟล์ ZIP ตัวอย่างแล้ว ให้แตกไฟล์ไปยังไดเรกทอรีที่ใช้งานได้ ซึ่งคุณจะค้นหาไฟล์ได้ ตัวอย่างนี้ใช้ /usr/local/eclipse หมายความว่าตอนนี้ไฟล์ JAR สําหรับโปรเจ็กต์ควรเข้าถึงได้ภายใต้ /usr/local/eclipse/gdata/java/lib
เมื่อติดตั้งไลบรารีของไคลเอ็นต์แล้ว สิ่งที่ต้องทําต่อไปคือดาวน์โหลดทรัพยากร Dependency ภายนอกบางรายการเพื่อให้เรารวมเส้นทางดังกล่าวไว้ในเส้นทางการสร้างโปรเจ็กต์ได้ ไฟล์ INSTALL-samples.txt มีรายการขวดโหลที่จําเป็นต้องใช้และสถานที่ที่จะดาวน์โหลด รายการปัจจุบันคือ
| ชื่อไฟล์ | ตำแหน่ง |
|---|---|
| mail.jar | JavaMail API ของดวงอาทิตย์ |
| การเปิดใช้งาน.jar | เฟรมเวิร์กการเปิดใช้งาน JavaBeans ของ Sun |
| servlet-api.jar | Apache Tomcat |
ในตัวอย่างนี้ ระบบจะดาวน์โหลดและคัดลอกไฟล์ JAR เหล่านี้ไปยัง /usr/local/eclipse/gdata/third_party
ค่อยยังชั่ว! ตอนนี้คุณควรมีทุกสิ่งที่จําเป็นเพื่อเริ่มพัฒนาแอปพลิเคชัน Java ที่ใช้ Google Data API แล้ว อ่านต่อ
การสร้างแอปพลิเคชันใหม่
ขั้นตอนแรกให้เปิด Eclipse แล้วเลือก "New > Java Project" จากเมนู "ไฟล์"
ต่อไป ให้คลิก "ถัดไป" แล้วเลือกแท็บ "ไลบรารี" เพิ่มไฟล์ JAR แบบอาศัยกันทั้งหมดที่คุณดาวน์โหลดโดยคลิก "เพิ่ม JAR ภายนอก"
นอกจากนี้คุณจะต้องเพิ่มไฟล์ JAR จากไลบรารีของไคลเอ็นต์ Java อยู่ในไดเรกทอรีย่อยของ java/lib ที่คุณดึงไลบรารีของไคลเอ็นต์ไว้ คุณจะต้องรวมไฟล์ JAR ต่อไปนี้เสมอ ได้แก่ gdata-client, gdata-client-meta, gdata-core และ gdata-media
เลือก API ที่ต้องการใช้ได้เลย ตัวอย่างนี้ใช้ Google List List API ซึ่งต้องเพิ่มลงในไฟล์ JAR ที่เหมาะสม ได้แก่ gdata-docs และ gdata-docs-meta
สุดท้ายให้คลิก "เสร็จสิ้น" และสร้างโปรเจ็กต์ใหม่
หากต้องการสร้างแอปพลิเคชันการสอบง่ายๆ ให้สร้างชั้นเรียนใหม่ที่มีเมธอดหลักโดยเลือก "ใหม่ > ชั้นเรียน" จากเมนูไฟล์
คราวนี้ฉันจะวางโค้ดบางส่วนจากคู่มือสําหรับนักพัฒนาซอฟต์แวร์สําหรับ API รายชื่อเอกสาร
คุณจะเห็นข้อผิดพลาดจํานวนมากจนกว่าคุณจะเพิ่มใบแจ้งยอดการนําเข้าที่เหมาะสม Eclipse ทําให้การดําเนินการนี้เป็นเรื่องง่าย เพียงคลิกเครื่องหมายแสดงข้อผิดพลาดทางด้านซ้ายเพื่อรับเมนูที่เป็นประโยชน์ซึ่งจะช่วยให้คุณเพิ่มการนําเข้าได้
เมื่อล้างการนําเข้าแล้ว คุณจะต้องจัดการข้อยกเว้นที่โค้ดของเราทําเช่นนั้นได้ด้วย ตัวอย่างนี้จะเลือกโค้ดตัวอย่างทั้งหมดด้วยเครื่องจัดการข้อยกเว้นที่ลงรายละเอียดมาก
ตอนนี้ สมมติว่าคุณใช้ชื่อผู้ใช้และรหัสผ่านที่ถูกต้องแทนบัญชีทดสอบที่คุณสร้าง คุณควรดูรายการเอกสารที่เป็นของบัญชีทดสอบนั้นเมื่อคุณเลือก "เรียกใช้" จากเมนู "เรียกใช้"
ไชโย
บทสรุป
ตอนนี้คุณมีอินสแตนซ์ Eclipse และไฟล์ JAR ที่จําเป็นทั้งหมดแล้ว คุณก็กําลังสร้างแอปพลิเคชัน Java ที่ยอดเยี่ยมซึ่งทํางานร่วมกับ Google Data API ได้
ขั้นตอนถัดไป ลิงก์ต่อไปนี้อาจมีประโยชน์สําหรับคุณ
- ปลั๊กอิน Google Client API ของ Google Eliplipse
- เอกสารเกี่ยวกับโปรโตคอลข้อมูลของ Google ใน code.google.com
- โปรเจ็กต์ไลบรารีของไคลเอ็นต์ Google Data Java
- คู่มือเริ่มต้นใช้งานไลบรารีของไคลเอ็นต์ Java
- เอกสารประกอบของ Javavac
Java เป็นเครื่องหมายการค้าของ Sun Microsystems, Inc. ในสหรัฐอเมริกาและประเทศอื่นๆ