Переопределение связей в Guice без нарушения прочих

Быстрый ответ

Для переопределения привязок в Guice применяется метод Modules.override(). Сначала создайте модуль с исходными настройками, затем сформировать модуль с переопределениями и подключите его:

Module originalModule = new AbstractModule() {
  @Override
  protected void configure() {
    bind(Service.class).to(OriginalService.class);
  }
};

Module overrideModule = new AbstractModule() {
  @Override
  protected void configure() {
    bind(Service.class).to(OverrideService.class);
  }
};

Injector injector = Guice.createInjector(
  Modules.override(originalModule).with(overrideModule)
);

Service service = injector.getInstance(Service.class);

По завершении этого процесса объект service будет привязан к OverrideService, игнорируя запросы к OriginalService.

Разработка модулей: обдуманный подход

Стремитесь создавать модули с чёткой структурой и разделением обязанностей – это упростит задачу и снизит необходимость переопределений.

Профессиональное переопределение

Для сложных случаев, когда требуется расширить функциональность, можно использовать следующие подходы:

Удачное использование @ImplementedBy

@ImplementedBy позволяет определить стандартную реализацию интерфейса, которую легко переопределить при необходимости:

@ImplementedBy(OverrideService.class)
public interface Service {
  // здесь могут быть описаны методы
}

Так, вы задаёте привязку по умолчанию, которую при желании можно переопределить для проведения тестирования.

Подробнее об этом расскажет наш спикер на видео

Управление тестовыми сценариями

В модульных тестах:

• Вручную инжектируйте заглушки для исключения вмешательства в продакшн-привязки.
• Переопределяйте привязки в расширенном модуле, чтобы не влиять на код, предназначенный для производства:

public class TestModule extends AbstractModule {
  @Override
  protected void configure() {
    bind(Service.class).to(MockService.class);
  }
}

Injector testInjector = Guice.createInjector(new TestModule());

Сохранность продакшн-кода

Важно сохранять целостность продакшн-привязок — избегайте их переопределения в процессе тестирования.

Визуализация

Переопределение привязок в Guice можно сравнить с обновлением гардероба:

Исходный гардероб (🚪1️⃣): [Рубашка 👔, Брюки 👖, Шляпа 🎩] Изменение моды (🧢): Замена Шляпы 🎩 на Кепку 🧢

Обновлённый гардероб (🚪1️⃣+🧢): [Рубашка 👔, Брюки 👖, Кепка 🧢]

Guice работает аналогичным образом, поддерживая ваши привязки в актуальном состоянии.

Стратегия тестирования: открываем тайны

Для тестирования рекомендуем следующий подход:

Модули для тестов

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

public class TestModule extends ProductionModule {
  @Override
  protected void configure() {
    super.configure();
    bind(Service.class).to(TestService.class);
  }
}

Упрощение с Jukito

Jukito позволяет легко конфигурировать тестовое окружение:

Injector injector = Jukito.createInjector(
  new TestModule(),
  new ModuleUnderTheKnife()
);

Работа с RoboGuice для Android

В Android-приложениях с RoboGuice используйте overrideApplicationInjector, чтобы модифицировать привязки при тестировании.

Недопущение проблем

Следите за возможными сложностями:

• Зависимости модулей: Нежелательные эффекты могут возникнуть при переопределении.
• Области привязок: Изменение областей привязок может привести к нежелательным последствиям.
• Совместимость: Проверяйте, совместимы ли новые и старые привязки.

Полезные материалы

1. Подробный гид по привязкам в Guice.
2. Делитесь опытом переопределения привязок с коллегами на форумах.
3. Официальная документация Guice по модулям и их переопределению.
4. Щедрый на детали очерк по Guice и её особенностям.
5. Учебное видео о Guice и настройке проекта.
6. Обзор функций Guice, связанных с внедрением зависимостей.
7. Форум для обмена идеями по Guice и получения поддержки от сообщества.