การเริ่มต้นใช้งานไลบรารีข้อมูล Google Java

Stephanie Liu, ทีม Google Data API
กันยายน 2007

1. บทนำ
2. ติดตั้ง Dependency
   1. ใน Windows
   2. ใน Mac OS X
   3. ใน Linux ให้ทำดังนี้
3. การติดตั้งไลบรารีของไคลเอ็นต์ข้อมูล Google
4. ตัวอย่างการวิ่ง
5. สร้างแอปพลิเคชันของคุณเอง
6. สรุป
7. ภาคผนวก: การตั้งค่าตัวแปรสภาพแวดล้อม

บทนำ

การเริ่มต้นพัฒนาด้วย API ที่ไม่คุ้นเคยนั้นทําได้ยาก บทความนี้จึงแสดงวิธีดาวน์โหลดและติดตั้ง Google Data API ("GData") Java Client Library แบบทีละขั้นตอน เราจะแนะนําทรัพยากร Dependency ทั้งหมดและตั้งค่าตัวแปรสภาพแวดล้อมที่คุณต้องใช้ คุณจะรวมบริการ GData ต่างๆ เข้าด้วยกันได้อย่างรวดเร็ว

หากใช้วงรีอยู่

อ่านบทความการเขียนโค้ดในเฉดสี: การใช้ Eclipse กับ Google Data API

การติดตั้งทรัพยากร Dependency

ไลบรารีของไคลเอ็นต์ GData Java มีทรัพยากร Dependency ภายนอกต่อไปนี้ ส่วนต่อไปนี้อธิบายวิธีติดตั้งทรัพยากร Dependency เหล่านี้ในระบบปฏิบัติการที่คุณชื่นชอบ (หรือระบบปฏิบัติการที่คุณต้องใช้ในที่ทํางาน)

• JDK (Java Development Kit) เวอร์ชัน 1.5 ขึ้นไป
• Apache Ant เวอร์ชัน 1.7 ขึ้นไป
• mail.jar ใน JavaMail API 1.4 ขึ้นไป
• การเปิดใช้งาน.jar ใน JavaBeansactivationFramework การดําเนินการนี้จําเป็นสําหรับ API สื่อโดยเฉพาะ ซึ่งรวมถึง API ข้อมูลรายการเอกสาร, Picasa Web Album API และ YouTube Data API
• servlet.jar ใน Sunvlet API เวอร์ชัน 2.3 ขึ้นไป จําเป็นเฉพาะในกรณีที่เรียกใช้ตัวอย่างโค้ดในแพ็กเกจ "sample.authsub" หรือ "sample.gbase.สูตรอาหาร{/1}

ทรัพยากร Dependency บางรายการของ .jar จําเป็นต้องใช้สําหรับตัวอย่างที่เจาะจงเท่านั้น แต่เพื่อหลีกเลี่ยงข้อผิดพลาดเกี่ยวกับบิลด์ คุณควรจะได้รับทุกอย่าง เลือกระบบปฏิบัติการที่ต้องการดําเนินการต่อ ได้แก่ Windows, Mac OS X หรือ Linux

บน Windows

คําแนะนําสําหรับระบบปฏิบัติการ Windows

การติดตั้ง Java

แพ็กเกจการพัฒนา Java มาจาก Sun ในรูปแบบ JDK (Java Development Kit) JRE (Java Runtime Environment) และทุกสิ่งที่คุณต้องการเขียน รวบรวม ทดสอบ และแก้ไขข้อบกพร่องแอปพลิเคชัน Java อยู่ภายใน หากติดตั้ง Java ไว้แล้ว ให้ข้ามไปที่การติดตั้ง Ant

หมายเหตุ: คุณต้องมีสิทธิ์ระดับผู้ดูแลระบบเพื่อติดตั้ง JDK

1. ไปที่ http://java.sun.com/javase/downloads/index.jsp
2. คลิก "ดาวน์โหลด" ข้างการอัปเดตล่าสุด
3. อ่านและยอมรับข้อตกลงการอนุญาตให้ใช้สิทธิ
4. ดาวน์โหลดไฟล์ติดตั้ง Windows ไฟล์ใดไฟล์หนึ่ง
5. เรียกใช้โปรแกรมติดตั้ง
6. แก้ไขตัวแปรสภาพแวดล้อม Path เพื่อเรียกใช้ไฟล์ปฏิบัติการ JDK เช่น javac ได้อย่างง่ายดาย เส้นทางที่คุณต้องการเพิ่มจะมีลักษณะเป็น C:\jdk\bin\ ดูวิธีแก้ไขตัวแปร Path ใน Windows ได้ที่ภาคผนวก

หากมีปัญหาในการติดตั้ง JDK โปรดดูวิธีการติดตั้งโดยละเอียดในเว็บไซต์ของ Sun

