akka/akka-http

Document consuming multipart entities

Aberta

#807 aberto em 23 de jan. de 2017

Ver no GitHubGuia do colaborador
 (8 comentários) (0 reação) (0 responsável)Scala (598 forks)batch import
3 - in progresshackathonhelp wantedt:docs

Métricas do repositório

Stars
 (1.311 estrelas)
Métricas de merge de PR
 (Mesclagem média 1d 10h) (2 fundiu PRs em 30d)

Description

Not only for the server-side (i.e. for consuming file-uploads) but also for the client-side where servers may return multipart/byteranges or other multipart datastructures.

Information it should contain:

  • how to use Unmarshal(response / entity).to[Multipart.General]
  • other subclasses of Multipart
  • explain stream-of-streams nature of Multipart.parts and Multipart.BodyPart.entity.dataBytes
  • note about head-of-line blocking: the data of a part needs to be read fully before a new part will be dispatched. Just filtering parts can deadlock a stream.

Guia do colaborador

Direção de pesquisa
Revise a documentação atual para manipulação de multipartes tanto no lado do servidor quanto no cliente, e adicione seções cobrindo o uso de Unmarshal, subclasses de Multipart, natureza stream of streams das partes e considerações de bloqueio head of line.
Pilha de tecnologia
None
Domain
backend
Tipo Issue
Documentação
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-3 horas
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
Git
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
75