Zur Cloud-Clientbibliothek des Storage Transfer Service migrieren

Um eine hohe Qualität zu gewährleisten und mit unseren anderen Cloud-Bibliotheken konsistent zu sein, wird in der Dokumentation für den Storage Transfer Service jetzt die Cloud-Clientbibliotheken anstelle der Google API-Clientbibliotheken verwendet. Weitere Informationen zu den beiden Optionen finden Sie unter Erläuterung zu Clientbibliotheken.

Die Google API-Clientbibliothek wird weiterhin aktualisiert, wird aber nicht mehr in der Dokumentation erwähnt.

In dieser Anleitung werden die wichtigsten Unterschiede bei der Verwendung von Storage Transfer Service beschrieben. Außerdem finden Sie hier eine Anleitung zum Aktualisieren Ihrer Clients bei der Migration zur Cloud-Clientbibliothek.

Java

Abhängigkeiten aktualisieren

Wenn Sie zur neuen Bibliothek wechseln möchten, ersetzen Sie die Abhängigkeit von google-api-services-storagetransfer durch google-cloud-storage-transfer.

<dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-storage-transfer</artifactId>
    <version>0.2.3</version>
</dependency>

Wenn Sie Gradle ohne BOM verwenden, fügen Sie Ihren Abhängigkeiten Folgendes hinzu:

implementation 'com.google.cloud:google-cloud-storage-transfer:0.2.3'

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>24.1.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

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

Der Code kann größtenteils recht einfach von der API-Clientbibliothek in die Cloud-Clientbibliothek konvertiert werden. Im Folgenden werden einige wichtige Unterschiede zwischen den beiden Java-Clients aufgeführt.

Client-Instanziierung

Die Cloud-Clientbibliothek reduziert einen Großteil des Boilerplate-Codes, der mit der Clientinstanziierung verbunden ist, da sie ihn im Hintergrund verarbeitet.

GoogleCredentials credential = GoogleCredentials.getApplicationDefault();
if (credential.createScopedRequired()) {
 credential = credential.createScoped(StoragetransferScopes.all());
}
Storagetransfer storageTransfer = new Storagetransfer.Builder(Utils.getDefaultTransport(),
   Utils.getDefaultJsonFactory(), new HttpCredentialsAdapter(credential))
   .build();

StorageTransferServiceClient storageTransfer = StorageTransferServiceClient.create();

Builder für Modellklassen

Modellklassen in der Cloud-Clientbibliothek verwenden Builder anstelle von Konstruktoren.

TransferJob transferJob =
   new TransferJob()
       .setStatus("ENABLED");

TransferJob transferJob =
   TransferJob.newBuilder()
       .setStatus(Status.ENABLED)