การติดตั้งมด

Apache Ant เป็นเครื่องมือสร้างสําหรับ Java ที่คล้ายกับ make (แต่ดีกว่า) คุณจะใช้ไลบรารีนี้เพื่อสร้างไลบรารีและเรียกใช้ตัวอย่าง หากติดตั้ง Ant ไว้แล้ว ให้ตรวจสอบว่าเวอร์ชัน 1.7 ขึ้นไป

1. คลิกเมนู "เริ่ม" แล้วคลิก "เรียกใช้"
2. พิมพ์ cmd ในช่องข้อความ
3. พิมพ์ ant -version ในข้อความแจ้งเพื่อดูเวอร์ชันที่คุณใช้

หากคุณใช้เวอร์ชัน 1.7 ขึ้นไป ให้ข้ามไปที่การรับ mail.jar หาก Ant เวอร์ชันที่ต่ํากว่า 1.7 หรือคุณยังไม่ได้ติดตั้ง Ant ให้ทําตามขั้นตอนด้านล่าง

1. ไปที่ http://ant.apache.org/bindownload.cgi
2. คลิกลิงก์สําหรับการดาวน์โหลด .zip
3. แตกไฟล์ทั้งหมดไปยังตําแหน่งที่ต้องการ เช่น C:\ant
4. เพิ่มไดเรกทอรี bin มด เช่น C:\ant\bin ลงใน ตัวแปรสภาพแวดล้อม Path ของคุณ
5. เพิ่มหรือแก้ไขตัวแปรสภาพแวดล้อมของ ANT_HOME เพื่อตั้งค่าเป็นสถานที่ใหม่ เช่น C:\ant
6. เพิ่มหรือแก้ไขตัวแปรสภาพแวดล้อมของ JAVA_HOME ไปยังตําแหน่งที่มีการติดตั้ง Java เช่น C:\jdk

ดูวิธีการติดตั้งโดยละเอียดได้ที่เว็บไซต์ของมด หากยังพบปัญหาอยู่

รับ mail.jar

JavaMail API รวมอยู่ในการสนับสนุนสื่อ

1. ไปที่ http://java.sun.com/products/javamail/downloads/index.html
2. คลิกปุ่ม "ดาวน์โหลด" ตรวจสอบว่าคุณดาวน์โหลดเวอร์ชัน 1.4 ขึ้นไป
3. อ่านและยอมรับข้อตกลงการอนุญาตให้ใช้สิทธิ
4. คลิกลิงก์สําหรับไฟล์ .zip ที่มี JavaMail
5. แตกไฟล์ลงในคอมพิวเตอร์และบันทึกตําแหน่ง mail.jar จะอยู่ใต้ไดเรกทอรีราก javamail-(version)

การเปิดใช้งาน.jar

เฟรมเวิร์กการเปิดใช้งาน Javavaans รวมอยู่ในการสนับสนุนสื่อแล้ว

1. ไปที่หน้าดาวน์โหลด JAF
2. คลิกปุ่ม "ดาวน์โหลด"
3. อ่านและยอมรับข้อตกลงการอนุญาตให้ใช้สิทธิ
4. คลิกลิงก์สําหรับไฟล์ .zip ที่มีเฟรมเวิร์กการเปิดใช้งาน
5. แตกไฟล์ลงในคอมพิวเตอร์และบันทึกตําแหน่ง activation.jar จะอยู่ใต้ไดเรกทอรีราก jaf-(version)

กําลังรับ servlet.jar

servlet.jar (อาจเรียกว่า servlet-api.jar) จะอยู่ในคอนเทนเนอร์แร็กเก็ต (J2EE, Tomcat, WebLogic ฯลฯ) ใช้สําหรับตัวอย่าง AuthSub และ Google Base วิธีการต่อไปนี้จะช่วยให้คุณเข้าถึง Tomcat 6.x ได้

1. ไปที่ http://tomcat.apache.org/download-60.cgi
2. คลิก Windows Service Installer ดาวน์โหลดภายใต้ Core Bไบนารี Distribution
3. เรียกใช้โปรแกรมติดตั้ง
4. หากใช้ค่าเริ่มต้น servlet-api.jar ควรอยู่ที่ C:\Program Files\Apache Software Foundation\Tomcat 6.0\lib

ดูเอกสารการตั้งค่าและการติดตั้ง Tomcat เพิ่มเติมได้ที่นี่

เอาละ คุณพร้อมที่จะติดตั้งไลบรารีของไคลเอ็นต์ GData Java แล้ว

ใน Mac OS X

คําแนะนําสําหรับระบบปฏิบัติการ Mac OS X

การติดตั้ง Java

