Handle Forms, Uploads, and HTTP Responses with Dart

Archery extends HttpRequest with parsing and response helpers; you will read buffered form data and finish requests with the correct response type.

Read request data

Call request.form() to access a FormRequest. Use input(), all(), body(), file(), files(), or the synchronous query getter. The parser supports JSON, URL-encoded forms, and multipart form data.

lib/src/http/routes/web.dart

router.post('/profile', (request) async {
  final form = request.form();
  final name = await form.input('name');
  final avatar = await form.file('avatar');

  if (avatar != null && avatar.isImage) {
    await avatar.saveToPublicDir('avatars');
  }

  return request.json({'name': name});
});

UploadedFile also exposes bytes, string, length, extension, isAudio, and isVideo. You can save privately, stream to a response with range handling, or upload through the configured S3 client.

Write responses

router.get('/json', (request) async {
  return request.json({'status': 'ok'});
});

router.get('/text', (request) async {
  return request.text('hello world');
});

router.get('/', (request) async {
  return request.view('welcome');
});

Use request.notFound(), request.unAuthenticated(), or request.unAuthorized() for the built-in HTML error views. Redirect helpers include redirect(), redirectBack(), redirectToLogin(), and redirectToDashboard().

The kernel buffers requests with a positive content length before middleware runs, so CSRF checks and your handler can inspect the same body.

Getting Started

HTTP Layer

Application Core

Data And Security

Handle Forms, Uploads, and HTTP Responses with Dart

Read request data

Write responses

​Read request data

​Write responses

Read request data

Write responses