commit | 17b2ce6917042ab5513b25731efd5dd9e05da627 | [log] [tgz] |
---|---|---|
author | Søren Gjesse <sgjesse@google.com> | Tue Feb 24 10:06:36 2015 +0100 |
committer | Søren Gjesse <sgjesse@google.com> | Tue Feb 24 10:06:36 2015 +0100 |
tree | 7d2e732813c0c5c638e2002d13e688b474f5bae7 | |
parent | d68ec1f23b0e760f1452e4076a5e96263cbed1b5 [diff] |
Update project to match OSS template R=ricow@google.com BUG= Review URL: https://codereview.chromium.org//955593002
#MIME type package
Package for working with MIME type definitions and for processing streams of MIME multipart media types.
##Determining the MIME type for a file
The MimeTypeResolver
class can be used to determine the MIME type of a file. It supports both using the extension of the file name and looking at magic bytes from the begining of the file.
There is a builtin instance of MimeTypeResolver
accessible through the top level function lookupMimeType
. This builtin instance has the most common file name extensions and magic bytes registered.
print(lookupMimeType('test.html')); // Will print text/html print(lookupMimeType('test', [0xFF, 0xD8])); // Will print image/jpeg print(lookupMimeType('test.html', [0xFF, 0xD8])); // Will print image/jpeg
You can build you own resolver by creating an instance of MimeTypeResolver
and adding file name extensions and magic bytes using addExtension
and addMagicNumber
.
##Processing MIME multipart media types
The class MimeMultipartTransformer
is used to process a Stream
of bytes encoded using a MIME multipart media types encoding. The transformer provides a new Stream
of MimeMultipart
objects each of which have the headers and the content of each part. The content of a part is provided as a stream of bytes.
Below is an example showing how to process an HTTP request and print the length of the content of each part.
// HTTP request with content type multipart/form-data. HttpRequest request = ...; // Determine the boundary form the content type header String boundary = request.headers.contentType.parameters['boundary']; // Process the body just calculating the length of each part. request.transform(new MimeMultipartTransformer(boundary)) .map((part) => part.fold(0, (p, d) => p + d)) .listen((length) => print('Part with length $length'));
Take a look at the HttpBodyHandler
in the http_server package for handling different content types in a HTTP request.
Please file feature requests and bugs at the issue tracker.