หากใช้ Mac OS X คุณก็ไม่ต้องดําเนินการใดๆ เพิ่มเติม Apple ได้รวม JDK (Java Development Kit) ที่ใช้งานได้อย่างเต็มรูปแบบและพร้อมใช้งานสําหรับทุกอินสแตนซ์ ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ Java ของ Apple

การติดตั้งมด

Apache Ant เป็นเครื่องมือสร้างสําหรับ Java ที่คล้ายกับ make (แต่ดีกว่า) คุณจะใช้ไลบรารีนี้เพื่อสร้างไลบรารีและเรียกใช้ตัวอย่าง คุณอาจติดตั้ง Ant ไว้แล้วเช่นกัน แต่โปรดตรวจสอบว่าคุณมีเวอร์ชัน 1.7 ขึ้นไป

1. เปิดหน้าต่างเทอร์มินัล (Command + Spacebar จากนั้นพิมพ์ 'เทอร์มินัล' เพื่อค้นหาแอปพลิเคชัน)
2. พิมพ์คําสั่งที่ Prompt

ant -version

หากเวอร์ชันมดที่ใช้อยู่ต่ํากว่า 1.7 ให้ทําตามขั้นตอนด้านล่างเพื่อดาวน์โหลดเวอร์ชันล่าสุด

1. ไปที่ http://ant.apache.org/bindownload.cgi
2. คลิกลิงก์สําหรับการดาวน์โหลด .zip
3. เปิดหน้าต่างเทอร์มินัล (Command + Spacebar จากนั้นพิมพ์ 'เทอร์มินัล' เพื่อค้นหาแอปพลิเคชัน)
4. พิมพ์คําสั่งต่อไปนี้ที่ Command Prompt
   • cd ~/Desktop
   • sudo sh
   • mv apache-ant-(version)-bin.zip /usr/local/
   • cd /usr/local/
   • unzip apache-ant-(version)-bin.zip
   • chown (your account name):(your account name) apache-ant-(version)
   • ln -s apache-ant-(version) ant

ดูวิธีการติดตั้งโดยละเอียดได้ที่เว็บไซต์ของมด หากยังพบปัญหาอยู่ บล็อกโพสต์นี้มีคําอธิบายโดยละเอียดว่าคําสั่งใน Shell ข้างต้นหมายความว่าอย่างไร

รับ mail.jar

JavaMail API รวมอยู่ในการสนับสนุนสื่อ

1. ไปที่ http://java.sun.com/products/javamail/downloads/index.html
2. คลิกปุ่ม "ดาวน์โหลด" ตรวจสอบว่าคุณดาวน์โหลดเวอร์ชัน 1.4 ขึ้นไป
3. อ่านและยอมรับข้อตกลงการอนุญาตให้ใช้สิทธิ
4. คลิกลิงก์สําหรับไฟล์ .zip ที่มี JavaMail
5. แตกไฟล์ลงในคอมพิวเตอร์และบันทึกตําแหน่ง mail.jar จะอยู่ใต้ไดเรกทอรีราก javamail-(version)

การเปิดใช้งาน.jar

เฟรมเวิร์กการเปิดใช้งาน Javavaans รวมอยู่ในการสนับสนุนสื่อแล้ว

1. ไปที่หน้าดาวน์โหลด JAF
2. คลิกปุ่ม "ดาวน์โหลด"
3. อ่านและยอมรับข้อตกลงการอนุญาตให้ใช้สิทธิ
4. คลิกลิงก์สําหรับไฟล์ .zip ที่มีเฟรมเวิร์กการเปิดใช้งาน
5. แตกไฟล์ลงในคอมพิวเตอร์และบันทึกตําแหน่ง activation.jar จะอยู่ใต้ไดเรกทอรีราก jaf-(version)

กําลังรับ servlet.jar

servlet.jar (อาจเรียกว่า servlet-api.jar) จะอยู่ในคอนเทนเนอร์แร็กเก็ต (J2EE, Tomcat, WebLogic ฯลฯ) ใช้สําหรับตัวอย่าง AuthSub และ Google Base วิธีการต่อไปนี้จะช่วยให้คุณเข้าถึง Tomcat 6.x ได้

1. ไปที่ http://tomcat.apache.org/download-60.cgi
2. คลิก .zip การดาวน์โหลดในส่วน Core Bไบนารี Distribution
3. แตกไฟล์ลงในคอมพิวเตอร์และบันทึกตําแหน่ง servlet.jar อยู่ใต้ apache-tomcat-(version)/lib

ดูเอกสารการตั้งค่าและการติดตั้ง Tomcat เพิ่มเติมได้ที่นี่

เอาละ คุณพร้อมที่จะติดตั้งไลบรารีของไคลเอ็นต์ GData Java แล้ว

ใน Linux ให้ทำดังนี้

คําแนะนําสําหรับระบบปฏิบัติการ Linux

