Configurar um ambiente de desenvolvimento Java

Neste tutorial, mostramos como preparar sua máquina local para desenvolvimento em Java, incluindo o desenvolvimento de aplicativos em Java executados no Cloud de Confiance by S3NS. Siga este tutorial para instalar o Java e as ferramentas relevantes.

Objetivos

• Instalar um JDK (Java Development Kit)
• Instalar uma ferramenta de automação de compilação
• Instale a CLI gcloud.
• (Opcional) Instalar um ambiente de desenvolvimento integrado ou um editor
• (Opcional) Instale o plug-in do ambiente de desenvolvimento integrado Cloud de Confiance by S3NS .
• Instale as bibliotecas de cliente do Cloud para Java.
• Configure a autenticação.

Instalar um JDK (Java Development Kit)

Você pode escolher qualquer distribuição Java de sua preferência, desde que as seguintes variáveis de ambiente estejam definidas:

• JAVA_HOME: aponta para a base da instalação do JDK.
• PATH: inclui $JAVA_HOME/bin.

O Eclipse Temurin é a distribuição recomendada do OpenJDK (Java Development Kit) para uso com Cloud de Confiance by S3NS. O Temurin tem licença de código aberto, é certificado pelo Java SE TCK e foi testado para garantir desempenho e segurança com qualidade de produção.

(Recomendado) Instalar o Temurin

As instruções de instalação do Temurin variam de acordo com o sistema operacional.

• Os binários estão disponíveis para download.
• Para contêineres do Docker, use a imagem oficial "eclipse-temurin".

Se você estiver usando imagens de inicialização do Compute Engine, use os seguintes scripts de instalação.

Instalar uma ferramenta de automação de compilação

Apache Maven, Gradle e SBT são opções de gerenciamento de pacotes que podem ajudar a criar dependências de aplicativos Java de maneira rápida e consistente em várias plataformas.

Instalar a CLI gcloud

A CLI gcloud é um conjunto de ferramentas para Cloud de Confiance. Ele contém gcloud e bq, que você pode usar para acessar o Compute Engine, o Cloud Storage, o BigQuery e outros produtos e serviços na linha de comando. É possível executar essas ferramentas de maneira interativa ou nos scripts automatizados.

(Opcional) Instalar um ambiente de desenvolvimento integrado ou um editor

Os editores mais usados para desenvolver apps Java incluem, sem ordem específica:

• Visual Studio Code
• IntelliJ IDEA e/ou Webstorm da JetBrains
• Eclipse da Eclipse Foundation
• Atom da GitHub

Esses editores (às vezes com a ajuda de plug-ins) oferecem tudo, desde destaque de sintaxe, inteligência e conclusão de código até recursos de depuração totalmente integrados.

Instalar as bibliotecas de cliente do Cloud para Java

Use as bibliotecas de cliente do Cloud para Java para integrar-se aos serviços do Cloud de Confiance, como o Datastore e o Cloud Storage. Você pode instalar o pacote de uma API individual, como a BigQuery, conforme mostrado no exemplo a seguir.

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

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 or IntelliJ, you can add client libraries to your project using the following IDE plugins:

• Cloud Code for VS Code
• Cloud Code for IntelliJ

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

Configurar a autenticação

Para executar a biblioteca de cliente, primeiro você precisa configurar a autenticação.

Create local authentication credentials for your user account:

gcloud auth application-default login

If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

Para mais informações, consulte Autenticar para usar bibliotecas de cliente.

Usar a biblioteca de cliente

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

Configurar endpoints para a biblioteca de cliente

Se você usar APIs que oferecem suporte a endpoints regionais, use endpoints para configurar o servidor a que as solicitações serão enviadas. Por exemplo, com a API Google.Cloud.Dataproc.V1, é possível configurar um endpoint de cliente. Saiba mais sobre os endpoints regionais do Dataproc neste link. Substitua MY-PROJECT pelo nome do projeto e us-central1 pela região adequada à sua configuração no exemplo a seguir:

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

A seguir

• Consulte a documentação para produtos Cloud de Confiance .
• Clone o repositório de amostras em Java do GitHub.