设置 Java 开发环境

本教程介绍如何为 Java 开发（包括开发在 Google Cloud 上运行的 Java 应用）准备本地机器。请按照本教程安装 Java 及相关工具。

目标

安装 JDK（Java 开发工具包）。
安装构建自动化工具。
（可选）安装 IDE 或编辑器。
（可选）安装 IDE Cloud SDK 插件。
安装 Cloud SDK。
安装 Java 版 Google Cloud 客户端库。

安装 JDK（Java 开发工具包）

安装 OpenJDK 11 或 OpenJDK 8 发行版。下面列出了您可以使用的一些发行版：

SdkMan：用于管理多个 SDK 的工具，包括多个 OpenJDK、Maven 和 Gradle。
由 RedHat 构建的 AdoptOpenJDK OpenJDK 版本。
祖鲁社区版本：OpenJDK 的祖鲁社区版本。
jdk.java.net：Oracle 提供的 Java 开发工具包版本。

确保已设置以下环境变量：

JAVA_HOME：指向 JDK 安装的基础。
PATH：包含 $JAVA_HOME/bin。

安装构建自动化工具

Apache Maven、Gradle 和 SBT 是软件包管理选项，可帮助快速且一致地跨平台构建 Java 应用依赖项。

安装 Cloud SDK

Cloud SDK 是一套适用于 Google Cloud 的工具。它包含可用于通过命令行访问 Compute Engine、Cloud Storage、BigQuery 以及其他产品和服务的 gcloud、gsutil 和 bq。这些工具既能以交互方式使用，也可以在自动化脚本中运行。

（可选）安装 IDE 或编辑器

用于开发 Java 应用的热门编辑器（排名不分先后）包括但不限于：

Eclipse 基金会的 Eclipse
JetBrains 的 IntelliJ IDEA 和/或 Webstorm
GitHub 的 Atom

这些编辑器（有时借助于插件）可为您提供从语法突出显示、智能感知、代码补全到完全集成式调试功能的所有能力。

（可选）安装 IDE Cloud SDK 插件

要访问编辑器中的有用功能，请查看 Google 为 Eclipse 或 IntelliJ 赞助的插件。

使用 Java 版 Google Cloud 客户端库

使用 Java 版 Google Cloud 客户端库与 Google Cloud 服务（例如 Datastore 和 Cloud Storage）集成。您可以为个别 API 安装软件包（如 BigQuery），如以下示例所示。

安装客户端库

如果您使用的是 Maven，请将以下代码添加到您的 pom.xml 文件中。如需详细了解 BOM，请参阅 Google Cloud Platform 库 BOM。

<!--  Using libraries-bom to manage versions.
See https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM -->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>16.2.1</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-bigquery</artifactId>
  </dependency>

如果您使用的是 Gradle，请将以下代码添加到您的依赖项中：

implementation platform('com.google.cloud:libraries-bom:16.2.1')

compile 'com.google.cloud:google-cloud-bigquery'

如果您使用的是 sbt，请将以下代码添加到您的依赖项中：

libraryDependencies += "com.google.cloud" % "google-cloud-bigquery" % "1.126.3"

如果您使用的是 IntelliJ 或 Eclipse，请通过以下 IDE 插件将客户端库添加到您的项目中：

上述插件还提供其他功能，例如服务帐号密钥管理。如需了解详情，请参阅各个插件相应的文档。

设置身份验证

要运行客户端库，您必须先设置身份验证。

使用客户端库

在 GitHub 上查看反馈

// Imports the Google Cloud client library
import com.google.cloud.bigquery.BigQuery;
import com.google.cloud.bigquery.BigQueryOptions;
import com.google.cloud.bigquery.Dataset;
import com.google.cloud.bigquery.DatasetInfo;

public class QuickstartSample {
  public static void main(String... args) throws Exception {
    // Instantiate a client. If you don't specify credentials when constructing a client, the
    // client library will look for credentials in the environment, such as the
    // GOOGLE_APPLICATION_CREDENTIALS environment variable.
    BigQuery bigquery = BigQueryOptions.getDefaultInstance().getService();

    // The name for the new dataset
    String datasetName = "my_new_dataset";

    // Prepares a new dataset
    Dataset dataset = null;
    DatasetInfo datasetInfo = DatasetInfo.newBuilder(datasetName).build();

    // Creates the dataset
    dataset = bigquery.create(datasetInfo);

    System.out.printf("Dataset %s created.%n", dataset.getDatasetId().getDataset());
  }
}

后续步骤

（可选）为 App Engine 使用 Maven 或 Gradle 插件

如果您在 App Engine 标准或柔性环境中开发，可以使用 Apache Maven 和 Gradle 构建工具的插件，这些插件为直接开发、测试和部署应用提供了便捷的功能。

针对 App Engine 标准环境

在 App Engine 标准环境中使用 Maven App Engine 插件或 Gradle 插件。

针对 App Engine 柔性环境

在 App Engine 柔性环境中使用 Maven App Engine 插件或 Gradle 插件。