Java 快速入門

本專案會說明如何 展示 Google Mirror API 主要功能的 Glassware。

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

前往 GitHub 下載

必要條件

確認您的系統符合快速入門專案的下列必要條件：

  • Java 1.6 版
  • Apache Maven - 用於建構程序的一部分。

建立 Google API 控制台專案

接著，啟用 Google Mirror API 的存取權：

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

設定快速入門專案

設定「快速入門」專案以使用您的 API 用戶端資訊，方法是輸入您的用戶端 ID，並 將密鑰放入 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

匯入專案

以下操作說明會說明如何將 Quick Start 專案來源匯入 IntelliJ，並 Eclipse。

IntelliJ

  1. 按一下「檔案」>匯入專案...。
  2. 指向擷取的目錄。
  3. 選取「從現有模型匯入」>「匯入模型」Maven

Eclipse

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

執行本機開發伺服器

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

$ mvn jetty:run

部署「快速入門」專案

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

$ mvn war:war