Flutter轻量级服务器插件lite_server的功能

Flutter轻量级服务器插件lite_server的功能

LiteServer 是一个用于Dart的轻量级HttpServer包装器。它提供了一种简单的方式来创建HTTP服务器，并支持多种功能。

特性

• 易于使用：使用起来非常方便。
• 轻量级：占用资源少。
• 动态路径支持：例如 /user/<id>。
• 嵌套路由：可以定义多层嵌套的路由。
• 静态文件支持：可以提供静态文件服务。
• MultipartFile支持：支持处理multipart形式的数据。
• 自定义守卫控制器支持：可以在请求处理过程中进行操作。

使用示例

以下是一个完整的示例，展示了如何使用 LiteServer 插件来创建一个简单的HTTP服务器。

import 'dart:async';
import 'dart:convert';
import 'dart:io';
import 'dart:isolate';
import 'package:lite_server/lite_server.dart';

// 定义一些路由
final homeRoute = HttpRoute.get(
  '/',
  handler: (request, payload) {
    // 返回一张图片
    final cwd = Directory.current.path;
    request.response.file('$cwd/assets/web/images/512.png');
  },
  routes: [
    HttpRoute.get(
      'api',
      routes: [
        HttpRoute.get(
          'users',
          handler: (request, payload) {
            // 返回一个空数组
            request.response.json([]);
          },
        ),
      ],
    ),
  ],
);

// 定义一个处理POST请求的路由
final userPostRoute = HttpRoute.post(
  '/user/<id>',
  handler: (request, payload) async {
    print(jsonDecode(await request.readBodyAsString()));
    await request.response.json(payload.pathParameters);
  },
);

// 定义一个处理GET请求的路由
final userGetRoute = HttpRoute.get(
  '/user/<id>',
  handler: (request, payload) async {
    await request.response.json(payload.pathParameters);
  },
  routes: [
    HttpRoute.get(
      '<pack>',
      handler: (request, payload) async {
        await request.response.json(payload.pathParameters);
      },
      routes: [
        HttpRoute.get(
          '<dept>',
          handler: (request, payload) async {
            await request.response.json(payload.pathParameters);
          },
        ),
      ],
    ),
  ],
);

// 定义一个处理上传的路由
final uploadRoute = HttpRoute.post(
  '/upload',
  handler: (request, payload) async {
    await for (final entry in request.multipartData()) {
      if (!entry.info.containsKey('content-type')) {
        print(utf8.decode(entry.bytes));
      }
    }

    await request.response.ok(body: 'uploaded');
  },
);

// 定义静态文件路由
final staticImageRoute = HttpStaticRoute(
  '/images',
  directoryPath: 'assets/images/',
  listDirectory: true,
);

final staticWebRoute = HttpStaticRoute(
  '/web',
  directoryPath: 'assets/web/',
  defaultDocument: 'index.html',
);

void main(List<String> arguments) async {
  final liteServer = LiteServer(
    routes: [
      homeRoute,
      userPostRoute,
      userGetRoute,
      HttpRoute.post(
        '/post',
        handler: (request, payload) async {
          print(jsonDecode(await request.readBodyAsString()));
          await request.response.ok(body: 'posted');
        },
      ),
      uploadRoute,
      staticImageRoute,
      staticWebRoute,
    ],
  );

  for (var i = 0; i < 6; i++) {
    await Isolate.spawn(startServer, liteServer);
  }

  print(liteServer.routeMap.keys.join('\n'));
  await startServer(liteServer);
}

Future<void> startServer(LiteServer liteServer) async {
  final server = await HttpServer.bind(
    InternetAddress.anyIPv4,
    9080,
    shared: true,
  )
    ..autoCompress = true
    ..serverHeader = Isolate.current.hashCode.toString();

  liteServer.listen(
    server,
    controllers: [
      LoggerController(level: LogLevel.errors),
      CorsOriginController(allowedMethods: {'GET', 'POST', 'OPTIONS'}),
    ],
  );
}