Dekodowanie i modyfikacja jako multipart/form-data
HTTP multipart/form-data to format danych składający się z wielu części, często używany w żądaniach klient-serwer z przesyłaniem plików.
W formacie multipart/form-data każdy element formularza składa się z niezależnej części, a części są rozdzielane boundary. Każda część może zawierać nagłówek z powiązaną treścią, np. tekst, dane binarne itd. Nagłówki zwykle zawierają słowa kluczowe takie jak Content-Disposition i Content-Type opisujące typ, nazwę i kodowanie części, a ciałem są właściwe dane.
Poniżej przykład formatu danych multipart/form-data:
POST /submit-form HTTP/1.1
Host: example.com
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Length: 248
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="text"
Hello World!
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="image"; filename="example.png"
Content-Type: image/png
(binary data)
------WebKitFormBoundary7MA4YWxkTrZu0gW--
Powyższy przykład pokazuje żądanie multipart/form-data zawierające dwa elementy formularza: text i image. Element text to zwykły tekst, natomiast element image zawiera plik o nazwie example.png. Dane tekstu i pliku znajdują się w różnych częściach, a każda część ma własne content-type, nazwę i treść.
Podczas przepisywania name i filename w regułach przepisywania odpowiadają name i filename z Content-Disposition. Hodor obsługuje wyłącznie modyfikację name i powiązanej treści.