darto-add-route

Add a route to a Darto app

Darto is a pure-Dart web framework with a Hono-style single Context model. A handler receives one Context c and returns a Response. It is not Express: there is no (req, res, next), no res.send().

The contract

typedef Handler    = FutureOr<Response>? Function(Context c);
typedef Middleware = FutureOr<void>      Function(Context c, Next next);
typedef Next       = Future<void>        Function();

Procedure

1. Import the core library (only this for routing):

   import 'package:darto/darto.dart';
   

2. Register the route. Every verb method takes three arguments: app.verb(path, [middlewares], handler). The middleware list is required — pass [] when there is none.

   app.get('/users/:id', [], (Context c) {
     final id = c.req.param('id');
     return c.ok({'id': id});
   });
   

   Verbs: get post put patch delete head options all. For custom or multiple verbs/paths: app.on(['GET','POST'], ['/a','/b'], [], handler).
3. Read the request through c.req (never a separate request arg):
   • Params: c.req.param('id'), c.req.paramInt('id'), c.req.paramDouble('id')
   • Query: c.req.query('page'), c.req.queryInt, c.req.queryBool (true/1/yes/on)
   • Headers: c.req.header('authorization')
   • Body: await c.req.json() → Map, or typed await c.req.json<User>(User.fromJson); also c.req.text(), c.req.blob() (Uint8List).
   • URL info: c.req.method, c.req.path, c.req.url, c.req.ip
4. Return a response — always return a helper, don't "send":
   • Status helpers: c.ok (200), c.created (201), c.noContent (204), c.badRequest (400), c.unauthorized (401), c.forbidden (403), c.notFound (404), c.conflict (409), c.internalError (500).
   • Typed: c.json(data, [status]), c.text(str, [status]), c.html(str, [status]).
   • Custom: c.status(206).json(data). Headers: c.header('X-Id', v).
   • Files/redirect: c.binary(bytes, contentType: ...), await c.file(path), await c.download(path, filename: ...), c.redirect('/path', [301]).
5. Listen (once, at the bottom of main): app.listen(3000);