| commit | ad27bdff15abe040bdae98aa87387a55c8fb3384 | [log] [tgz] |
|---|---|---|
| author | Kevin Moore <kevmoo@google.com> | Wed Aug 26 08:08:21 2015 -0700 |
| committer | Kevin Moore <kevmoo@google.com> | Wed Aug 26 08:08:21 2015 -0700 |
| tree | 5a9630c804f86d00b8fea0a984189eecb33c2120 | |
| parent | a2b596cbaa8a1dd6af1720dcd7bff7e43af4ad41 [diff] |
Use pkg/test R=sgjesse@google.com Review URL: https://codereview.chromium.org//1317773003 .
#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.