设置 Java 开发环境

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

提示：如果您想要快速上手，Cloud Shell Editor 会针对 Kubernetes 和 Cloud Run 应用的整个开发周期提供 IDE 支持。Cloud Shell Editor 基于 Eclipse Theia IDE 平台，并预安装了 Google Cloud CLI 和 Cloud Code 工具。

目标

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

安装 JDK（Java 开发套件）

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

  • SdkMan：管理多个 SDK 的工具，包括许多 OpenJDK、Maven 和 Gradle。
  • Eclipse Temurin：由 Eclipse Temurin 项目构建的 OpenJDK 构建版本。
  • Zulu 社区 build：OpenJDK 的 Zulu 社区 build。
  • jdk.java.net，来自 Oracle 的 Java 开发套件构建。

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

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

安装构建自动化工具

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

安装 gcloud CLI

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

（可选）安装 IDE 或编辑器

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

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

（可选）安装 IDE 插件

要在编辑器中访问有用的函数，请查看以下插件：

使用 Java 版 Google Cloud 客户端库

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

安装客户端库

If you are using Maven, add the following to your pom.xml file. For more information about BOMs, see The Google Cloud Platform Libraries 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>26.43.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

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

If you are using Gradle, add the following to your dependencies:

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

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

If you are using sbt, add the following to your dependencies:

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

If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

设置身份验证

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

使用客户端库

// 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 plugin 或 Gradle 插件。

适用于 App Engine 柔性环境

对于 App Engine 柔性环境，请使用 Maven App Engine plugin 或 Gradle 插件。

更多资源