Uploads de mídia diretos e retomáveis

Este documento descreve como usar uploads de mídia diretos e retomáveis com a biblioteca de cliente das APIs do Google para Java.

Upload de mídia retomável

Ao fazer o upload de um arquivo de mídia grande para um servidor, use o upload de mídia retomável para enviar o arquivo bloco por bloco. As bibliotecas geradas pela API do Google contêm métodos de conveniência para interagir com o upload de mídia retomável.

O protocolo de upload de mídia retomável é semelhante ao upload de mídia retomável descrito na documentação da API Google Drive.

Elaboração do protocolo

O diagrama de sequência a seguir mostra como o protocolo de upload de mídia retomável funciona:

Detalhes da implementação

As principais classes de interesse são MediaHttpUploader e MediaHttpProgressListener.

Se os métodos nas bibliotecas geradas específicas de serviço contiverem o mediaUpload no documento de descoberta, um método de conveniência é criado para esses métodos que usa uma InputStreamContent como parâmetro. (Para mais informações sobre como usar o upload de mídia com as APIs do Google serviço de descoberta, consulte Upload de mídia.

Por exemplo, o método insert da API Drive. oferece suporte a mediaUpload, e você pode usar o seguinte código para fazer upload de um arquivo:

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

Você também pode usar o recurso de upload de mídia retomável sem a configuração bibliotecas geradas automaticamente. Exemplo:

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

Upload direto de mídia

O upload de mídia retomável está ativado por padrão, mas é possível desativá-lo e usá-lo upload de mídia direto, por exemplo, se você estiver fazendo upload de um arquivo pequeno. Direto o upload de mídia foi introduzido na 1.9.0-beta da biblioteca de cliente das APIs do Google para Java.

O upload de mídia direto envia todo o arquivo em uma solicitação HTTP, em vez de o protocolo de upload de mídia retomável, que faz upload do arquivo em várias solicitações. Fazer um upload direto reduz o número de solicitações HTTP, mas aumenta o probabilidade de falhas (como falhas de conexão) que podem ocorrer com grandes de conteúdo.

O uso para upload de mídia direto é o mesmo descrito acima para upload de mídia retomável, além da chamada a seguir que informa ao MediaHttpUploader para fazer apenas envios diretos:

mediaHttpUploader.setDirectUploadEnabled(true);