CODEWITHSUNDEEP
static-methodskotlin
Ragunath Jawahar
Ragunath Jawahar

Reputation: 19733

Static extension methods in Kotlin

How do you define a static extension method in Kotlin? Is this even possible? I currently have an extension method as shown below.

public fun Uber.doMagic(context: Context) {
    // ...
}

The above extension can be invoked on an instance.

uberInstance.doMagic(context) // Instance method

but how do I make it static method like shown below.

Uber.doMagic(context)         // Static or class method

Upvotes: 207

Views: 78028

Answers (10)

Andrey Breslav
Andrey Breslav

Reputation: 25787

To achieve Uber.doMagic(context), you can write an extension to the companion object of Uber (the companion object declaration is required):

class Uber {
    companion object {}
}

fun Uber.Companion.doMagic(context: Context) { }

EDIT

If the class is a Java class, it is not possible to add a static extension method. See https://youtrack.jetbrains.com/issue/KT-11968

Upvotes: 232

maxime1992
maxime1992

Reputation: 23813

Following on https://stackoverflow.com/a/33853233/2398593 if you're not working directly with some Kotlin code but dealing with some Java one, here's a quick/dirty workaround (that hopefully unblocks you):

If you're interested in a proposal to help out you can follow https://github.com/Kotlin/KEEP/issues/348 which is currently open and waiting for feedback.

Meanwhile, what I ended up doing for the moment to have it working with some Java code, was to create a wrapper class in Kotlin calling the Java static method.

Example, where the original method Webhook.constructEvent has overloads :

class CustomWebhook {
    companion object {
        fun constructEvent(payload: String, sigHeader: String, secret: String) =
            Webhook.constructEvent(payload, sigHeader, secret)
    }
}

Then I was able to use in my code CustomWebhook.constructEvent instead of Webhook.constructEvent without any issue in regards of the overloads.

This saved my day as my end goal was to be able to mock that method for a unit test using mockkStatic and I wasn't able because of the overloads issue.

Of course, wrapping everything is far from ideal. But this is just to be unstuck while keeping an eye on the issue

Upvotes: 0

Justin Warkentin
Justin Warkentin

Reputation: 10239

Since I keep coming across this when searching, here's a different approach I haven't seen anyone mention that works in a static way and it works with generics!

The trick is attaching the extension function to the KClass of the type instead since that can be referenced statically.

As mentioned by @Zaffy in the comments, to extend a specific type:

fun KClass<MyType>.doSomething() = /* do something */

Generic type extension:

// Extension function
fun <T> KClass<T>.doSomething() = /* do something */

// Extension Property
val <T> KClass<T>.someVal get() = /* something */

Usage:

MyType::class.doSomething()

MyType::class.someVal

Upvotes: 23

Matthew Bates
Matthew Bates

Reputation: 188

I also required the ability to extend a Java object with a static method and found the best solution for me was to create a Kotlin object that extended the Java class and add my method there.

object Colour: Color(){
    fun parseColor(r: Int?, g: Int?, b: Int?) = parseColor(String.format("#%02x%02x%02x", r, g, b))
}

invocation:

val colour = Colour.parseColor(62, 0, 100)

Upvotes: 1

daniel.jbatiz
daniel.jbatiz

Reputation: 447

To create an extension method in kotlin you have to create a kotlin file(not a class) then declare your method in the file Eg:

public fun String.toLowercase(){
    // **this** is the string object
}

Import the function in the class or file you are working on and use it.

Upvotes: -7

kyay10
kyay10

Reputation: 942

I actually had this exact question 30 minutes ago, so I started digging around and couldn't find any solution or workaround for this, BUT while searching I found this section on the Kotlinglang website that states that:

Note that extensions can be defined with a nullable receiver type. Such extensions can be called on an object variable even if its value is null.

So then I had the craziest idea ever, why not define an extension function with a nullable receiver (without actually using that receiver) and then call it on a null object! So I tried that, and it worked pretty well, but it looked so ugly. It was like this:

(null as Type?).staticFunction(param1, param2)

So I went around that by creating a val in my extensions file of the receiver type that had a value of null and then use it in my other class. So, as an example, here is how I implemented a "static" extension function for the Navigation class in Android: In my NavigationExtensions.kt file:

val SNavigation: Navigation? = null
fun Navigation?.createNavigateOnClickListener(@IdRes resId: Int, args: Bundle? = null, navOptions: NavOptions? = null,
                                                navigationExtras: Navigator.Extras? = null) : (View) -> Unit {
    //This is just implementation details, don't worry too much about them, just focus on the Navigation? part in the method declaration
    return { view: View -> view.navigate(resId, args, navOptions, navigationExtras) }
}

In the code that uses it:

SNavigation.createNavigateOnClickListener(R.id.action_gameWonFragment_to_gameFragment)

Obviously, this isn't a class name, it is just a variable of the class type that has a null value. This is obviously ugly on the extension maker side (because they have to create the variable) and on the developer side (because they have to use the SType format instead of the actual class name), but it is the closest that can be achieved right now compared to actual static functions. Hopefully, the Kotlin language makers will respond to the issue that was created and add that feature in the language.

Upvotes: 20

Nisazh
Nisazh

Reputation: 306

Recomend you to look at this link. As you can see there, you just should declare method at the top-level of the package (file):

package strings
public fun joinToString(...): String { ... }

This is equal to

package strings;

public class JoinKt {
    public static String joinToString(...) { ... }
}

With constans everything are the same. This declaration

val UNIX_LINE_SEPARATOR = "\n"

is equal to

public static final String UNIX_LINE_SEPARATOR = "\n";

Upvotes: 0

lucasddaniel
lucasddaniel

Reputation: 1789

This is what the official documentation says:

Kotlin generates static methods for package-level functions. Kotlin can also generate static methods for functions defined in named objects or companion objects if you annotate those functions as @JvmStatic. For example:

Kotlin static methods

class C {
  companion object {
    @JvmStatic fun foo() {}
    fun bar() {}
  }
}

Now, foo() is static in Java, while bar() is not:

C.foo(); // works fine
C.bar(); // error: not a static method

Upvotes: 15

kosiara - Bartosz Kosarzycki
kosiara - Bartosz Kosarzycki

Reputation: 11802

I'm also quite fond of having the possibility to add static extension methods in Kotlin. As a workaround for now I'm adding the exntension method to multiple classes instead of using one static extension method in all of them.

class Util    

fun Util.isDeviceOnline(context: Context): Boolean {
    val connMgr = context.getSystemService(Context.CONNECTIVITY_SERVICE) as ConnectivityManager
    val networkInfo = connMgr.activeNetworkInfo
    return networkInfo != null && networkInfo.isConnected
}

fun Activity.isDeviceOnline(context: Context) = { Util().isDeviceOnline(context) }
fun OkHttpClient.isDeviceOnline(context: Context) = { Util().isDeviceOnline(context) }

Upvotes: -4

bbarm
bbarm

Reputation: 113

You can create a static method with using Companion object like:

class Foo {
    // ...
    companion object {
        public fun bar() {
            // do anything
        }
    }
}

and then you can call it like:

class Baz {
    // ...
    private fun callBar() {
        Foo.bar()
    }
}

Upvotes: 7

Related Questions