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.