אפריל 2008
New Google Data APIs Java Client Eclipse Plug-in : Create projects in seconds
בנוסף למאמר הזה, יש תוסף ל-Eclipse שמצמצם את התקורה שקשורה להגדרת יחסי התלות של Google Data. הוא גם יוצר קוד סטנדרטי לאינטראקציה עם ה-API שמעניין אתכם. כך תוכלו להתחיל בקלות לפתח באמצעות Google Data APIs.
מבוא
Eclipse היא סביבת פיתוח נוחה מאוד (ובחינם!) סביבת פיתוח משולבת (IDE) שאהובה על הרבה מתכנתי Java. לכן, לא מפתיע שתרצו להשתמש בו עם ספריית הלקוח של Java כדי ליצור אפליקציית Java מעולה שפועלת עם אחד מ-Google Data APIs.
הגדרת Eclipse
אם עדיין לא התקנתם את Eclipse, כדאי לכם לעשות את זה. Eclipse יכול להקל מאוד על פיתוח Java, כי הוא יכול להציע תיקונים, למצוא ייבוא חסר ולהשלים שיטות באופן אוטומטי. עוברים אל דף ההורדות באתר Eclipse.org כדי להוריד את תוכנת ההתקנה למערכת ההפעלה שלכם. כדי להריץ את Eclipse, צריך להתקין JRE, שאפשר לקשר אליו מדף ההורדות של Eclipse. אחרי שמתקינים את Eclipse, צריך ליצור סביבת עבודה. בדוגמאות האלה נעשה שימוש ב-/usr/local/eclipse/workspace.
התקנת הספריות הנדרשות
Eclipse מספקת הרבה פונקציות Java מוכנות לשימוש, כך שהתהליך הזה אמור להיות פשוט. קודם כול, צריך להוריד את הגרסה העדכנית של ספריית הלקוח של Java מדף ההורדות של הפרויקט. שימו לב שיש שתי הורדות נפרדות: אחת לדוגמאות ואחת לקוד המקור. כדאי להוריד את קובץ ה-ZIP של הדוגמאות, כי הוא כולל את קובצי ה-JAR המהודרים של ספריית הלקוח של Java שדרושים ליצירת תוכניות משלכם. אם אתם רוצים לדעת איך ספריית הלקוח עצמה פועלת, אתם יכולים להוריד את קובץ ה-ZIP של המקור ולעיין בו, אבל זה לא נושא המאמר הזה. אחרי שמורידים את קובץ ה-ZIP של הדוגמאות, צריך לבטל את הדחיסה של הקובץ לתיקייה נוחה שבה אפשר למצוא את הקבצים. בדוגמאות נעשה שימוש ב-/usr/local/eclipse. המשמעות היא שעכשיו אמורה להיות גישה לקובצי ה-JAR של הפרויקט בנתיב /usr/local/eclipse/gdata/java/lib.
אחרי שמתקינים את ספריית הלקוח, השלב הבא הוא להוריד כמה פריטים בקשרי תלות חיצוניים כדי שנוכל לכלול אותם בנתיב הבנייה של הפרויקט. קובץ INSTALL-samples.txt מכיל רשימה של קובצי JAR שדרושים לכם ומיקומים להורדה שלהם. הרשימה הנוכחית היא:
| שם קובץ | מיקום |
|---|---|
| mail.jar | Sun's JavaMail API |
| activation.jar | Sun's JavaBeans Activation Framework |
| servlet-api.jar | Apache Tomcat |
בדוגמה הזו, קובצי ה-JAR האלה מורדים ומועתקים אל /usr/local/eclipse/gdata/third_party.
איזה מזל! עכשיו אמורים להיות לכם כל הרכיבים שדרושים כדי להתחיל לפתח אפליקציית Java שמשתמשת באחד מממשקי Google Data API. לקריאה נוספת!
יצירת אפליקציה חדשה
השלב הראשון הוא לפתוח את Eclipse ולבחור באפשרות New > Java Project (חדש > פרויקט Java) בתפריט File (קובץ).
לוחצים על 'הבא' ובוחרים בכרטיסייה 'ספריות'. לוחצים על Add External JARs (הוספת קובצי JAR חיצוניים) כדי להוסיף את כל קובצי ה-JAR התלויים שהורדתם.
תצטרכו גם להוסיף את קובצי ה-JAR מספריית הלקוח של Java. הם נמצאים בספריית המשנה java/lib שבה חילצתם את ספריית הלקוח. תמיד צריך לכלול את קובצי ה-JAR הבאים: gdata-client, gdata-client-meta, gdata-core ו-gdata-media.
עכשיו בוחרים את ה-API שרוצים להשתמש בו. בדוגמה הזו נעשה שימוש ב-Google Documents List API. לשם כך צריך להוסיף את קובצי ה-JAR המתאימים: gdata-docs ו-gdata-docs-meta.
לבסוף, לוחצים על 'סיום' כדי ליצור את הפרויקט החדש.
כדי ליצור אפליקציית בדיקה פשוטה, יוצרים מחלקה חדשה עם שיטה ראשית על ידי בחירה באפשרות 'חדש > מחלקה' בתפריט 'קובץ'.
עכשיו אדביק קוד מתוך המדריך למפתחים של Documents List API.
יופיעו הרבה שגיאות עד שתוסיפו את הצהרות הייבוא המתאימות. ב-Eclipse זה קל מאוד. כל מה שצריך לעשות הוא ללחוץ על סמני השגיאות בצד ימין כדי לפתוח תפריט שימושי שמאפשר להוסיף ייבוא.
אחרי שמנקים את הייבוא, צריך גם לטפל בחריגים שהקוד שלנו יכול להחזיר. בדוגמה, הקוד כולו מוקף במטפל חריגים בסיסי מאוד.
עכשיו, בהנחה שהחלפתם את שם המשתמש והסיסמה בחשבון בדיקה תקין שיצרתם, תוכלו לראות רשימה של מסמכים שנמצאים בבעלות חשבון הבדיקה הזה כשתבחרו באפשרות 'הפעלה' בתפריט 'הפעלה'.
מעולה!
סיכום
עכשיו, כשיש לכם מופע פעיל של Eclipse וכל קובצי ה-JAR הנדרשים נמצאים במקום, אתם בדרך הנכונה ליצירת אפליקציית Java מדהימה שפועלת עם אחד מ-Google Data APIs.
לאן ממשיכים מכאן? הנה כמה קישורים שיכולים לעזור:
- Google Data APIs Java Client Eclipse Plug-in
- תיעוד של פרוטוקול הנתונים של Google בכתובת code.google.com
- פרויקט של ספריית לקוח Java של Google Data
- מדריך לתחילת השימוש בספריית הלקוח של Java
- מסמכי תיעוד של JavaDoc
Java הוא סימן מסחרי של Sun Microsystems, Inc. בארצות הברית ובמדינות אחרות.