Flutter多功能集成插件tridev的使用

Flutter未知功能插件tridev的使用

（注：由于“undefined”的介绍，以下句子中的功能为基于“tridev”名称的假设性描述，实际功能需参考官方文档或源码）

Flutter多功能集成插件tridev的使用

Tridev 是 Stablekernel 的 Aqueduct 框架的一个分支，是一个现代的 Dart HTTP 服务器框架。

入门指南

1. 安装 Dart

   访问 Dart 安装页面 并按照说明安装 Dart。

2. 激活 Tridev

   打开终端并运行以下命令以全局激活 Tridev：

   pub global activate tridev
   

3. 创建新项目

   使用 tridev create 命令创建一个新的 Tridev 项目。例如：

   tridev create my_project
   

教程、文档和示例

Tridev 是 Aqueduct 的一个分支，因此 Aqueduct 的示例可以稍作修改后与 Tridev 一起使用。主要关注点是更新代码以使用空安全。

示例代码

以下是一个简单的示例，展示了如何使用 Tridev 创建一个基本的 HTTP 应用程序，并包含用户管理和认证功能。

/*
  This example demonstrates an HTTP application that uses the ORM and ORM-backed OAuth2 provider.

  For building and running non-example applications, install 'tridev' command-line tool.

      pub global activate tridev
      tridev create my_app

  More examples available: https://github.com/tridev.dart/tridev_examples
 */

import 'dart:async';
import 'dart:io';
import 'package:tridev/tridev.dart';
import 'package:tridev/managed_auth.dart';

Future main() async {
  final app = Application<App>()
    ..options.configurationFilePath = 'config.yaml'
    ..options.port = 8888;

  await app.start(numberOfInstances: 3);
}

class App extends ApplicationChannel {
  ManagedContext? context;
  AuthServer? authServer;

  [@override](/user/override)
  Future prepare() async {
    final config = AppConfiguration.fromFile(File(options!.configurationFilePath!));
    final db = config.database;
    final persistentStore = PostgreSQLPersistentStore.fromConnectionInfo(
        db.username, db.password, db.host, db.port, db.databaseName);
    context = ManagedContext(
        ManagedDataModel.fromCurrentMirrorSystem(), persistentStore);

    authServer = AuthServer(ManagedAuthDelegate(context));
  }

  [@override](/user/override)
  Controller get entryPoint {
    return Router()
      ..route('/auth/token').link(() => AuthController(authServer))
      ..route('/users/[:id]')
          .link(() => Authorizer(authServer))!
          .link(() => UserController(context, authServer));
  }
}

class UserController extends ResourceController {
  UserController(this.context, this.authServer);

  final ManagedContext? context;
  final AuthServer? authServer;

  [@Operation](/user/Operation).get()
  Future<Response> getUsers() async {
    final query = Query<User>(context!);
    return Response.ok(await query.fetch());
  }

  [@Operation](/user/Operation).get('id')
  Future<Response> getUserById(@Bind.path('id') int id) async {
    final q = Query<User>(context!)..where((o) => o.id).equalTo(id);
    final user = await q.fetchOne();

    if (user == null) {
      return Response.notFound();
    }

    return Response.ok(user);
  }

  [@Operation](/user/Operation).post()
  Future<Response> createUser(@Bind.body() User user) async {
    if (user.username == null || user.password == null) {
      return Response.badRequest(
          body: {"error": "username and password required."});
    }

    final salt = AuthUtility.generateRandomSalt();
    final hashedPassword = authServer!.hashPassword(user.password!, salt);

    final query = Query<User>(context!)
      ..values = user
      ..values.hashedPassword = hashedPassword
      ..values.salt = salt
      ..values.email = user.username;

    final u = await query.insert();
    final token = await authServer!.authenticate(
        u.username,
        query.values.password,
        request!.authorization!.credentials!.username,
        request!.authorization!.credentials!.password);

    return AuthController.tokenResponse(token);
  }
}

class AppConfiguration extends Configuration {
  AppConfiguration.fromFile(File file) : super.fromFile(file);

  late DatabaseConfiguration database;
}

class User extends ManagedObject<_User>
    implements _User, ManagedAuthResourceOwner<_User> {
  [@Serialize](/user/Serialize)(input: true, output: false)
  String? password;
}

class _User extends ResourceOwnerTableDefinition {
  [@Column](/user/Column)(unique: true)
  String? email;
}