上傳進度條 - SDK參考

進度條用於指示上傳或下載的進度。下面的代碼以ossClient.putObject方法為例，介紹如何使用進度條。

 
  public class PutObjectProgressListener implements ProgressListener {
      private long bytesWritten = 0;
      private long totalBytes = -1;
      private boolean succeed = false;
  
      @Override
      public void progressChanged(ProgressEvent progressEvent) {
          long bytes = progressEvent.getBytes();
          ProgressEventType eventType = progressEvent.getEventType();
          switch (eventType) {
          case TRANSFER_STARTED_EVENT:
              System.out.println("Start to upload......");
              break;
          case REQUEST_CONTENT_LENGTH_EVENT:
              this.totalBytes = bytes;
              System.out.println(this.totalBytes + " bytes in total will be uploaded to OSS");
              break;
          case REQUEST_BYTE_TRANSFER_EVENT:
              this.bytesWritten += bytes;
              if (this.totalBytes != -1) {
                  int percent = (int)(this.bytesWritten * 100.0 / this.totalBytes);
                  System.out.println(bytes + " bytes have been written at this time, upload progress: " + percent + "%(" + this.bytesWritten + "/" + this.totalBytes + ")");
              } else {
                  System.out.println(bytes + " bytes have been written at this time, upload ratio: unknown" + "(" + this.bytesWritten + "/...)");
              }
              break;
          case TRANSFER_COMPLETED_EVENT:
              this.succeed = true;
              System.out.println("Succeed to upload, " + this.bytesWritten + " bytes have been transferred in total");
              break;
          case TRANSFER_FAILED_EVENT:
              System.out.println("Failed to upload, " + this.bytesWritten + " bytes have been transferred");
              break;
          default:
              break;
          }
      }
  
      public boolean isSucceed() {
          return succeed;
      }
  
      public static void main(String[] args) {
          // Endpoint以杭州為例，其它Region請按實際情況填寫。
          String endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
          // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
          String accessKeyId = "<yourAccessKeyId>";
          String accessKeySecret = "<yourAccessKeySecret>";
          String bucketName = "<yourBucketName>";
          String objectName = "<yourObjectName>";
  
          // 建立OSSClient執行個體。
          OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret);
  
          try {
              // 帶進度條的上傳。
              ossClient.putObject(new PutObjectRequest(bucketName, objectName, new FileInputStream("<yourLocalFile>")).
                      <PutObjectRequest>withProgressListener(new PutObjectProgressListener()));
  
          } catch (Exception e) {
              e.printStackTrace();
          }
          // 關閉OSSClient。
          ossClient.shutdown();
      }
  }

ossClient.putObject、ossClient.getObject和ossClient.uploadPart方法支援進度條功能。ossClient.uploadFile和ossClient.downloadFile方法不支援進度條功能。

上傳進度條的完整代碼請參見GitHub。