התחלה מהירה ב-Java

בפרויקט הזה תראו איך להטמיע מודל חלק מ-Glassware שמדגים את הפונקציונליות העיקרית של Google Mirror API.

כדי לראות הדגמה תקינה של הפרויקט להתחלה מהירה, צריך לעבור אל https://glass-python-starter-demo.appspot.com. אם לא, כדאי להמשיך לקרוא כדי ללמוד איך לפרוס גרסה משלכם.

הורדה מ-GitHub

דרישות מוקדמות

צריך לוודא שהמערכת עומדת בדרישות המוקדמות הבאות של הפרויקט להתחלה מהירה:

  • Java 1.6
  • Apache Maven – משמש לחלק מתהליך ה-build.

יצירת פרויקט במסוף Google APIs

לאחר מכן, מאפשרים גישה ל-Google Mirror API:

  1. נכנסים אל מסוף Google APIs ויוצרים פרויקט API חדש.
  2. לוחצים על שירותים ומפעילים את Google Mirror API בפרויקט החדש. Google Mirror API במסוף Google API
  3. לוחצים על API Access (גישה ל-API) ויוצרים מזהה לקוח ב-OAuth 2.0 לאפליקציית אינטרנט. הקטע 'גישת API' במסוף Google API
  4. יש לציין את השם והסמל של המוצר Glassware. השדות האלה מופיעים בבקשת ה-OAuth של המסך שמוצג למשתמשים. ציון פרטי המותג
  5. בוחרים באפשרות Web application ומציינים ערך כלשהו עבור שם המארח, למשל localhost. בחירת סוג האפליקציה
  6. כדי לציין מזהי URI להפניה אוטומטית, לוחצים על עריכת הגדרות... עבור מזהה הלקוח. ציון כתובות ה-URL לקריאה חוזרת (callback) לשרת האינטרנט לפיתוח המקומי שלך, לדוגמה http://localhost:8080/oauth2callback, עבור שרת האינטרנט שנפרס, לדוגמה https://example.com/oauth2callback. חלונית ההגדרה של מסוף Google API למזהי URI להפניה אוטומטית
  7. מומלץ לרשום את מזהה הלקוח ואת הסוד ב-Google APIs Console. יש צורך כדי להגדיר את הפרויקט להתחלה מהירה. מזהה הלקוח והסוד במסוף Google API

הגדרת הפרויקט להתחלה מהירה

מגדירים לפרויקט 'התחלה מהירה' את השימוש בפרטי לקוח ה-API באמצעות הזנת מזהה הלקוח סוד ב-src/main/resources/oauth.properties:

    # Replace these with values for your project from the Google API Console:
    # https://developers.google.com/console

    client_id=3141592653589793238462643383279
    client_secret=ITS_A_SECRET_TO_EVERYBODY

ייבוא הפרויקט

בהוראות הבאות מוסבר לייבא את מקור הפרויקט 'התחלה מהירה' אל IntelliJ ליקוי חמה.

IntelliJ

  1. לוחצים על קובץ > ייבוא פרויקט...
  2. מצביעים על הספרייה שחולץ.
  3. בוחרים באפשרות ייבוא ממודל קיים > Maven

אקליפס

  1. כדאי להתקין את הפלאגין m2e כדי להפעיל ייבוא מקובץ maven pom.
  2. לוחצים על קובץ > ייבוא... > Maven > פרויקט Maven קיים.
  3. מצביעים על הספרייה שחולצה ומייבאים את הפרויקט.

הפעלת שרת פיתוח מקומי

אפשר להריץ את הפרויקט 'התחלה מהירה' בשרת פיתוח מקומי כדי לבצע בדיקות:

$ mvn jetty:run

פריסת הפרויקט להתחלה מהירה

אפשר ליצור קובץ מלחמה לפרויקט הזה באמצעות Maven:

$ mvn war:war