Flutter服务端框架插件angel3_framework的使用

Angel3 Framework 是一个功能强大的HTTP服务器框架，支持依赖注入、复杂路由、认证、ORM、GraphQL等特性。它旨在保持核心最小化但可以通过一系列插件包进行扩展。这种灵活性使得Angel3框架能够随着您的应用程序一起成长，并处理新的用例。

安装与设置

选项1：通过克隆样板模板创建新项目

1. 下载并安装Dart:

   • Dart下载页面

2. 克隆以下启动项目之一:

   • Angel3 Basic Template
   • Angel3 ORM Template
   • Angel3 ORM MySQL Template
   • Angel3 Graphql Template

3. 以开发模式运行项目（文件更改时启用热重载）:

   dart --observe bin/dev.dart
   

4. 以生产模式运行项目（禁用热重载）:

   dart bin/prod.dart
   

5. 作为Docker运行。使用提供的Dockerfile文件编辑和构建镜像

选项2：使用Angel3 CLI创建新项目

1. 下载并安装Dart:

   • Dart下载页面

2. 安装Angel3 CLI:

   dart pub global activate angel3_cli
   

3. 在终端中创建新项目:

   angel3 init hello
   

4. 以开发模式运行项目（文件更改时启用热重载）:

   dart --observe bin/dev.dart
   

5. 以生产模式运行项目（禁用热重载）:

   dart bin/prod.dart
   

6. 作为Docker运行。使用提供的Dockerfile文件编辑和构建镜像

性能基准测试

性能基准测试结果可以在TechEmpower Framework Benchmarks Round 21找到。

迁移指南

如果您正在从旧版本的Angel迁移到Angel3，请参考Migrating to Angel3。

捐赠和支持

如果您喜欢这个项目并对支持其开发感兴趣，您可以通过以下方式捐款：

• GitHub Sponsors
• PayPal

示例代码

下面是一个简单的示例，展示了如何使用Angel3框架创建一个HTTP服务器：

import 'package:angel3_container/mirrors.dart';
import 'package:angel3_framework/angel3_framework.dart';
import 'package:angel3_framework/http.dart';
import 'package:logging/logging.dart';

void main() async {
  // Logging set up/boilerplate
  //Logger.root.onRecord.listen(prettyLog);

  // 创建服务器实例
  var app = Angel(
    logger: Logger('angel'),
    reflector: MirrorsReflector(),
  );

  // 设置根路由，返回JSON
  app.get('/', (req, res) => 'Welcome to Angel!');

  // 接受类似 /greet/foo 或 /greet/bob 的URL
  app.get(
    '/greet/:name',
    (req, res) {
      var name = req.params['name'];
      res
        ..write('Hello, $name!')
        ..close();
    },
  );

  // 模式匹配 - 只有当查询参数 `name` 等于 'emoji' 时调用此处理器
  app.get(
    '/greet',
    ioc((@Query('name', match: 'emoji') String name) => '😇🔥🔥🔥'),
  );

  // 处理任何其他查询参数 `name`
  app.get(
    '/greet',
    ioc((@Query('name') String name) => 'Hello, $name!'),
  );

  // 简单的404回退处理
  app.fallback((req, res) {
    throw AngelHttpException.notFound(
      message: 'Unknown path: "${req.uri!.path}"',
    );
  });

  // 启动HTTP服务器
  var http = AngelHttp(app);
  var server = await http.startServer('127.0.0.1', 3000);
  var url = 'http://${server.address.address}:${server.port}';
  print('Listening at $url');
  print('Visit these pages to see Angel in action:');
  print('* $url/greet/bob');
  print('* $url/greet/?name=emoji');
  print('* $url/greet/?name=jack');
  print('* $url/nonexistent_page');
}

以上是关于Flutter服务端框架插件angel3_framework的基本介绍和使用方法，希望对您有所帮助！如果有更多问题或需要进一步的帮助，请随时提问。