การติดตั้ง Java

บทแนะนํานี้จะใช้ JDK (Java Development Kit) ของ Sun หากคุณมีสิทธิ์เข้าถึงระดับรูท โปรดทําตามวิธีการด้านล่าง หากไม่ คุณเพียงแค่ติดตั้ง JDK ในไดเรกทอรีหลักโดยทําตามวิธีการเหล่านี้ หากติดตั้ง JDK 1.5 ขึ้นไปไว้แล้ว ให้ข้ามไปที่การติดตั้งมด

หากคุณมีสิทธิ์ระดับรูท

1. ไปที่ http://java.sun.com/javase/downloads/index.jsp
2. คลิก "ดาวน์โหลด" ข้างเวอร์ชันล่าสุด
3. อ่านและยอมรับข้อตกลงการอนุญาตให้ใช้สิทธิ
4. คลิกและดาวน์โหลดไฟล์การแยก RPM ด้วยตนเองในส่วน "Linux Platform"
5. เปิดหน้าต่างเทอร์มินัล เปลี่ยนเป็นไดเรกทอรีที่คุณดาวน์โหลดไฟล์ แล้วทําตามขั้นตอนต่อไปนี้
• su
• chmod a+x jdk-6(version)-linux-i586-rpm.bin
• ./jdk-6(version)-linux-i586-rpm.bin
• ยอมรับข้อตกลงการอนุญาตให้ใช้สิทธิ

หากคุณไม่มีสิทธิ์รูท

1. ไปที่ http://java.sun.com/javase/downloads/index.jsp
2. คลิก "ดาวน์โหลด" ข้างเวอร์ชันล่าสุด
3. อ่านและยอมรับข้อตกลงการอนุญาตให้ใช้สิทธิ
4. คลิกและดาวน์โหลดบิลด์การดึงข้อมูลด้วยตนเอง (ไม่ใช่ RPM) ในส่วน "Linux Platform"
5. เปิดหน้าต่างเทอร์มินัล เปลี่ยนเป็นไดเรกทอรีที่คุณดาวน์โหลดไฟล์ แล้วพิมพ์คําสั่งต่อไปนี้
• chmod +x jdk-6(version)-linux-i586-rpm.bin
• เปลี่ยนไปยังไดเรกทอรีที่ต้องการติดตั้งไฟล์
• เรียกใช้ไบนารีแบบแตกข้อมูลด้วยตนเอง หากคุณกําลังติดตั้งในไดเรกทอรีปัจจุบัน ก็เพียงพิมพ์ ./jdk-6(version)-linux-i586-rpm.bin
• ยอมรับข้อตกลงการอนุญาตให้ใช้สิทธิ

หากพบปัญหา คุณสามารถดูวิธีการติดตั้งโดยละเอียดได้ที่นี่

การติดตั้งมด

ไลบรารีของไคลเอ็นต์ GData Java ต้องใช้ Ant 1.7 ขึ้นไป หากติดตั้ง Ant ไว้แล้ว โปรดตรวจสอบเวอร์ชันโดยพิมพ์ ant -version ใน Command Prompt หากจําเป็นต้องดาวน์โหลดเวอร์ชันล่าสุดหรือไม่ได้ติดตั้ง ให้ทําตามวิธีการด้านล่าง ข้ามไปที่รับ mail.jar หากคุณตั้งค่าการติดตั้ง Java และ Ant ไว้อยู่แล้ว

1. ไปที่ http://ant.apache.org/bindownload.cgi
2. คลิกลิงก์สําหรับการดาวน์โหลด .tar.gz
3. แตกไฟล์ด้วยการแสดงหน้าต่างเทอร์มินัล เปลี่ยนเป็นไดเรกทอรีที่มีไฟล์ที่ดาวน์โหลด แล้วพิมพ์คําสั่งต่อไปนี้
• gunzip apache-ant-(version)-bin.tar.gz
• tar xvf apache-ant-(version)-bin.tar
4. เพิ่มไดเรกทอรี bin มดในตัวแปรสภาพแวดล้อม PATH
5. เพิ่มหรือแก้ไขตัวแปรสภาพแวดล้อมของ ANT_HOME เพื่อตั้งค่าเป็นสถานที่ใหม่
6. เพิ่มหรือแก้ไขตัวแปรสภาพแวดล้อมของ JAVA_HOME เพื่อตั้งค่าให้เป็นตําแหน่งที่ติดตั้ง JDK

คุณสามารถดูเอกสารประกอบการติดตั้งมดได้ที่นี่หากพบปัญหา

รับ mail.jar

JavaMail API รวมอยู่ในการสนับสนุนสื่อ

