Java 開発環境を設定する

このチュートリアルでは、 Java 開発用のローカルマシンを準備する方法を説明します。これには、 Cloud de Confiance by S3NSで動作する Java アプリの開発も含まれます。Java と関連ツールをインストールする手順は次のとおりです。

目標

• JDK（Java Development Kit）をインストールする
• ビルド自動化ツールをインストールする
• gcloud CLI をインストールする
• （オプション）IDE またはエディタをインストールする
• （オプション）IDE Cloud de Confiance by S3NS プラグインをインストールする
• Java 用 Cloud クライアント ライブラリをインストールする
• 認証を設定する。

JDK（Java Development Kit）をインストールする

次の環境変数が設定されていることを確認して、任意の Java ディストリビューションを選択できます。

• JAVA_HOME: JDK インストールのベースを指します。
• PATH: $JAVA_HOME/bin が含まれます。

Eclipse Temurin は、 Cloud de Confiance by S3NSで使用する推奨の OpenJDK（Java Development Kit）ディストリビューションです。Temurin はオープンソース ライセンスで提供され、Java SE TCK 認定を受けており、本番環境品質のパフォーマンスとセキュリティを確保するためにテストされています。

（推奨）Temurin をインストールする

Temurin のインストール手順は、オペレーティング システムによって異なります。

• バイナリをダウンロードできます。
• Docker コンテナの場合は、公式の「eclipse-temurin」イメージを使用します。

Compute Engine ブートイメージを使用している場合は、次のインストール スクリプトを使用できます。

ビルド自動化ツールをインストールする

Apache Maven、 Gradle、 および SBT は、プラットフォーム間で迅速かつ一貫性のある Java アプリの依存関係を構築するのに役立つパッケージ管理オプションです。

gcloud CLI をインストールする

gcloud CLI は、のための一連のツールです Cloud de Confiance。これには、コマンドラインから Compute Engine、Cloud Storage、BigQuery、その他のプロダクトやサービスにアクセスするために使用される gcloud と bq が含まれます。これらのツールはインタラクティブに実行することも、自動スクリプトで実行することもできます。

（オプション）IDE またはエディタをインストールする

Java アプリの開発に広く使用されているエディタの一部を以下に示します（順不同）。

• Visual Studio Code
• IntelliJ IDEA または Webstorm （JetBrains）
• Eclipse （Eclipse Foundation）
• Atom（ GitHub）

これらのエディタには、構文のハイライト表示、インテリセンス、コード補完から完全な統合デバッグ機能まで、豊富な機能が用意されています（プラグインが必要になる場合もあります）。

Java 用 Cloud クライアント ライブラリをインストールする

Java 用 Cloud クライアント ライブラリ を使用して、 Cloud de Confiance Datastore や Cloud Storage などのサービスと統合します。次の例に示すように、BigQuery などの個別の API のパッケージをインストールできます。

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>26.62.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>

Gradle を使用している場合は、次のものを依存関係に追加します。

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

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

sbt を使用している場合は、 次のものを依存関係に追加します。

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

Visual Studio Code または IntelliJ を使用している場合は、次の IDE プラグインでプロジェクトにクライアント ライブラリを 追加できます。

• Cloud Code for VS Code
• Cloud Code for IntelliJ

プラグインでは、サービス アカウントのキー管理などの追加機能も提供されます。詳細は各プラグインのドキュメントをご覧ください。

認証を設定する

クライアント ライブラリを実行するには、まず認証を設定する必要があります。

ユーザーアカウントのローカル認証情報を作成します。

gcloud auth application-default login

認証エラーが返され、外部 ID プロバイダ （IdP）を使用している場合は、 フェデレーション ID で gcloud CLI にログインしていることを確認します。

詳細については、 クライアント ライブラリを使用して認証するをご覧ください。

クライアント ライブラリの使用

// 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());
  }
}

クライアント ライブラリのエンドポイントを構成する

リージョン エンドポイントをサポートする API を使用する場合は、エンドポイントを使用して、リクエストを送信するサーバーを構成します。たとえば、Google.Cloud.Dataproc.V1 API を使用して、クライアント エンドポイントを構成できます。Dataproc のリージョン エンドポイントの詳細については、こちらをご覧ください。次の例では、MY-PROJECT は実際のプロジェクト名に、us-central1 は構成に適したリージョンに置き換えてください。

ClusterControllerSettings settings =
     ClusterControllerSettings.newBuilder()
        .setEndpoint("us-central1-dataproc.googleapis.com:443")
        .build();
 try (ClusterControllerClient clusterControllerClient = ClusterControllerClient.create(settings)) {
   String projectId = "MY-PROJECT";
   String region = "us-central1";
   Cluster cluster = Cluster.newBuilder().build();
 }

次のステップ

• プロダクトの ドキュメント Cloud de Confiance を参照する。
• GitHub から Java サンプル レポジトリのクローンを作成する。