设置 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 MavenGradleSBT 是软件包管理选项,可帮助快速且一致地跨平台构建 Java 应用依赖项。

安装 Cloud SDK

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

(可选)安装 IDE 或编辑器

用于开发 Java 应用的热门编辑器(排名不分先后)包括但不限于:

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

(可选)安装 IDE Cloud SDK 插件

要访问编辑器中的有用功能,请查看 Google 为 EclipseIntelliJ 赞助的插件。

使用 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>13.1.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

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

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

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

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

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

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

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

设置身份验证

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

使用客户端库

// 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 插件

其他资源