[譯]Object的局限性——Kotlin中的帶參單例模式

原文:Kotlin singletons with argument
——object has its limits

作者:Christophe Beyls
譯者:卻把清梅嗅

Kotlin中,單例模式被用于替換該編程語言中不存在的static成員和字段。 你通過簡單地聲明object以創建一個單例:

object SomeSingleton

與類不同,object 不允許有任何構造函數,如果有需要,可以通過使用 init 代碼塊進行初始化的行為:

object SomeSingleton {
    init {
        println("init complete")
    }
}

這樣object將被實例化,并且在初次執行時,其init代碼塊將以線程安全的方式懶惰地執行。 為了這樣的效果,Kotlin對象實際上依賴于Java靜態代碼塊 。上述Kotlin的 object 將被編譯為以下等效的Java代碼:

public final class SomeSingleton {
   public static final SomeSingleton INSTANCE;

   private SomeSingleton() {
      INSTANCE = (SomeSingleton)this;
      System.out.println("init complete");
   }

   static {
      new SomeSingleton();
   }
}

這是在JVM上實現單例的首選方式,因為它可以在線程安全的情況下懶惰地進行初始化,同時不必依賴復雜的雙重檢查加鎖(double-checked locking)等加鎖算法。 通過在Kotlin中簡單地使用object進行聲明,您可以獲得安全有效的單例實現。

image

