Зачем нужен Binds если есть Provides в Dagger?

Введение

Binds и Provides — это две декларативные аннотации в Dagger для указания того, как предоставлять зависимости. Хотя обе служат одной цели — внедрению зависимостей, их ключевое различие заключается в способе определения реализации. @Provides используется для методов, которые содержат логику создания объекта, в то время как @Binds применяется к абстрактным методам для указания реализации без написания кода. Понимание их различий критично для написания эффективного и производительного кода на Dagger.

Различия между @Provides и @Binds

@Provides: явное создание объекта

@Provides используется в классах, помеченных @Module, для методов, которые явно создают и возвращают экземпляр объекта. Эти методы могут содержать произвольный код.

@Module
class NetworkModule {
    @Provides
    fun provideHttpClient(): HttpClient {
        return HttpClient.Builder()
            .connectTimeout(30, TimeUnit.SECONDS)
            .build()
    }
}

@Binds: абстрактная привязка реализации

@Binds используется в абстрактных классах или интерфейсах с @Module. Метод, аннотированный @Binds, должен быть абстрактным и связывать абстракцию (интерфейс или абстрактный класс) с конкретной реализацией.

@Module
abstract class StorageModule {
    @Binds
    abstract fun bindStorage(impl: SharedPrefStorage): Storage
}

Зачем нужен @Binds, если есть @Provides?

1. Производительность и эффективность компиляции

Dagger на этапе компиляции генерирует код. При использовании @Binds генерируемый код более эффективен, так как не требует вызова фабричного метода:

• @Provides: Генерирует фабричный метод с логикой создания.
• @Binds: Генерирует прямую привязку типа, экономя вызовы методов и уменьшая размер сгенерированного кода.

2. Удобство для связывания интерфейсов и абстракций

@Binds идеально подходит, когда вам нужно привязать интерфейс к его реализации, без необходимости писать код создания. С @Provides пришлось бы явно возвращать реализацию, что излишне.

// С @Binds - лаконично и абстрактно
@Module
abstract class RepositoryModule {
    @Binds
    abstract fun bindUserRepo(impl: UserRepositoryImpl): UserRepository
}

// С @Provides - требуется явное создание
@Module
class RepositoryModule {
    @Provides
    fun provideUserRepo(): UserRepository {
        return UserRepositoryImpl()
    }
}

3. Поддержка модулей без состояния

Модули с @Binds могут быть абстрактными классами и не хранить состояние, что улучшает читаемость и соответствует принципам чистой архитектуры.

4. Совместное использование с @IntoSet, @IntoMap и другими аннотациями

@Binds часто комбинируется с аннотациями для коллекций, такими как @IntoSet или @IntoMap, позволяя лаконично определять вклад в множества или карты.

@Module
abstract class ServiceModule {
    @Binds
    @IntoSet
    abstract fun bindAnalytics(impl: FirebaseAnalytics): AnalyticsService
}

Когда использовать @Provides?

@Provides необходим, когда:

• Требуется логика создания (например, конфигурация объекта).
• Зависимость не может быть создана напрямую (например, через конструктор).
• Используются сторонние библиотеки, классы которых вы не контролируете.

@Module
class DatabaseModule {
    @Provides
    fun provideDatabase(@ApplicationContext context: Context): AppDatabase {
        return Room.databaseBuilder(context, AppDatabase::class.java, "app.db")
            .fallbackToDestructiveMigration()
            .build()
    }
}

Сравнительная таблица

Заключение

Обе аннотации — @Binds и @Provides — необходимы в экосистеме Dagger, но служат разным целям. @Binds оптимизирован для случаев, когда нужно просто связать абстракцию с реализацией, обеспечивая лучшую производительность и лаконичность кода. @Provides же даёт полный контроль над процессом создания объекта. Правильный выбор между ними позволяет писать более эффективный, поддерживаемый и читаемый код для внедрения зависимостей. Используйте @Binds для привязки интерфейсов и @Provides для сложного создания объектов — это ключ к мастерскому владению Dagger.