本文說明如何搭配使用直接上傳和支援續傳的媒體檔案: 適用於 Java 的 Google API 用戶端程式庫
支援續傳的媒體上傳作業
將大型媒體檔案上傳至伺服器時,請使用支援續傳的媒體檔案進行以下作業: 分批傳送檔案Google API 產生的程式庫包含 以便與支援續傳的媒體上傳作業互動的便利方法。
支援續傳的媒體上傳通訊協定與支援續傳的媒體上傳作業相似 通訊協定 (詳情請參閱 Google Drive API 說明文件) 中所述。
通訊協定設計
以下是支援續傳的媒體上傳通訊協定的運作方式:
實作詳情
主要類別為 MediaHttpUploader 和 MediaHttpProgressListener。
如果服務專屬產生程式庫中的方法包含 mediaUpload
參數加入探索文件中,
反而為這些方法建立方便好用的方法
InputStreamContent
做為參數(如要進一步瞭解如何透過 Google API 使用媒體上傳功能,
探索服務,請參閱
媒體上傳)。
例如 Drive API 的 insert
方法。
支援 mediaUpload
,而且您可以使用以下程式碼上傳檔案:
class CustomProgressListener implements MediaHttpUploaderProgressListener { public void progressChanged(MediaHttpUploader uploader) throws IOException { switch (uploader.getUploadState()) { case INITIATION_STARTED: System.out.println("Initiation has started!"); break; case INITIATION_COMPLETE: System.out.println("Initiation is complete!"); break; case MEDIA_IN_PROGRESS: System.out.println(uploader.getProgress()); break; case MEDIA_COMPLETE: System.out.println("Upload is complete!"); } } } File mediaFile = new File("/tmp/driveFile.jpg"); InputStreamContent mediaContent = new InputStreamContent("image/jpeg", new BufferedInputStream(new FileInputStream(mediaFile))); mediaContent.setLength(mediaFile.length()); Drive.Files.Insert request = drive.files().insert(fileMetadata, mediaContent); request.getMediaHttpUploader().setProgressListener(new CustomProgressListener()); request.execute();
即使沒有特定服務,你也可以使用支援續傳的媒體上傳功能 產生的程式庫範例如下:
File mediaFile = new File("/tmp/Test.jpg"); InputStreamContent mediaContent = new InputStreamContent("image/jpeg", new BufferedInputStream(new FileInputStream(mediaFile))); mediaContent.setLength(mediaFile.length());MediaHttpUploader uploader = new MediaHttpUploader(mediaContent, transport, httpRequestInitializer); uploader.setProgressListener(new CustomProgressListener()); HttpResponse response = uploader.upload(requestUrl); if (!response.isSuccessStatusCode()) { throw GoogleJsonResponseException(jsonFactory, response); }
直接上傳媒體
支援續傳的媒體上傳功能預設為啟用,但您可以將其停用,然後改用 直接上傳媒體內容,例如您上傳小檔案時。直達 1.9.0-beta 版導入媒體上傳功能 適用於 Java 的 Google API 用戶端程式庫版本。
直接上傳媒體會透過一個 HTTP 要求上傳整個檔案,而不是 支援續傳的媒體上傳通訊協定,可透過多個要求上傳檔案。 直接上傳會減少 HTTP 要求的數量,但這麼做會增加 可能發生在 上傳。
直接媒體上傳的使用方式與上述 支援續傳的媒體上傳作業,以及下列向 MediaHttpUploader 的呼叫 只允許直接上傳
mediaHttpUploader.setDirectUploadEnabled(true);