כדי להבטיח איכות גבוהה ועקביות עם ספריות Cloud האחרות, במאמרי העזרה של Storage Transfer Service נעשה עכשיו שימוש בספריות הלקוח של Cloud במקום בספריות הלקוח של Google API. במאמר הסבר על ספריות לקוח תוכלו לקרוא מידע נוסף על שתי האפשרויות.
ספריית הלקוח של Google API ממשיכה להתעדכן, אבל היא כבר לא מופיעה במסמכי התיעוד.
במדריך הזה נסביר על ההבדלים העיקריים שרלוונטיים לשימוש ב-Storage Transfer Service, ואיך לעדכן את הלקוחות כשעוברים לספריית הלקוח של Cloud.
Java
עדכון יחסי התלות
כדי לעבור לספרייה החדשה, צריך להחליף את יחסי התלות של google-api-services-storagetransfer ב-google-cloud-storage-transfer.
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-storage-transfer</artifactId>
<version>1.80.0</version>
</dependency>אם משתמשים ב-Gradle בלי BOM, צריך להוסיף אותו ליחסי התלות:
implementation 'com.google.cloud:google-cloud-storage-transfer:1.80.0'
אם משתמשים ב-Maven עם BOM, צריך להוסיף את הקוד הבא לקובץ pom.xml:
<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>
</dependencies>
ברוב המקרים, אפשר להמיר בקלות את הקוד מספריית הלקוח של לקוח ה-API לספריית הלקוח ב-Cloud. בהמשך מפורטים כמה הבדלים עיקריים בין שני לקוחות Java.
יצירת מופע של לקוח
ספריית הלקוח של Cloud מטפלת מאחורי הקלעים בהרבה מהקוד הגנרי שקשור ליצירת מופע של לקוח.
ספריית לקוח ל-API
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();
ספריית הלקוח של Cloud
StorageTransferServiceClient storageTransfer = StorageTransferServiceClient.create();
Builders למחלקות של מודלים
בספריית הלקוח של Cloud, במחלקות של המודלים משתמשים ב-builders במקום ב-constructors.
ספריית לקוח ל-API
TransferJob transferJob =
new TransferJob()
.setStatus("ENABLED");
ספריית הלקוח של Cloud
TransferJob transferJob =
TransferJob.newBuilder()
.setStatus(Status.ENABLED)
.build();
פעולות של רשימות מחזירות איטרבלים
פעולות של רשימות בספריית הלקוח ב-Cloud מחזירות איטרבלים פשוטים במקום התוצאות עם חלוקה לדפים בספריית הלקוח של ה-API.
ספריית לקוח ל-API
public class StoragetransferExample {
public static void main(String args[]) throws IOException, GeneralSecurityException {
Storagetransfer storagetransferService = createStoragetransferService();
Storagetransfer.TransferJobs.List request = storagetransferService.transferJobs().list();
ListTransferJobsResponse response;
do {
response = request.execute();
if (response.getTransferJobs() == null) {
continue;
}
for (TransferJob transferJob : response.getTransferJobs()) {
System.out.println(transferJob);
}
request.setPageToken(response.getNextPageToken());
} while (response.getNextPageToken() != null);
}
public static Storagetransfer createStoragetransferService()
throws IOException, GeneralSecurityException {
HttpTransport httpTransport = GoogleNetHttpTransport.newTrustedTransport();
JsonFactory jsonFactory = JacksonFactory.getDefaultInstance();
GoogleCredential credential = GoogleCredential.getApplicationDefault();
return new Storagetransfer.Builder(httpTransport, jsonFactory, credential)
.build();
}
}
ספריית הלקוח של Cloud
public class StoragetransferExample {
public static void main(String args[]) throws Exception {
StorageTransferServiceClient storageTransfer = StorageTransferServiceClient.create();
ListTransferJobsRequest request =
ListTransferJobsRequest.newBuilder().setFilter("{\"projectId\": \"my-project-id\"}").build();
for (TransferJob job : storageTransfer.listTransferJobs(request).iterateAll()) {
System.out.println(job);
}
}
}
השוואות לדוגמה
כאן אנחנו כוללים את הדוגמאות הישנות של לקוח ה-API, בהשוואה לדוגמאות המקבילות שלהן באמצעות ספריית הלקוח של Cloud. אם השתמשתם בדוגמאות האלה בעבר, אתם יכולים להשתמש בהשוואה הזו כדי להבין איך להעביר את הקוד לספריית הלקוח החדשה של Cloud.
העברה מ-Amazon S3
ספריית לקוח ל-API
ספריית הלקוח של Cloud
העברה ל-Nearline
ספריית לקוח ל-API
ספריית הלקוח של Cloud
בדיקת פעולת ההעברה האחרונה
ספריית לקוח ל-API
ספריית הלקוח של Cloud
Python
עדכון יחסי התלות
כדי להשתמש בספרייה החדשה, צריך להוסיף תלות ב-google-cloud-storage-transfer.
הוא ישמש במקום לקוח הגילוי מ-google-api-python-client.
pip install --upgrade google-cloud-storage-transfer
יצירת מופע של לקוח
משתמשים במודול storage_transfer במקום במודול googleapiclient.discovery.
ספריית לקוח ל-API
ספריית הלקוח של Cloud
השוואות לדוגמה
כדי להמחיש את ההבדלים בין שתי הספריות, הנה דוגמאות ללקוחות API ישנים לצד המקבילות שלהם בספריית הלקוח ב-Cloud.
העברה מ-Amazon S3
ספריית לקוח ל-API
ספריית הלקוח של Cloud
העברה ל-Nearline
ספריית לקוח ל-API
ספריית הלקוח של Cloud
שימו לב לייבוא של google.protobuf.duration_pb2.Duration.
בדיקת פעולת ההעברה האחרונה
ספריית לקוח ל-API
ספריית הלקוח של Cloud
שימו לב לשימוש ב-storage_transfer.TransferOperation.deserialize