1. ไปที่ http://java.sun.com/products/javamail/downloads/index.html
2. คลิกปุ่ม "ดาวน์โหลด" ตรวจสอบว่าคุณดาวน์โหลดเวอร์ชัน 1.4 ขึ้นไป
3. อ่านและยอมรับข้อตกลงการอนุญาตให้ใช้สิทธิ
4. คลิกลิงก์สําหรับไฟล์ .zip ที่มี JavaMail
5. unzip ไฟล์ไปยังคอมพิวเตอร์ของคุณและจดจําตําแหน่ง mail.jar จะอยู่ใต้ไดเรกทอรีราก javamail-(version)

การเปิดใช้งาน.jar

เฟรมเวิร์กการเปิดใช้งาน Javavaans รวมอยู่ในการสนับสนุนสื่อแล้ว

1. ไปที่หน้าดาวน์โหลด JAF
2. คลิกปุ่ม "ดาวน์โหลด"
3. อ่านและยอมรับข้อตกลงการอนุญาตให้ใช้สิทธิ
4. คลิกลิงก์สําหรับไฟล์ .zip ที่มีเฟรมเวิร์กการเปิดใช้งาน
5. unzip ไฟล์ไปยังคอมพิวเตอร์ของคุณและจดจําตําแหน่ง activation.jar จะอยู่ใต้ไดเรกทอรีราก jaf-(version)

กําลังรับ servlet.jar

servlet.jar (อาจเรียกว่า servlet-api.jar) จะอยู่ในคอนเทนเนอร์แร็กเก็ต (J2EE, Tomcat, WebLogic ฯลฯ) ใช้สําหรับตัวอย่าง AuthSub และ Google Base วิธีการต่อไปนี้จะช่วยให้คุณเข้าถึง Tomcat 6.x ได้

1. ไปที่ http://tomcat.apache.org/download-60.cgi
2. ดาวน์โหลดไฟล์ .tar.gz ในส่วนการเผยแพร่ไบนารีหลัก
3. แตกไฟล์ดาวน์โหลดด้วย gunzip และ tar ดังที่แสดงในส่วนการติดตั้งมดด้านบน
4. servlet.jar อยู่ใต้ apache-tomcat-(version)/lib

ตอนนี้ควรมีทุกอย่างที่จําเป็นสําหรับไลบรารีของไคลเอ็นต์ GData Java

การติดตั้งไลบรารีของไคลเอ็นต์ข้อมูล Google

1. ไปที่ http://code.google.com/p/gdata-java-client/downloads/list
2. ดาวน์โหลดไลบรารีของไคลเอ็นต์ (gdata-src.java-1.x.x.java.zip) และตัวอย่างล่าสุด (gdata-samples.java-1.x.x.java.zip)
3. ดึงข้อมูลแหล่งที่มาของไลบรารีไคลเอ็นต์ลงในคอมพิวเตอร์
4. ไปที่ gdata/java/build-src/build.properties และเปิดไฟล์
5. แก้ไขทรัพยากร Dependency ภายนอกให้ชี้ไปยังตําแหน่งของไฟล์ .jar ในเครื่องของคุณ

หมายเหตุ: ใน Windows โปรดตรวจสอบว่าได้ใช้แบ็กสแลชเป็นอักขระหลีก ตัวอย่างเช่น

servlet.jar=C:\\Program Files\\Apache Software Foundation\\Tomcat 6.0\\lib\\servlet-api.jar

ตัวอย่างการวิ่ง

ตัวอย่างที่มีอยู่ทั้งหมดจะอยู่ใน gdata/java/sample จากที่เก็บถาวร gdata-samples.java-1.x.x.java.zip ไฟล์ gdata/java/build-samples/build.properties มีค่าอินพุตทั้งหมดสําหรับตัวอย่างที่อยู่ในคลัง ตั้งค่า sample.credentials.username และ sample.credentials.password ด้วยชื่อผู้ใช้และรหัสผ่านที่ถูกต้อง เราใช้มดเพื่อสร้างและดําเนินการตัวอย่างได้

ทดสอบว่าคุณได้ติดตั้งทุกอย่างอย่างถูกต้องโดยเปิด Command Prompt เปลี่ยนเป็นไดเรกทอรี gdata/java และพิมพ์หรือไม่

ant -f build-samples.xml sample.calendar.run

คุณอาจได้รับข้อมูลหรือข้อความเตือนบางรายการ แต่มองหาข้อความ BUILD SUCCESSFUL ตอนท้าย โปรดดูส่วนการแก้ปัญหาหากไม่ได้รับข้อความแสดงความสําเร็จ

ลองใช้ตัวอย่างที่มีการโต้ตอบมากขึ้นโดยพิมพ์

ant -f build-samples.xml sample.spreadsheet.guidemo.run

