Flutter插件drengr的介绍与使用

Drengr 是一个用于构建 Web 应用程序的框架，它为开发者提供了一个简洁而强大的工具集。Drengr 提供了一种模块化的方式，允许你根据需求选择性地使用其组件，例如路由（Router）、依赖注入（Dependency Injection）和控制器（Controller）。Drengr 的设计目标是让开发者能够轻松地构建高性能的 Web 应用。

Flutter插件drengr的安装与配置

在开始之前，确保你已经安装了 Dart SDK 和 Flutter。接下来，通过以下命令将 Drengr 添加到你的项目中：

flutter pub add drengr

配置文件

Drengr 使用一个 YAML 文件来存储配置信息。如果你使用 CLI 工具生成项目，会自动生成 config.yml 文件。如果你手动创建项目，则需要手动创建该文件。以下是一个简单的配置文件示例：

# config.yml
app:
  name: "MyApp"
  version: "1.0.0"

基本使用

Drengr 提供了多个核心组件，包括路由（Router）、请求（Request）、响应（Response）和控制器（Controller）。下面我们通过一个完整的示例展示如何使用这些组件。

示例代码

import 'package:drengr/app/app.dart';
import 'package:drengr/container/container.dart';
import 'package:drengr/router/router.dart';
import 'package:drengr/router/request.dart';
import 'package:drengr/router/response.dart';
import 'package:drengr/controllers/controller.dart';

// 自定义控制器
class SampleController extends Controller {
  Response show(Request request) {
    // 渲染模板
    return view('main_template');
  }
}

void main() async {
  // 创建路由器实例
  var router = Router();

  // 示例 1: 使用控制器处理路由
  router.get('/', controller: SampleController(), method: 'show');

  // 示例 2: 使用匿名函数处理路由
  router.get('/hello', handler: (Request request) {
    return Response.Ok('Hello World!');
  });

  // 示例 3: 从容器中提取对象
  router.get('/config', handler: (Request request) {
    print(request.container);
    print(request.container.make('[@config](/user/config)')); // 获取配置对象
    return Response.Ok(request.container.make('[@config](/user/config)'));
  });

  // 示例 4: 处理路径参数
  router.get('/:name', handler: (Request request) {
    return Response.Ok(request.pathParams['name']); // 获取路径参数
  });

  // 创建依赖注入容器
  var container = Container();
  // 在容器中添加自定义对象
  container.bind('[@config](/user/config)', () => {'key': 'value'});

  // 创建应用程序实例
  var app = App(router: router, container: container);

  // 启动应用程序
  await app.start();
}

代码解析

1. 创建路由器：

   var router = Router();

   路由器负责管理 URL 路径与处理逻辑之间的映射关系。

2. 注册路由：

   • 使用控制器处理路由：

     router.get('/', controller: SampleController(), method: 'show');

     这里我们将根路径 / 映射到 SampleController 的 show 方法。
   • 使用匿名函数处理路由：

     router.get('/hello', handler: (Request request) {
       return Response.Ok('Hello World!');
     });

3. 依赖注入：

   container.bind('[@config](/user/config)', () => {'key': 'value'});

   我们将一个配置对象绑定到容器中，并在后续处理中通过容器获取该对象。

4. 启动应用程序：

   var app = App(router: router, container: container);
   await app.start();