Dagger 2 static provider methods in kotlin

KotlinDagger 2

Kotlin Problem Overview


With the recent versions of dagger 2 one of the improvements made are the possibility of having static provide methods. Simply so:

@Provides
static A providesA() {
  return A();
}

I was wondering how does one go about doing this in kotlin? I've tried

@Module
class AModule {
  companion object {
    @JvmStatic
    @Provides
    fun providesA(): A = A()
  }
}

But I get the error message:

@Provides methods can only be present within a @Module or @ProducerModule

I'm guessing there's something going on here with the companion object, however I'm quite new to Kotlin and I'm unsure of how one can do this. Is it even possible?

Thanks!

Kotlin Solutions


Solution 1 - Kotlin

Although I think zsmb13's solution is better, I found another solution which works

@Module
class AModule {
  @Module
  companion object {
    @JvmStatic
    @Provides
    fun providesA(): A = A()
  }

  // add other non-static provides here
}

However, note that there will be two generated classes: AModule_ProvidesAFactory and AModule_Companion_ProvidesAFactory rather than the one AModule_ProvidesAFactory class for the case with an object instead of a class with a companion object

Solution 2 - Kotlin

I can't test it right now, but I think this should work:

@Module
object AModule {
    @JvmStatic
    @Provides
    fun providesA(): A = A()
}

Solution 3 - Kotlin

Now Dagger2 (version 2.26) support companion objects in @Module annotated classes in kotlin withthouh @Module and @JvmStatic annotations

> Better support for binding declarations within Kotlin companion > objects of @Module annotated classes.

Update dagger dependencies to 2.26 version as

def dagger_version = "2.26"
//dagger
implementation "com.google.dagger:dagger:$dagger_version"
kapt "com.google.dagger:dagger-compiler:$dagger_version"

//If you're using classes in dagger.android you'll also want to include:
implementation "com.google.dagger:dagger-android:$dagger_version"
implementation "com.google.dagger:dagger-android-support:$dagger_version"
kapt "com.google.dagger:dagger-android-processor:$dagger_version"

so now you can use

@Module
class AModule {

  companion object {

    @Provides
    fun providesA(): A = A()
  }

}

Important: Soon, adding @Module on companion objects in @Module classes will raise an error.

> Note: For backwards compatibility, we still allow @Module on the > companion object and @JvmStatic on the provides methods. However, > @Module on the companion object is now a no-op and all of its > attributes (e.g. "includes") will be ignored. In future releases, we > will make it an error to use @Module on a companion object.

Solution 4 - Kotlin

A great explanation which seems to be Google-approved is at https://github.com/google/dagger/issues/900

Specifically, see:

> Static provides can be achieved via @JvmStatic. There are two scenarios I see this come up: > > top-level objects

@Module object DataModule {   
  @JvmStatic @Provides fun 
    provideDiskCache() = DiskCache() 
} 

> > If you have an existing class > module, things get a bit weirder

@Module abstract class DataModule {   
    @Binds abstract fun provideCache(diskCache: DiskCache): Cache
    
    @Module   
    companion object {
        @JvmStatic @Provides fun provideDiskCache() = DiskCache()   
    } 
} 

> The way this works is as follows: > > the companion object must also be annotated as @Module under the hood, > the kotlin compiler will duplicate those static provides methods into > the DataModule class. Dagger will see those and treat them like > regular static fields. Dagger will also see them in the companion > object, but that "module" will get code gen from dagger but be marked > as "unused". The IDE will mark this as such, as the provideDiskCache > method will be marked as unused. You can tell IntelliJ to ignore this > for annotations annotated with @Provides via quickfix

Solution 5 - Kotlin

For the static only approach, I like the solution of zsmb13.

However, I came here because I wanted to combine @Provides and @Binds within one module. This is not directly possible but with two nested modules (as Omar Al Halabi pointed out).

I took a slightly different approach for combining @Provides and @Binds:

@Module(includes = [MyModule.Bindings::class])
object MyModule {
	@Module
	interface Bindings {
		@Binds
		fun bindA(a: AImpl): A
	}

	@Provides
	@JvmStatic
	fun provideB(): B = BImpl()
}

The differences are:

  • The outer module is an object providing the static functions. This spares using the unintentional companion object.
  • The inner module holds the abstract bindings. I can use an interface here, which spares the abstract modifier in both the class and the function.
  • The outer module includes the inner module so I don't have to include the inner module elsewhere.

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionFredView Question on Stackoverflow
Solution 1 - KotlinOmar El HalabiView Answer on Stackoverflow
Solution 2 - Kotlinzsmb13View Answer on Stackoverflow
Solution 3 - KotlinPavneet_SinghView Answer on Stackoverflow
Solution 4 - KotlinsophiaView Answer on Stackoverflow
Solution 5 - KotlinPeter FView Answer on Stackoverflow