ดูวิธีการเรียกใช้ตัวอย่างที่เฉพาะเจาะจงได้ที่ gdata/java/build-samples และตรวจสอบไฟล์บิวด์สําหรับตัวอย่างดังกล่าว มองหาส่วนsamples run

การแก้ปัญหา

หากสร้างไม่สําเร็จพร้อมข้อความแสดงข้อผิดพลาด เช่น

BUILD FAILED
Target 'core.sample.core.util.build' does not exist in this project. It is used from target 'sample.calendar.build'.

Total time: 0 seconds

หรือข้อความแสดงข้อผิดพลาดที่คล้ายกันเกี่ยวกับไฟล์ที่จําเป็นซึ่งขาดหายไปจากโปรเจ็กต์ คุณอาจเรียกใช้ Ant เวอร์ชันเก่า พิมพ์ ant -version เพื่อให้มั่นใจว่าคุณใช้เวอร์ชัน 1.7 ขึ้นไป โดยทําตามวิธีการของทรัพยากร Dependency ด้านบนเพื่อรับ Ant เวอร์ชันล่าสุด

สร้างแอปพลิเคชันของคุณเอง

คําถามต่อไปคือวิธีสร้างแอปพลิเคชันของคุณเอง ฉันจะพูดถึงโปรแกรมที่เทียบเท่า "สวัสดีชาวโลก" โดยใช้บริการปฏิทินเพื่อแสดงฟังก์ชันพื้นฐาน ดูข้อมูลเพิ่มเติมโดยละเอียดได้ในคู่มือนักพัฒนาซอฟต์แวร์ของไลบรารีของไคลเอ็นต์ Java รวมทั้งคู่มือนักพัฒนาซอฟต์แวร์ของผลิตภัณฑ์แต่ละรายการ

สร้างไฟล์ชื่อ CalendarTest.java เริ่มต้นด้วยการรวมใบแจ้งยอดการนําเข้าต่อไปนี้

import com.google.gdata.client.*;
import com.google.gdata.client.calendar.*;
import com.google.gdata.data.*;
import com.google.gdata.data.acl.*;
import com.google.gdata.data.calendar.*;
import com.google.gdata.data.extensions.*;
import com.google.gdata.util.*;

import java.net.*;
import java.io.*;

import sample.util.*;

นี่คือโปรแกรมทั้งหมด (โดยไม่มีการจัดการข้อยกเว้น)

public class CalendarTest {

    public static void main(String[] args) {
        CalendarService myService = new CalendarService("exampleCo-exampleApp-1.0");
        myService.setUserCredentials("[e-mail]", "pa$$word");

        URL feedUrl = new URL("http://www.google.com/calendar/feeds/default/allcalendars/full");
        CalendarFeed resultFeed = myService.getFeed(feedUrl, CalendarFeed.class);

        System.out.println("Your calendars:");
        System.out.println();

        for (int i = 0; i < resultFeed.getEntries().size(); i++) {
          CalendarEntry entry = resultFeed.getEntries().get(i);
          System.out.println("\t" + entry.getTitle().getPlainText());
        }

    }
}

This little program will request all the calendars you own and display all the titles. It's a little longer than the canonical "Hello, World!" example, but it's very simple once we break it down. The first couple of lines creates a service object and sets the user credentials.

CalendarService myService = new CalendarService("exampleCo-exampleApp-1.0");
myService.setUserCredentials("[e-mail]", "pa$$word");

จากนั้นจึงกําหนด URL ของทรัพยากร ในกรณีนี้ นี่คือที่ที่คุณสามารถขอรายการปฏิทินทั้งหมดจากผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์

URL feedUrl = new URL("http://www.google.com/calendar/feeds/default/allcalendars/full");

บรรทัดด้านล่างจะเรียกใช้คําสั่ง GET จริงใน URL และนําฟีดผลลัพธ์ไปใช้กับออบเจ็กต์จัดระเบียบ

CalendarFeed resultFeed = myService.getFeed(feedUrl, CalendarFeed.class);

ห่วง for ด้านล่างจะซ้ํากับแต่ละรายการและพิมพ์ชื่อ โปรดทราบว่าชื่อจะจัดเก็บเป็น TextConstruct จึงต้องมีการเรียกฟังก์ชันเพิ่มเติมเพื่อรับข้อความธรรมดา

for (int i = 0; i < resultFeed.getEntries().size(); i++) {
    CalendarEntry entry = resultFeed.getEntries().get(i);
    System.out.println("\t" + entry.getTitle().getPlainText());
}

วิธีการนั้นค่อนข้างง่าย มาพูดถึงเรื่องอื่นๆ ที่พบได้บ่อยกัน ข้อมูลโค้ดต่อไปนี้จะแสดงวิธีการสร้างออบเจ็กต์และแทรกออบเจ็กต์นั้น โดยในตัวอย่างของเราจะเป็นรายการกิจกรรมในปฏิทินใหม่

