Привязка (Binding)
Binding — это конфигурация, которая определяет, как создавать или предоставлять конкретную зависимость. Binding поддерживает:
- Прямое присваивание экземпляра (
toInstance()— принимает значение или уже запущенныйFuture) - Ленивые провайдеры (синхронные/асинхронные функции)
- Провайдеры с поддержкой динамических параметров
- Именованные экземпляры для получения по строковому ключу
- Необязательное управление жизненным циклом синглтона
void builder(Scope scope) { // Прямое предоставление экземпляра bind<String>().toInstance("Hello world");
// Асинхронное предоставление экземпляра (toInstance принимает FutureOr<T>) bind<String>().toInstance(Future.value("Hello world"));
// Ленивое создание синхронного экземпляра через фабрику bind<String>().toProvide(() => "Hello world");
// Ленивое создание асинхронного экземпляра через фабрику bind<String>().toProvideAsync(() async => "Hello async world");
// Предоставление экземпляра с динамическими параметрами (синхронно) bind<String>().toProvideWithParams((params) => "Hello $params");
// Предоставление экземпляра с динамическими параметрами (асинхронно) bind<String>().toProvideAsyncWithParams((params) async => "Hello $params");
// Именованный экземпляр для получения по имени bind<String>().toProvide(() => "Hello world").withName("my_string");
// Пометить как синглтон (только один экземпляр в пределах скоупа) bind<String>().toProvide(() => "Hello world").singleton();}Каждый bind<T>() обязательно нужно завершить одной из целей выше. Сам по себе
bind<T>() не регистрирует ничего, что можно было бы получить через resolve,
поэтому установка такого модуля выбросит StateError с указанием типа, имени
(для именованного биндинга) и модуля:
class NetworkModule extends Module { @override void builder(Scope scope) { bind<String>().withName('baseUrl'); // цели нет — резолв невозможен }}
scope.installModules([NetworkModule()]);// StateError: Binding for `String` named 'baseUrl' in module NetworkModule has// no target, so it can never be resolved. Complete it with toInstance(),// toProvide(), toProvideWithParams(), toProvideAsync() or// toProvideAsyncWithParams().