Java 快速入門

這個專案說明如何實作簡單的 Glassware 功能,並示範 Google Mirror API 的主要功能。

如要查看快速入門專案的完整運作範例,請前往 https://glass-python-starter-demo.appspot.com。否則,請繼續閱讀如何部署自己的版本。

前往 GitHub 下載

必要條件

確認您的系統符合快速入門專案的下列先決條件:

建立 Google API 控制台專案

接著,請啟用 Google Mirror API 的存取權:

  1. 前往 Google API 主控台,建立新的 API 專案。
  2. 按一下「Service」,然後為新專案啟用 Google Mirror API。 Google API 控制台中的 Google Mirror API
  3. 按一下 [API Access] (API 存取權),然後為網路應用程式建立 OAuth 2.0 用戶端 ID。 Google API 控制台的「API 存取」區段
  4. 指定 Glassware 的產品名稱與圖示。這些欄位會顯示在向使用者顯示的 OAuth 授權畫面上。 指定品牌資訊
  5. 選取「Web Application」,然後指定主機名稱的任何值,例如 localhost 選取應用程式類型
  6. 針對用戶端 ID 按一下 [Edit settings...],即可指定重新導向 URI。指定本機開發網路伺服器 (例如 http://localhost:8080/oauth2callback) 和已部署網路伺服器的回呼網址 (例如 https://example.com/oauth2callback)。Google API 主控台重新導向 URI 設定面板
  7. 在 Google API 控制台中記下用戶端 ID 和密鑰。您需要這個金鑰來設定快速入門專案。Google API 控制台中的用戶端 ID 和密鑰

設定快速入門專案

將用戶端 ID 和密鑰輸入至 src/main/resources/oauth.properties 以設定快速入門專案,以使用您的 API 用戶端資訊:

    # 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

匯入專案

以下操作說明將 QuickStart 專案來源匯入 IntelliJ 和 Eclipse。

IntelliJ

  1. 依序按一下 [File] (檔案) > [Import Project...] (匯入專案...)。
  2. 將滑鼠遊標移至擷取的目錄。
  3. 依序選取 [Import from existing model] (從現有模型匯入) > [Maven]

Eclipse

  1. 安裝 m2e 外掛程式即可從 Maven pom 檔案匯入。
  2. 按一下 [檔案] > [匯入...]。> [Maven] > [現有 Maven 專案]。
  3. 將滑鼠遊標移至擷取的目錄,然後匯入專案。

執行本機開發環境

您可以在本機開發伺服器執行「快速入門」專案,以進行測試:

$ mvn jetty:run

部署快速入門專案

您可以使用 Maven 為這項專案建立 war 檔案:

$ mvn war:war