Estou com uma dúvida a quase um mês sobre o assunto. Em determinada para do meu aplicativo, o usuário pode enviar um upload para uma biblioteca de arquivos.
Esse upload precisa ser registrando numa tabela chamada midias
, onde, além do caminho do arquivo, preciso também de dados extras, como nome, descrição, a permissão do arquivo, além das informações de metadados como tamanho e extensão do arquivo.
A dúvida que me surge nesse caso é a seguinte: Para o registro no banco de dados referente a esse arquivo, preciso também das outras informações. E, como as requisições geralmente usam o content-type JSON, fico me perguntando como seria feito então o envio do arquivo, já que o JSON possuim certa limitação quanto aos carateres que podem ser incluidos no mesmo.
Exemplo hipotético:
POST /api/midias/
Content-Type: application/json
{
"nome" : "Flor",
"descricao" : "A flor azul encontrada na
"tipo_acesso" : 1,
"extensao" : "jpg",
"tamanho" : 5225,
"arquivo" : ???????
}
Ou seja, de acordo com exemplo acima, para criação do recurso na minha API, além das informações da mídia, precisava também de envia o binário do arquivo, para fazer o upload.
Agora vamos aos problemas:
1) A primeira forma que tentei foi enviar o binário de um arquivo via JSON
mesmo, convertendo o binário do arquivo para base64
.
O problema do base64 é que ele aumenta (e muito) o tamanho do arquivo, tornando inviável no meu caso, já que vamos permitir upload de vídeos.
2) Usar o multipart/form-data
, enviando o arquivo normalmente, como se faz em requisições de formulário, e anexando os outros dados citados anteriormente num campo "json"
, enviando esses dados como uma string JSON
(serializado).
Exemplo:
POST / HTTP/1.1
Host: localhost:8000
User-Agent: Mozilla/5.0 (X11; Ubuntu; Linux i686; rv:29.0) Gecko/20100101 Firefox/29.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: en-US,en;q=0.5
Accept-Encoding: gzip, deflate
Cookie: __atuvc=34%7C7; permanent=0; _gitlab_session=226ad8a0be43681acf38c2fab9497240; __profilin=p%3Dt; request_method=GET
Connection: keep-alive
Content-Type: multipart/form-data; boundary=---------------------------9051914041544843365972754266
Content-Length: 554
-----------------------------9051914041544843365972754266
Content-Disposition: form-data; name="json"
{"nome" : "Flor", "descricao" : "..."}
-----------------------------9051914041544843365972754266
Content-Disposition: form-data; name="file1"; filename="a.txt"
Content-Type: text/plain
Content of a.txt.
-----------------------------9051914041544843365972754266
Content-Disposition: form-data; name="file2"; filename="a.html"
Content-Type: text/html
<!DOCTYPE html><title>Content of a.html.</title>
-----------------------------9051914041544843365972754266--
Ao meu ver, isso foge do padrão que já está sendo usado em toda as outras requisições, que é o content-type: application/json
, além de ser uma gambiarra das bem porcas.
3) Separar a lógica de upload do arquivo do envio dos dados da midia.
Essa me pareceu a mais agradável e, pelo pouco que li e conversei sobre, me pareceu mais organizado. Porém eu nunca fiz nada parecido, não tendo experiência de implementação, e também não sei se isso se trata de um padrão em REST.
Um das dicas que vi, por exemplo, foi fazer o upload do arquivo, retornar o ID
desse upload, para ser utilizado no envio dos "dados extras" para criação do recurso no servidor referente a esse arquivo.
A minha dúvida é:
Das opções acima, qual delas seria mais próxima do REST?
Se caso seja viável implementar a terceira opção, existe algum padrão, para definir o
content-type
do arquivo e que tipo de status de resposta eu poderia devolver?
Gostaria de uns exemplos a respeito da terceira opção, já que de todas essas, foi a única que não implementei, e não tenho a mínima ideia de como fazer algo parecido.
id
desse "upload" para o usuário associá-lo ao "metadados" que precisaria ser enviado junto com o arquivo, Depois de criado os dados do recurso, moveria o arquivo no servidor para onde desejasse, já que a nova requisição informaria oid
desse arquivo e, em seguida, deletaria o recurso do arquivo antigo criado.