URL postURL = new URL("http://www.google.com/calendar/feeds/[e-mail]/private/full");
CalendarEventEntry myEvent = new CalendarEventEntry();

//Set the title and description
myEvent.setTitle(new PlainTextConstruct("Pi Day Party"));
myEvent.setContent(new PlainTextConstruct("I am throwing a Pi Day Party!"));

//Create DateTime events and create a When object to hold them, then add
//the When event to the event
DateTime startTime = DateTime.parseDateTime("2007-03-14T15:00:00-08:00");
DateTime endTime = DateTime.parseDateTime("2007-03-14T17:00:00-08:00");
When eventTimes = new When();
eventTimes.setStartTime(startTime);
eventTimes.setEndTime(endTime);
myEvent.addTime(eventTimes);

// POST the request and receive the response:
CalendarEventEntry insertedEntry = myService.insert(postURL, myEvent);

การดําเนินการทั่วไปอีกอย่างคือการสร้างการค้นหา

//Create a new query object and set the parameters
Query myQuery = new Query(feedURL);
myQuery.setFullTextQuery("Pi");

//Send the request with the built query URL
CalendarEventFeed myResultsFeed = myService.query(myQuery, CalendarEventFeed.class);

//Take the first match and print the title
if (myResultsFeed.getEntries().size() > 0) {
    CalendarEventEntry firstMatchEntry = new CalendarEventEntry();
    myResultsFeed.getEntries().get(0);
    System.out.println(firstMatchEntry.getTitle().getPlainText());
}

ขณะแก้ไขข้อบกพร่อง การดําเนินการที่เป็นประโยชน์อีกอย่างคือการส่งออก XML ดิบ ยูทิลิตีมีประโยชน์สําหรับใช้ในห้องสมุด ตรวจสอบว่านําเข้า samples.util.* แล้ว จากนั้นทิ้งฟีดหรือรายการข้อมูลทิ้ง

CommonUtils.dump(resultFeed, System.out);

สําหรับเครื่องมือการแก้ไขข้อบกพร่องที่ละเอียดยิ่งขึ้น โปรดอ่านบทความการแก้ไขข้อบกพร่องของไคลเอ็นต์ Google Data API: การสํารวจการเข้าชมจากโปรแกรมของคุณ เกี่ยวกับวิธีการเปิดการบันทึกจากไลบรารีของไคลเอ็นต์

วิธีนี้จะให้ความรู้สึกเกี่ยวกับการสร้างแอปโดยใช้ไลบรารีของไคลเอ็นต์ อ่านข้อมูลโดยละเอียดเพิ่มเติมได้ที่ส่วนสรุปสําหรับรายการคู่มือสําหรับนักพัฒนาซอฟต์แวร์ที่มีให้สําหรับ Google Data API แต่ละรายการ

บทสรุป

หวังว่าตอนนี้คุณจะสร้างและเรียกใช้แอปพลิเคชันได้โดยใช้ไลบรารีของไคลเอ็นต์ GData Java ได้แล้ว ฉันไม่ได้พูดถึง IDE ยอดนิยมที่คุณนําไปใช้ได้ แต่อาจต้องพิจารณาเครื่องมือยอดนิยม เช่น Eclipse หรือ NetBeans ลิงก์เพิ่มเติมบางส่วนที่อาจเป็นประโยชน์มีดังนี้

• หน้าแรกของไลบรารีของไคลเอ็นต์ GData Java
• รายการ Google Data API
• คู่มือนักพัฒนาซอฟต์แวร์ Java ใช้ได้กับ Google Data API ดังต่อไปนี้
  • Content API สําหรับ Shopping
  • Blogger
  • รายชื่อติดต่อ
  • Google ปฏิทิน
  • รายการ Google เอกสาร
  • Google Finance
  • สเปรดชีตของ Google
  • Google Search Console
  • YouTube
• การเขียนโค้ดในเฉด: การใช้ Eclipse กับ Google Data API
• ปลั๊กอิน Google Client API ของ Google Eliplipse

หากมีข้อสงสัยเกี่ยวกับการใช้ไลบรารีของไคลเอ็นต์ Java กับ API ใดก็ตาม โปรดแจ้งให้เราทราบโดยการโพสต์ในฟอรัม API ที่ต้องการ

ภาคผนวก: การตั้งค่าตัวแปรสภาพแวดล้อม

วิธีการตั้งค่าตัวแปรสภาพแวดล้อมใน Windows หรือ Linux คุณไม่ควรตั้งค่าใดๆ สําหรับ Mac OS X

Windows

