Mercurial > hg > orthanc
view Resources/Samples/WebApplications/README.txt @ 2248:69b0f4e8a49b
Escape multipart type parameter value in Content-Type header
## Summary
Multipart responses do not quote/escape the value of their type
parameter (the subtype) even though it always contains at least one
special character (the slash "/"), which confuses standard-compliant
HTTP clients.
## Details
The Content-Type header in HTTP is in RFC 7231, Section 3.1.1.5:
https://tools.ietf.org/html/rfc7231#section-3.1.1.5
The section defers to the media type section (3.1.1.1) for the syntax of
the media type:
https://tools.ietf.org/html/rfc7231#section-3.1.1.1
This states that a parameter value can be quoted:
parameter = token "=" ( token / quoted-string )
A parameter value that matches the token production can be transmitted
either as a token or within a quoted-string. The quoted and unquoted
values are equivalent.
Tokens are defined in RFC 7230, Section 3.2.6 (via RFC 7231, appendix
C):
https://tools.ietf.org/html/rfc7231#appendix-C
https://tools.ietf.org/html/rfc7230#section-3.2.6
Here we observe that tokens cannot contain a slash "/" character:
token = 1*tchar
tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*"
/ "+" / "-" / "." / "^" / "_" / "`" / "|" / "~"
/ DIGIT / ALPHA
; any VCHAR, except delimiters
Delimiters are chosen from the set of US-ASCII visual characters not
allowed in a token (DQUOTE and "(),/:;<=>?@[\]{}").
However, the current implementation does not quote/escape the value of
the type parameter:
multipart/related; type=application/dicom
Instead, it should be:
multipart/related; type="application/dicom"
All of this also seems to apply to the MIME Content-Type header
definition, even though it is a little different:
https://www.iana.org/assignments/message-headers
https://tools.ietf.org/html/rfc2045#section-5.1
https://tools.ietf.org/html/rfc2387
| author | Thibault Nélis <tn@osimis.io> |
|---|---|
| date | Mon, 16 Jan 2017 13:07:11 +0100 |
| parents | 2f63c225c4c0 |
| children |
line wrap: on
line source
=================== GENERAL INFORMATION =================== This folder contains sample Web applications. These Web applications make use of NodeJs (http://nodejs.org/). To run the applications, you therefore need to install NodeJs on your computer. NodeJs acts here as a lightweight, cross-platform Web server that statically serves the HTML/JavaScript files and that dynamically serves the Orthanc REST API as a reverse proxy (to avoid cross-domain problems with AJAX). Once NodeJs is installed, start Orthanc with default parameters (i.e. HTTP port set to 8042), start NodeJs with the sample application you are interested in (e.g. "node DrawingDicomizer.js"). Then, open http://localhost:8000/ with a standard Web browser to try the sample application. ======================================= DRAWING DICOMIZER (DrawingDicomizer.js) ======================================= This sample shows how to convert the content of a HTML5 canvas as a DICOM file, using a single AJAX request to Orthanc. Internally, the content of the HTML5 canvas is serialized through the standard "toDataURL()" method of the canvas object. This returns a string containing the PNG image encoded using the Data URI Scheme (http://en.wikipedia.org/wiki/Data_URI_scheme). Such a string is then sent to Orthanc using the '/tools/create-dicom' REST call, that transparently decompresses the PNG image into a DICOM image.
