mirror of https://github.com/pese-git/cherrypick.git synced 2026-01-23 21:13:35 +00:00

Files

Sergey Penkovsky e0a5ae66f6 fix(docs): comment out all broken links to allow successful Docusaurus build

- Commented out references to non-existent files and examples in both English and Russian documentation:
  - circular-dependency-detection.md
  - logging.md
  - documentation-links.md
  - using-annotations.md
- This fix prevents build failures caused by unresolved links in Docusaurus for both locales.
- All offending links are now non-blocking comments, allowing the site to build and deploy successfully until the related pages are added.

2025-08-14 16:24:57 +03:00

2.3 KiB

Raw Blame History

sidebar_position

sidebar_position
3

Обнаружение циклических зависимостей

CherryPick может обнаруживать циклические зависимости в вашей DI-конфигурации, помогая избежать бесконечных циклов и сложных для отладки ошибок.

Как использовать:

1. Включите обнаружение во время разработки

Локально (в рамках одного скоупа):

final scope = CherryPick.openSafeRootScope(); // Локальное обнаружение включено по умолчанию
// или для существующего скоупа:
scope.enableCycleDetection();

Глобально (между скоупами):

CherryPick.enableGlobalCrossScopeCycleDetection();
final rootScope = CherryPick.openGlobalSafeRootScope();

2. Пример ошибки

Если вы объявите взаимозависимые сервисы:

class A { A(B b); }
class B { B(A a); }

scope.installModules([
  Module((bind) {
    bind<A>().to((s) => A(s.resolve<B>()));
    bind<B>().to((s) => B(s.resolve<A>()));
  }),
]);

scope.resolve<A>(); // выбросит CircularDependencyException

3. Общая рекомендация

Включайте обнаружение всегда в debug и тестовой среде для максимальной безопасности.
Отключайте обнаружение в production после завершения тестирования, ради производительности.

import 'package:flutter/foundation.dart';

void main() {
  if (kDebugMode) {
    CherryPick.enableGlobalCycleDetection();
    CherryPick.enableGlobalCrossScopeCycleDetection();
  }
  runApp(MyApp());
}

4. Отладка и обработка ошибок

При обнаружении будет выброшено исключение CircularDependencyException с цепочкой зависимостей:

try {
  scope.resolve<MyService>();
} on CircularDependencyException catch (e) {
  print('Цепочка зависимостей: ${e.dependencyChain}');
}

2.3 KiB Raw Blame History Unescape Escape