akka/akka-http

Document consuming multipart entities

Ouverte

#807 ouverte le 23 janv. 2017

Voir sur GitHubGuide contributeur
 (8 commentaires) (0 réaction) (0 personne assignée)Scala (598 forks)batch import
3 - in progresshackathonhelp wantedt:docs

Métriques du dépôt

Stars
 (1 311 étoiles)
Métriques de merge PR
 (Merge moyen 1j 10h) (2 PRs mergées en 30 j)

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.

Guide contributeur

Direction de recherche
Passez en revue la documentation actuelle pour le traitement des parties multiples côté serveur et client, puis ajoutez des sections couvrant l'utilisation de Unmarshal, les sous classes de Multipart, la nature flux de flux des parties et les considérations de blocage de tête de ligne.
Stack technique
Aucun
Domaine
backend
Type d'issue
Documentation
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
2
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
1-3 heures
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
Git
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
75