Este documento descreve como usar uploads de mídia diretos e retomáveis com a biblioteca de cliente da API 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 fragmentado. As bibliotecas geradas pela API do Google contêm métodos práticos para interagir com o upload de mídia retomável.
O protocolo de upload de mídia retomável é semelhante ao protocolo descrito na documentação da API Google Drive.
Design de protocolo
O diagrama de sequência a seguir mostra como funciona o protocolo de upload de mídia retomável:
Detalhes da implementação
As principais classes de interesse são MediaHttpUploader e MediaHttpProgressListener.
Se os métodos nas bibliotecas geradas específicas do serviço contiverem o parâmetro mediaUpload
no documento de descoberta,
um método de conveniência será criado para esses métodos e receberá um
InputStreamContent
como parâmetro. Para saber mais sobre como usar o upload de mídia com o serviço de descoberta de
APIs do Google, consulte
Upload de mídia.
Por exemplo, o método insert
da API Drive é compatível com mediaUpload
, e você pode usar o código a seguir 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();
Também é possível usar o recurso de upload de mídia retomável sem as bibliotecas geradas específicas do serviço. Confira um 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 é ativado por padrão, mas é possível desativá-lo e usar o upload de mídia direto, por exemplo, se você estiver enviando um arquivo pequeno. O upload de mídia direto foi introduzido na versão 1.9.0-beta da biblioteca de cliente da API do Google para Java.
O upload direto de mídia faz upload de todo o arquivo em uma solicitação HTTP, ao contrário do 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 a chance de falhas (como falhas de conexão) que podem acontecer com uploads grandes.
O uso para o upload de mídia direto é o mesmo descrito acima para uploads de mídia retomáveis, além da chamada a seguir que instrui o MediaHttpUploader a fazer apenas uploads diretos:
mediaHttpUploader.setDirectUploadEnabled(true);