אפריל 2008
פלאגין Google Data APIs Java Client Eclipse : יצירת פרויקטים תוך שניות
כתוספת למאמר הזה, יש פלאגין של Eclipse כדי למזער את התקורה הכרוכה בהגדרת יחסי התלות של נתוני Google. הוא גם יוצר קוד שחוזר על עצמו כדי לבצע אינטראקציה עם ה-API שמעניין אתכם. כך אפשר להתחיל בקלות לפתח את ממשקי Google Data API.
מבוא
Eclipse הוא שימושי מאוד (ובחינם!) IDE שיש לו מקום מיוחד בלבם של מתכנתים רבים של Java. לכן זה לא מפתיע, שאולי כדאי לך להשתמש בו עם ספריית הלקוח של Java כדי ליצור אפליקציית Java קטלנית שפועלת עם אחד מממשקי ה-API של הנתונים של Google.
הגדרת ליקוי חמה
אם עוד לא התקנת את 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.
לאחר ההתקנה של ספריית הלקוח, הדבר הבא שצריך לעשות הוא להוריד קשרי תלות חיצוניים כדי שנוכל לכלול אותם בנתיב build של הפרויקט. הקובץ INSTALL-samples.txt מכיל רשימה של צנצנות כדי לגשת אליהן ולהוריד אותן. הרשימה הנוכחית היא:
| שם קובץ | מיקום |
|---|---|
| mail.gar | ה-JavaMail API של Sun |
| activation.gar | מסגרת ההפעלה JavaBeans של שמש |
| serverlet-api.gar | Apache Tomcat |
בדוגמה הזו, מתבצעת הורדה והעתקה של קובצי ה-JAR האלה אל /usr/local/eclipse/gdata/third_party.
וואו! עכשיו אתם צריכים לקבל את כל החלקים הדרושים כדי להתחיל לפתח אפליקציית Java שמשתמשת באחד מממשקי ה-API של Google Data. המשך לקרוא!
יצירת אפליקציה חדשה
השלב הראשון הוא לפתוח Eclipse ולבחור "חדש > פרויקט Java" בתפריט 'קובץ'.
עכשיו יש ללחוץ על 'הבא' ולבחור בכרטיסייה 'ספריות'. אפשר להוסיף את כל קובצי ה-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.
לסיום, תוכלו ללחוץ על 'סיום' וליצור את הפרויקט החדש.
כדי ליצור אפליקציית בדיקה פשוטה, יוצרים כיתה חדשה בשיטה ראשית. פשוט בוחרים באפשרות 'חדש > כיתה' בתפריט 'קובץ'.
עכשיו אדביק קוד מסוים מתוך המדריך למפתחים עבור ה-API של רשימת המסמכים.
יוצגו לך הרבה שגיאות עד להוספת הצהרות הייבוא המתאימות. Eclipse מאפשר לעשות זאת בקלות, וכל מה שצריך לעשות הוא ללחוץ על סמני השגיאה שמימין כדי לקבל תפריט שימושי להוספת פעולות ייבוא.
לאחר ניקוי הייבוא, עליך לטפל גם בחריגות שניתן להשליך על ידי הקוד שלנו. הדוגמה בוחרת להקיף את כל הקוד לדוגמה עם גורם חריג מאוד בסיסי.
כעת, אם תחליף את שם המשתמש והסיסמה בחשבון בדיקה חוקי שיצרת, אתה אמור לראות רשימה של מסמכים בבעלות חשבון בדיקה זה כשתבחר באפשרות "הפעל" מהתפריט 'הפעל'.
מעולה!
סיכום
עכשיו, כשיש לכם מכונה פעילה של Eclipse וכל קובצי JAR הנדרשים, אתם בדרך הנכונה לבניית אפליקציית Java נהדרת שפועלת עם אחד מממשקי ה-API של הנתונים של Google.
מה הלאה? הנה כמה קישורים שימושיים:
- פלאגין של ממשק API של Google Data APIs של Java Client Eclipse
- תיעוד של פרוטוקול Google Data בכתובת code.google.com
- פרויקט ספריית הלקוח Google Java Data
- מדריך לתחילת העבודה עבור ספריית הלקוח של Java
- מסמכי תיעוד של JavaDoc
Java הוא סימן מסחרי של Sun Microsystems, Inc. בארצות הברית ובמדינות אחרות.