Flutter功能扩展插件dino_extensions的使用

Flutter功能扩展插件dino_extensions的使用

快速开始

假设你已经对依赖注入有所了解。

首先，我们来看一个简单的例子。假设我们有两个服务类，Repository 和 RestClient，它们相互依赖：

class Repository {
  Repository(this.restClient);
  final RestClient restClient;

  Future<void> sendMessage(String message) async {
    try {
      await restClient.sendMessage(message);
    } catch (e) {
      print('Error sending message: $e');
    }
  }
}

class RestClient {
  RestClient(this.dio);
  final Dio dio;

  Future<void> sendMessage(String message) async {
    await dio.post('/api/message', data: {'message': message});
  }
}

然后，我们需要在 dino 中注册这些服务：

import 'package:dino/dino.dart';
import 'package:dino_extensions/dino_extensions.dart';

void main() {
  final services = RuntimeServiceCollection();

  // 注册一个 Dio 实例
  services.addInstance(Dio());

  // 添加一个单例的 RestClient
  services.addSingletonFactory(
    (sp) => RestClient(
      dio: sp.getRequired<Dio>(),
    ),
  );

  // 添加一个单例的 Repository
  services.addSingletonFactory(
    (sp) => Repository(
      restClient: sp.getRequired<RestClient>(),
    ),
  );

  // 构建根作用域
  final rootScope = services.buildRootScope();

  // 使用 ServiceProvider 获取 Repository 实例并调用方法
  final repository = rootScope.serviceProvider.getRequired<Repository>();
  repository.sendMessage('Hello world!');
}

如果你使用了 dino_generator 进行代码生成，那么代码会更简洁：

import 'package:dino/dino.dart';
import 'package:dino_extensions/dino_extensions.dart';
import 'main.dino.g.dart';

void main() {
  final services = $ServiceCollection();

  // 注册一个 Dio 实例
  services.addInstance(Dio());
  services.addSingleton<RestClient>();
  services.addSingleton<Repository>();

  // 构建根作用域
  final rootScope = services.buildRootScope();

  // 使用 ServiceProvider 获取 Repository 实例并调用方法
  final repository = rootScope.serviceProvider.getRequired<Repository>();
  repository.sendMessage('Hello world!');
}

在 Flutter 应用中，你可以使用 DinoProvider 将 ServiceProvider 提供给子组件：

import 'package:flutter/material.dart';
import 'package:dino/dino.dart';
import 'package:dino/flutter.dart';
import 'package:dino_extensions/dino_extensions.dart';

void main() {
  final services = RuntimeServiceCollection();

  // 注册一个 Dio 实例
  services.addInstance(Dio());
  services.addSingleton<RestClient>();
  services.addSingleton<Repository>();

  // 构建根作用域
  final rootScope = services.buildRootScope();

  runApp(
    DinoProvider(
      serviceProvider: rootScope.serviceProvider,
      child: MyApp(),
    ),
  );
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    final repository = context.sp.getRequired<Repository>();

    // 使用 Repository 实例
    repository.sendMessage('Hello world!');

    return Scaffold(
      appBar: AppBar(
        title: Text('Dino Extensions Example'),
      ),
      body: Center(
        child: Text('Message sent!'),
      ),
    );
  }
}