Java 快速入门

此项目介绍了如何实现一个简单的 Glassware，用于演示 Google 镜像 API 的主要功能。

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

在 GitHub 上下载

前提条件

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

创建 Google API 控制台项目

接下来，启用 Google 镜像 API 的访问权限：

  1. 转到 Google API 控制台并创建新的 API 项目。
  2. 点击 Services，然后为新项目启用 Google 镜像 API。 Google API 控制台中的 Google 镜像 API
  3. 点击 API Access 并为 Web 应用创建 OAuth 2.0 客户端 ID。 Google API 控制台的“API Access”部分
  4. 指定您的 Glassware 产品名称和图标。这些字段会显示在向用户显示的 OAuth 授权屏幕上。指定品牌信息
  5. 选择 Web 应用，并为主机名指定任何值，例如 localhost 选择应用类型
  6. 点击客户端 ID 对应的修改设置...，以指定重定向 URI。为本地开发网络服务器（例如 http://localhost:8080/oauth2callback）和已部署的网络服务器（例如 https://example.com/oauth2callback）指定回调网址。 用于重定向 URI 的 Google API 控制台配置面板
  7. 记下 Google API 控制台中的客户端 ID 和密钥。您需要使用它来配置快速入门项目。 Google API 控制台中的客户端 ID 和密钥

配置快速入门项目

在 src/main/resources/oauth.properties 中输入客户端 ID 和密钥，将“快速入门”项目配置为使用您的 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. 点击文件 > 导入... > Maven > Existing Maven Project。
  3. 将光标指向提取的目录并导入项目。

运行本地开发服务器

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

$ mvn jetty:run

部署快速入门项目

您可以使用 Maven 为此项目构建战争文件：

$ mvn war:war