Перейти к содержимому

Привязка (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().