ระบบจะใช้ตัวแปรระบบกับผู้ใช้ทุกคนในคอมพิวเตอร์ หากแก้ไขตัวแปรของระบบไม่ได้เนื่องจากไม่มีสิทธิ์ของผู้ดูแลระบบ โปรดทําตามวิธีการที่นี่

หากคุณมีสิทธิ์ของผู้ดูแลระบบ ให้ทําดังนี้

1. คลิกขวาที่ "My Computer" แล้วเลือก "Properties"
2. คลิกแท็บ "ขั้นสูง"
3. คลิก "ตัวแปรสภาพแวดล้อม"
4. ตัวแปรระบบ "เพิ่ม" หรือ "แก้ไข" (แทนที่ตําแหน่งในเครื่องของคุณ)
• เพิ่มหรือแก้ไข ANT_HOME และกําหนดค่าเป็น C:\ant
• เพิ่มหรือแก้ไข JAVA_HOME และกําหนดค่าเป็น C:\jdk
• เพิ่มหรือแก้ไข Path และใส่ ;C:\ant\bin;C:\jdk\bin ต่อท้าย (อัฒภาคคั่นเส้นทางไดเรกทอรี)
• เพิ่มหรือแก้ไข CLASSPATH แล้วต่อท้ายไฟล์ .jar ที่ต้องใช้ โดยขึ้นอยู่กับบริการที่คุณต้องการใช้งาน ตรวจสอบว่า "." รวมอยู่ใน &mhash ซึ่งระบุไดเรกทอรีปัจจุบัน .;C:\gdata\java\lib\gdata-core-1.0.jar;C:\gdata\java\lib\gdata-calendar-1.0.jar เป็นต้น
5. รีบูตเพื่อให้แน่ใจว่าจะมีผล

หมายเหตุ: ตรวจสอบว่าตัวแปรไม่มีเครื่องหมายคําพูด (' หรือ ") และไม่ได้ลงท้ายด้วย \ หรือ /

หากคุณไม่มีสิทธิ์ของผู้ดูแลระบบ

1. คลิกขวาที่ "My Computer" แล้วเลือก "Properties"
2. คลิกแท็บ "ขั้นสูง"
3. คลิก "ตัวแปรสภาพแวดล้อม"
4. ตัวแปรผู้ใช้ "เพิ่ม" หรือ "แก้ไข": (แทนที่ตําแหน่งในเครื่องของคุณ)
• เพิ่มหรือแก้ไข ANT_HOME และกําหนดค่าเป็น C:\ant
• เพิ่มหรือแก้ไข JAVA_HOME และกําหนดค่าเป็น C:\jdk
• เพิ่มหรือแก้ไข Path และใส่ ;C:\ant\bin;C:\jdk\bin ต่อท้าย (อัฒภาคคั่นเส้นทางไดเรกทอรี)
• เพิ่มหรือแก้ไข CLASSPATH แล้วต่อท้ายไฟล์ .jar ที่ต้องใช้ โดยขึ้นอยู่กับบริการที่คุณต้องการใช้งาน ตรวจสอบว่า "." รวมอยู่ใน &mhash ซึ่งระบุไดเรกทอรีปัจจุบัน .;C:\gdata\java\lib\gdata-core-1.0.jar;C:\gdata\java\lib\gdata-calendar-1.0.jar เป็นต้น
5. รีบูตเพื่อให้แน่ใจว่าจะมีผล

หมายเหตุ: ตรวจสอบว่าตัวแปรไม่มีเครื่องหมายคําพูด (' หรือ ") และไม่ได้ลงท้ายด้วย \ หรือ /

ตัวแปรผู้ใช้ที่คุณเพิ่งแก้ไขจะมีผลกับโปรไฟล์ผู้ใช้เท่านั้น

Linux

1. เปิดไฟล์ .bash_profile ในเครื่องมือแก้ไขที่ต้องการ ซึ่งอยู่ในไดเรกทอรีหน้าแรก
2. เพิ่มโค้ดต่อไปนี้ลงใน .bash_profile โดยแทนที่ตําแหน่งจริงของไฟล์ในเครื่อง
• export ANT_HOME=/usr/local/ant
• export JAVA_HOME=/usr/local/jdk
• export PATH=${PATH}:${ANT_HOME}/bin
• คุณจะต้องเพิ่มไฟล์ .jar สําหรับบริการที่ต้องการใช้ เช่น export CLASSPATH=${CLASSPATH}:/home/username/gdata/java/lib/gdata-core-1.0.jar:/home/username/gdata/java/lib/gdata-calendar-1.0.jar:/home/username/gdata/java/sample/util/lib/sample-util.jar
3. source .bash_profile เพื่อสร้างตัวแปร

หมายเหตุ: ตรวจสอบว่าตัวแปรไม่มีเครื่องหมายคําพูด (' หรือ ") และไม่ได้ลงท้ายด้วย \ หรือ /