Java 快速入门

此项目将向您展示如何实现一个简单的 Glassware，以演示 Google Mirror API 的主要功能。

如需查看快速入门项目的功能完备的演示，请访问 https://glass-python-starter-demo.appspot.com。否则，请继续阅读以了解如何部署您自己的版本。

在 GitHub 上下载

前提条件

确保您的系统满足快速入门项目的以下前提条件：

创建 Google API 控制台项目

接下来，启用对 Google Mirror API 的访问权限：

  1. 转至 Google API 控制台并新建一个 API 项目。
  2. 点击服务，然后为新项目启用 Google Mirror API。 在 Google API 控制台中查看 Google Mirror API
  3. 点击 API 访问权限，然后为 Web 应用创建 OAuth 2.0 客户端 ID。 Google API 控制台的“API 访问权限”部分
  4. 指定 Glassware 的产品名称和图标。这些字段会显示在向用户显示的 OAuth 授权屏幕上。指定品牌信息
  5. 选择 Web 应用，然后为主机名指定任意值，例如 localhost 选择应用类型
  6. 点击客户端 ID 对应的 Edit settings... 可指定重定向 URI。为本地开发 Web 服务器指定回调网址（例如 http://localhost:8080/oauth2callback），为已部署的 Web 服务器指定回调网址（例如 https://example.com/oauth2callback）。重定向 URI 的 Google API 控制台配置面板
  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

导入项目

以下说明介绍了如何将快速入门项目源代码导入 IntelliJ 和 Eclipse。

IntelliJ

  1. 依次点击 File > Import Project...。
  2. 指向解压缩的目录。
  3. 选择从现有模型导入 > Maven。

Eclipse

  1. 安装 m2e 插件以启用从 Maven pom 文件导入。
  2. 点击 File > Import... > Maven > Existing Maven Project 菜单。
  3. 指向解压缩的目录并导入项目。

运行本地开发服务器

您可以在本地开发服务器上运行快速入门项目以进行测试：

$ mvn jetty:run

部署快速入门项目

您可以使用 Maven 为此项目构建一个 war 文件：

$ mvn war:war