How to use Delegated Properties in Kotlin. Using Delegated Properties is a way to simplify your redundant code.

1. Kotlin黑魔法：Delegated Properties
En-Ping Hsieh

2. 大綱
●什麼是 Delegated Properties？
●Built-in Delegated Properties
●自己的Delegated Properties自己做！

3. 什麼是 Delegated Properties？

4. Property是什麼？

5. 定義一個叫name的Property

6. 所以Property就是變數？

7. Field
類別的資料成員，用來保存狀態的。

8. Property Field不是

9. 定義一個叫bulbBrightness的Property

10. Property
物件的屬性，通過存取器(Getter/Setter)來表現資料

11. 當你定義一個 property X，編譯器會為你產生
●一組存取器(accessors)：getX(), setX(...)
●Backing field

12. 當你去讀取 property X 時
val y = this.x
實則是隱式調用getX()
val y = this.getX()
同理，當你對 property X 賦值時
this.x = y
其實是呼叫setX(...)
this.setX(y)

13. Properties represent
accessors(getter/setter), not field.

14. 因為Property是由函式組成，所以代表著可以有更
多的使用可能。

15. 例如有一個代表面積的property

16. 又或者是滿足序列化和易用性...

17. 但也有些需要小心的地方...

18. 這樣會造成重複定義...

19. 或是不小心就遞迴了...

20. 或是不小心就遞迴了...

21. 回顧一下Property...

22. Setter
Getter
Property
Field
Other
valvar

23. A little more...

26. 什麼是 Delegate?

27. 假設我定義一個 CountableList 介面，除了取值和
插入外，還要能夠記錄取值的次數。

29. 繼承 ArrayList 並實作 CountableList 介面？

31. 讓我們想想這有沒有什麼缺點？
●函數名稱容易衝突，被父類別限制。
●由於是繼承，無法在執行時期變更實作。

32. 如果把ArrayList放在MyList裡面，再把任務都交給他？

34. 這樣做改變了什麼？
●函數名稱容易衝突，被父類別限制。
●由於是繼承因此無法在執行時期變更實作。
✔
✔

35. 委派模式是一種物件導向的設計模式，旨在希望透過組合而
非繼承的方式達到程式碼重用。

36. 什麼是Delegated Properties?

37. 開發中發現行為相似的 properties，而這時候可
以將這些行為提取成類別並使用委派來取代相似
的程式碼。

38. var/val by DelegateObject()prop: Type
Delegated Property的使用方式

39. Built-in Delegated Properties
notNull, map, lazy and observable

40. NotNull
lateinit不適用於基本型態，可以使用notNull。

41. Map
property 會被委派給 map 中同名 key 的值

42. Lazy
●Lazy initialization
●Thread-safe

43. ● LazyThreadSafetyMode.SYNCHRONIZED (預設)
只初始化一次且保證執行緒安全。
● LazyThreadSafetyMode.PUBLICATION
可能會初始化多次，但只有首次的結果會被使用。
● LazyThreadSafetyMode.NONE
只有延遲初始化，適合在單一執行緒下的元件如View widget。
Lazy Delegation的執行緒安全模式

44. Observable(不是Rx那個)

45. 自己的Delegated Properties自己做！

46. Show, don’t tell.

49. Delegated Properties 可以做到哪些功能?
●View and Resource Binding
取代 ButterKnife 或是不想使用 Kotlin Android Extension
●Data Binding
SharedPreference或是Configuration
●Dependency Injection
Koin中大量使用

50. Let’s get our hands dirty!

52. 這看起來是相似的模式，都是記錄property
的改變和讀取，且可能有許多類似的需求。

53. 回顧一下Delegated Properties

54. Setter
Getter
Property
valvar
by
Delegated Object
getValue()
setValue()
field(optional)

55. Class Owner {
}
Delegated classProperty
定義Delegated Object的關係
var/val by DelegatedClass()prop: Type
Property type
Property owner

56. var by
class LogProperty
operator fun getValue()
operator fun setValue()
userId: String
profile: Profile?
var value : Generic type
設計Delegated Object

57. 再看一次原本的程式碼...

59. 希望簡化後...

61. var value
Generic type
fun getValue
log value
fun setValue
log value changed

62. 仔細瞧瞧setValue()
●thisRef: Any?
●prop: KProperty<*>
●newValue: T

63. 仔細瞧瞧setValue()
●thisRef: Any?
參數的型態限制delegated class可以在哪些property owner下使用。
其型態必須是property owner的型態或其父類別型態。
若property 位在top-level時會是Null
每次property被賦值時，該property owner的實例也會被當作參數傳入。
Class PropertyOwner {
}
var/val by DelegatedClass()prop: Type

64. 仔細瞧瞧setValue()
●prop: KProperty<*>
其型態必須是KProperty<*>的型態或其父類別型態。
每次property被賦值時，該property的名稱(ex. “userId”, “profile”)和property
type(ex. String, Profile?)以及各種資訊會被封裝成KProperty型態的參數傳入
。
Class PropertyOwner {
}
var/val by DelegatedClass()prop: Type

65. 仔細瞧瞧setValue()
●newValue: T
參數的型態限制哪些property type可以使用該delegated class。其型態必須
是該property的型態或其父類別型態。
每次property被賦值時，新的值會被作為參數傳遞。
Class PropertyOwner {
}
var/val by DelegatedClass()prop: Type

66. 仔細瞧瞧setValue()
●函數主體
Log.d(tag, "${prop.name}: $value -> $newValue")
value = newValue
Class PropertyOwner {
}
var/val by DelegatedClass()prop: Type

67. 但這些這些函數簽名很難記得...

68. 善用Kotlin提供的Delegated Properties 介面
●val → 實作ReadOnlyProperty<R, T>
var → 實作ReadWriteProperty<R, T>
●R 代表 property owner 而 T 代表 property type
Class PropertyOwner {
}
var/val by DelegatedClass()prop: Type

69. 挑戰時間！

73. Summary
●Properties 代表存取函式而非欄位
●委派模式允許物件通過組合來達成程式碼重用
●DRY! 多用lazy, notNull
●觀察相似的部分並抽取出來成為Delegated Property
●Delegated Property可以藉由泛型功能取代Annotation processing
●預先定義的介面幫助我們更容易實作Delegated Properties

74. 參考資料
●Effective Kotlin - Item 21
●https://hackernoon.com/kotlin-delegates-in-android-development-part-1-50346cf4aed7
●https://medium.com/techshots/delegate-properties-in-kotlin-39524fc4ea13
●https://americanexpress.io/advanced-kotlin-delegates/
●https://proandroiddev.com/the-magic-in-kotlin-delegates-377d27a7b531
●https://medium.com/rocket-fuel/kotlin-by-property-delegation-create-reusable-code-
f2bc2253e227

75. The End