The Protevus Platform: Unified Full-Stack Development https://protevus.com
Find a file
2017-03-07 16:29:18 -05:00
.idea/libraries Multipart support thanks to http_server 2016-09-24 14:30:01 -04:00
lib 1.0.1 2017-03-07 16:29:18 -05:00
test +5 2017-01-14 08:50:02 -05:00
.gitignore Single file uploads = complete 2016-04-17 15:51:40 -04:00
.travis.yml Resolved all issues 2016-12-04 21:31:25 -05:00
LICENSE Equals in query now ;) 2016-12-22 13:08:45 -05:00
pubspec.yaml 1.0.1 2017-03-07 16:29:18 -05:00
README.md 1.0.1 2017-03-07 16:29:18 -05:00

Body Parser

![version 1.0.01(https://img.shields.io/badge/version-1.0.1-brightgreen.svg) build status

Parse request bodies and query strings in Dart, as well multipart/form-data uploads. No external dependencies required.

Contents

About

I needed something like Express.js's body-parser module, so I made it here. It fully supports JSON requests. x-www-form-urlencoded fully supported, as well as query strings. You can also include arrays in your query, in the same way you would for a PHP application. Full file upload support will also be present by the production 1.0.0 release.

A benefit of this is that primitive types are automatically deserialized correctly. As in, if you have a hello=1.5 request, then body['hello'] will equal 1.5 and not '1.5'. A very semantic difference, yes, but it relieves stress in my head.

Installation

To install Body Parser for your Dart project, simply add body_parser to your pub dependencies.

dependencies:
    body_parser: any

Usage

Body Parser exposes a simple class called [BodyParseResult]. You can easily parse the query string and request body for a request by calling Future<BodyParseResult> parseBody.

import 'dart:convert';
import 'package:body_parser/body_parser.dart';

main() async {
    // ...
    await for (HttpRequest request in server) {
      request.response.write(JSON.encode(await parseBody(request).body));
      await request.response.close();
    }
}

You can also use buildMapFromUri(Map, String) to populate a map from a URL encoded string.

This can easily be used with a library like JSON God to build structured JSON/REST APIs. Add validation and you've got an instant backend.

MyClass create(HttpRequest request) async {
    return god.deserialize(await parseBody(request).body, MyClass);
}

Thank you for using Body Parser

Thank you for using this library. I hope you like it.

Feel free to follow me on Twitter:

@thosakwe