Flutter插件dartness的介绍与使用指南

Flutter插件dartness的介绍与使用指南

Dartness 是一个极简主义的基于中间件的 Web 框架。它允许开发者通过中间件来创建工作流程，并且具有简单易用的特点。

基本特性

• 所有部分都是中间件。
• 错误可以在任何步骤被捕获。
• 可以使用简单的动态路由。
• 路由器会跳过后续的路由，如果有一个匹配上了。
• 中间件可以分组为模块。

未来路线图

• 绑定路由到类方法。
• 添加日志记录功能。
• 添加嵌套路由。
• 添加中间件链。
• 在路由中添加 POST 和 GET 参数作为函数参数。
• 使用函数结果作为响应。
• 使用隔离技术。

完整示例

import 'dart:io';
import 'package:dartness/dartness.dart';

void main() {
  final app = new Dartness();

  // 第一个中间件
  app.use((Context context) async {
    print('middleware 1');
  }, catchError: false);

  // 第二个中间件
  app.use((Context context) async {
    print('middleware 2');
  });

  final router = new Router();

  // 动态路由
  router.get('/:param1/:param2/:param3',
      (String param3, Context context, String param1, String param2) async {
    print('GET /' + context.req.params.toString());
  });

  // 简单的 GET 请求
  router.get('/', (Context context) async => null);

  // 简单的 POST 请求
  router.post(
      '/', (Context context) async => print(context.req.body)); // body 是一个映射

  // 带有前置中间件的 GET 请求
  router.get('/secret',
      (Context context) async => context.res.write('secret word'))
      .useBefore((Context context) {
    if (context.req.headers.value('X-Secret-Code')!.isEmpty) {
      throw new StateError('You shall not pass!');
    }
  });

  // 带正则表达式的路由
  router.get(r'/:blogId(\d+$)', (String blogId, Context context) {
    final reqBlogId = context.req.params['blogId']!;
    context.res.write('blogId is ' + blogId + ' and ' + reqBlogId);
  });

  // 将路由器挂载到应用上
  app.use(router);

  // 处理错误的中间件
  app.use((Context context) async {
    print('wow, here is was an error!');
    context.res.write('middleware 2');
  }, catchError: true);

  // 启动应用监听
  app.listen(host: InternetAddress.anyIPv4, port: 4040);
}

类绑定示例

import 'package:dartness/dartness.dart';

class A {
  [@Get](/user/Get)('/')
  void index(Context c) {
    c.res.write('index');
  }

  [@Get](/user/Get)('/:param')
  void param(Context c, String param) {
    c.res.write(param);
  }
}

void main() {
  final app = new Dartness();
  final route = new Router();

  // 将类 A 绑定到路由
  route.bind(new A());

  // 将路由挂载到应用上
  app.use(route);
  app.listen(port: 3030);
}