圖:無盡的孤獨——單例(譯者:作者的描述讓我想起了一個悲情的角色,Maiev Shadowsong

傳遞一個參數

但是,如果初始化的代碼需要一些額外的參數呢?你不能將任何參數傳遞給它,因為Kotlinobject關鍵字不允許存在任何構造函數。

有些情況下,將參數傳遞給單例初始化代碼塊是被推薦的方式。 替代方法要求單例類需要知道某些能夠獲取該參數的外部組件(component),但違反了關注點分離的原則并且使得代碼不可被復用。

為了緩解這個問題,該外部組件可以是 依賴注入系統。這的確是一個具有可行性的解決方案,但您并不總是希望使用這種類型的庫——并且,在某些情況下您也無法使用它,就像在接下來的Android示例中我將會所提到的。

在Kotlin中,您必須通過不同的方式去管理單例的另一種情況是,單例的具體實現是由外部工具或庫(比如RetrofitRoom等等)生成的,它們的實例是通過使用Builder模式或Factory模式來獲取的——在這種情況下,您通常將單例通過interfaceabstract class進行聲明,而不是object

一個Android示例

Android平臺上,您經常需要將Context實例作為參數傳遞給單例組件的初始化代碼塊中,以便它們可以獲取 文件路徑讀取系統設置開啟Service等等,但您還希望避免對其進行靜態引用(即使是Application的靜態引用在技術上是安全的)。 有兩種方法可以實現這一目標:

  • 提前初始化:在運行任何(幾乎)其他代碼之前,通過在Application.onCreate()中調用初始化所有組件,此時Application是可用的——這個簡單的解決方案的主要缺點是它是通過阻塞主線程的方式來減慢應用程序啟動,并初始化了所有組件,甚至包括那些不會立即使用的組件。另一個鮮為人知的問題是,在調用此方法之前,Content Provider也許已經被實例化了(正如文檔中所提到的),因此,若Content Provider使用全局的相關組件,則您必須保證能夠在Application.onCreate()之前初始化該組件,否則您的申請依然可能會導致應用崩潰。
  • 延遲初始化:這是推薦的方法。組件是單例,返回其實例的函數持有Context參數。該單例將在第一次調用該函數時使用此參數進行創建和初始化操作。這需要一些同步機制才能保證線程的安全。使用此模式的標準Android組件的示例是LocalBroadcastManager
LocalBroadcastManager.getInstance(context).sendBroadcast(intent)

可復用的Kotlin實現方式

我們可以通過封裝邏輯來懶惰地在SingletonHolder類中創建和初始化帶有參數的單例。

為了使該邏輯的線程安全,我們需要實現一個同步算法,它是最有效的算法,同時也是最難做到的——它就是 雙重檢查鎖定算法(double-checked locking algorithm)

open class SingletonHolder<out T, in A>(creator: (A) -> T) {
    private var creator: ((A) -> T)? = creator
    @Volatile private var instance: T? = null

    fun getInstance(arg: A): T {
        val i = instance
        if (i != null) {
            return i
        }

        return synchronized(this) {
            val i2 = instance
            if (i2 != null) {
                i2
            } else {
                val created = creator!!(arg)
                instance = created
                creator = null
                created
            }
        }
    }
}

請注意,為了使算法正常工作,這里需要將@Volatile注解對instance成員進行標記。

這可能不是最緊湊或優雅的Kotlin代碼,但它是為雙重檢查鎖定算法生成最行之有效的代碼。請信任Kotlin的作者:實際上,這些代碼正是從Kotlin標準庫中的 lazy() 函數的實現中直接借用的,默認情況下它是同步的。它已被修改為允許將參數傳遞給creator函數。

有鑒于其相對的復雜性,它不是您想要多次編寫(或者閱讀)的那種代碼,實際上其目標是,讓您每次必須使用參數實現單例時,都能夠重用該SingletonHolder類進行實現。

聲明getInstance()函數的邏輯位置在singleton類的伴隨對象內部,這允許通過簡單地使用單例類名作為限定符來調用它,就好像Java中的靜態方法一樣。Kotlin的伴隨對象提供的一個強大功能是它也能夠像任何其他對象一樣從基類繼承,從而實現與僅靜態繼承相當的功能。

在這種情況下,我們希望使用SingletonHolder作為單例類的伴隨對象的基類,以便在單例類上重用并自動公開其getInstance()函數。

對于SingletonHolder類構造方法中的creator參數,它是一個函數類型,您可以聲明為一個內聯(inline)的lambda,但更常用的情況是 作為一個函數引用的依賴交給構造器,最終其代碼如下所示:

class Manager private constructor(context: Context) {
    init {
        // Init using context argument
    }

    companion object : SingletonHolder<Manager, Context>(::Manager)
}

現在可以使用以下語法調用單例,并且它的初始化將是lazy并且線程安全的:

Manager.getInstance(context).doStuff()

當三方庫生成單例實現并且Builder需要參數時,您也可以使用這種方式,以下是使用Room 數據庫的示例:

@Database(entities = arrayOf(User::class), version = 1)
abstract class UsersDatabase : RoomDatabase() {

    abstract fun userDao(): UserDao

    companion object : SingletonHolder<UsersDatabase, Context>({
        Room.databaseBuilder(it.applicationContext,
                UsersDatabase::class.java, "Sample.db")
                .build()
    })
}

注意:當Builder不需要參數時,您只需使用lazy的屬性委托:

interface GitHubService {

    companion object {
        val instance: GitHubService by lazy {
            val retrofit = Retrofit.Builder()
                    .baseUrl("https://api.github.com/")
                    .build()
            retrofit.create(GitHubService::class.java)
        }
    }
}

我希望這些代碼能夠給您帶來一些啟發。如果您有建議或疑問,請不要猶豫,在評論部分開始討論,感謝您的閱讀!

--------------------------廣告分割線------------------------------

關于我

Hello,我是卻把清梅嗅,如果您覺得文章對您有價值,歡迎 ??,也歡迎關注我的博客或者Github

如果您覺得文章還差了那么點東西,也請通過關注督促我寫出更好的文章——萬一哪天我進步了呢?

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容

  • 本文是在學習和使用kotlin時的一些總結與體會,一些代碼示例來自于網絡或Kotlin官方文檔,持續更新... 對...
    竹塵居士閱讀 3,321評論 0 8
  • 面向對象編程(OOP) 在前面的章節中,我們學習了Kotlin的語言基礎知識、類型系統、集合類以及泛型相關的知識。...
    Tenderness4閱讀 4,479評論 1 6
  • 第3章 基本概念 3.1 語法 3.2 關鍵字和保留字 3.3 變量 3.4 數據類型 5種簡單數據類型:Unde...
    RickCole閱讀 5,151評論 0 21
  • Kotlin的優勢 代碼簡潔高效、強大的when語法,不用寫分號結尾,findViewById光榮退休,空指針安全...
    Windy_816閱讀 1,314評論 1 6
  • 我用你的的指甲 刻了車窗 又用你的頭發 織了衣裳。 也把你的眼睛 縫在了我的抱枕上 還把你的雙腳 藏在了我沉重的行...
    一個博閱讀 172評論 1 3