전재:https://www.runoob.com/kotlin/kotlin-delegated.html

kotlin 위임

위탁 모델은 소프트웨어 디자인 모델 중의 기본적인 기교이다.위탁 모드에서 두 대상이 같은 요청을 처리하는 데 참여하고 요청을 받은 대상은 요청을 다른 대상에게 위탁하여 처리한다.
Kotlin은 위탁 모드를 직접 지원하여 더욱 우아하고 간결하게 합니다.Kotlin은 키워드 by를 사용하여 위임을 수행합니다.

클래스 위임

클래스의 의뢰는 하나의 클래스에서 정의된 방법으로 실제적으로 다른 클래스의 대상을 호출하는 방법으로 이루어진다.
다음 예에서 파생 클래스 Derived는 인터페이스 Base의 모든 방법을 계승하고, 이 방법을 실행하기 위해 전송된 Base 클래스의 대상을 의뢰합니다.

//  
interface Base {   
    fun print()
}

//  
class BaseImpl(val x: Int) : Base {
    override fun print() { print(x) }
}

//   by  
class Derived(b: Base) : Base by b

fun main(args: Array) {
    val b = BaseImpl(10)
    Derived(b).print() //   10
}

Derived 성명에서 by 자구는 b를 Derived의 대상 실례 내부에 저장하고 컴파일러는 Base 인터페이스에서 계승하는 모든 방법을 생성하여 b에 호출을 전달합니다.

속성 위임

속성 의뢰란 하나의 클래스의 특정한 속성 값을 클래스에서 직접 정의하는 것이 아니라 이를 하나의 에이전트 클래스에 의뢰하여 해당 클래스의 속성에 대한 통일된 관리를 실현하는 것을 말한다.
등록 정보 위임 구문 형식:

val/var :  by 

var/val: 속성 유형(가변/읽기 전용)

속성명: 속성명

유형: 속성의 데이터 유형

표현식: 위탁대리류

by 키워드 다음 표현식은 의뢰입니다. 속성의 get () 방법 (그리고 set () 방법) 은 이 대상에게 의뢰되는 getValue () 방법과 setValue () 방법입니다.속성 의뢰는 인터페이스를 실현할 필요는 없지만 getValue () 함수를 제공해야 합니다. (var 속성에 대해서는 setValue () 함수가 필요합니다.)

의뢰된 클래스 정의

이 클래스는 getValue () 방법과 setValue () 방법을 포함하고, 매개 변수thisRef는 의뢰를 진행하는 클래스의 대상이며, prop는 의뢰를 진행하는 속성의 대상이다.

import kotlin.reflect.KProperty
//  
class Example {
    var p: String by Delegate()
}

//  
class Delegate {
    operator fun getValue(thisRef: Any?, property: KProperty): String {
        return "$thisRef,   ${property.name}  "
    }

    operator fun setValue(thisRef: Any?, property: KProperty, value: String) {
        println("$thisRef   ${property.name}   $value")
    }
}
fun main(args: Array) {
    val e = Example()
    println(e.p)     //  ，  getValue()  

    e.p = "Runoob"   //   setValue()  
    println(e.p)
}

출력 결과는 다음과 같습니다.

Example@433c675d,   p  
Example@433c675d   p   Runoob
Example@433c675d,   p  

표준 위탁

Kotlin의 표준 라이브러리에는 속성을 실현하기 위한 공장 방법이 많이 내장되어 있습니다.

지연 속성 레이지

lazy () 는 함수입니다. Lambda 표현식을 매개 변수로 받아들여 Lazy 실례의 함수를 되돌려줍니다. 되돌아오는 실례는 지연 속성을 실현하는 의뢰로 사용할 수 있습니다. 첫 번째 get () 호출은 lazy () 에 전달된 lamda 표현식을 실행하고 결과를 기록합니다. 다음 get () 호출은 기록된 결과만 되돌려줍니다.

val lazyValue: String by lazy {
    println("computed!")     //  ， 
    "Hello"
}

fun main(args: Array) {
    println(lazyValue)   //  ， 
    println(lazyValue)   //  ， 
}

출력 수행 결과:

computed!
Hello
Hello

관찰가능 속성 Observable

observable는 관찰자 모드를 실현하는 데 사용할 수 있습니다.
Delegates.observable () 함수는 두 개의 인자를 받아들인다. 첫 번째는 초기화 값이고, 두 번째는 속성 값 변화 이벤트의 응답기 (handler) 이다.
속성에 값을 부여한 후에 이벤트를 실행하는 응답기(handler)는 세 가지 인자가 있습니다. 그것이 바로 값을 부여받은 속성, 옛 값과 새 값입니다.

import kotlin.properties.Delegates

class User {
    var name: String by Delegates.observable(" ") {
        prop, old, new ->
        println(" ：$old ->  ：$new")
    }
}

fun main(args: Array) {
    val user = User()
    user.name = " "
    user.name = " "
}

출력 수행 결과:

 ：  ->  ： 
 ：  ->  ： 

맵에 속성 저장

흔히 볼 수 있는 용례는 맵에 속성을 저장하는 값이다.이것은 JSON을 해석하거나 다른'동적'일을 하는 응용 프로그램에 자주 나타난다.이런 상황에서 당신은 실례 자체를 비추어 의뢰로 의뢰 속성을 실현할 수 있습니다.

class Site(val map: Map) {
    val name: String by map
    val url: String  by map
}

fun main(args: Array) {
    //  
    val site = Site(mapOf(
        "name" to " ",
        "url"  to "www.runoob.com"
    ))
    
    //  
    println(site.name)
    println(site.url)
}

출력 수행 결과:

 
www.runoob.com

var 속성을 사용하는 경우 Map을 MutableMap으로 변경해야 합니다.

class Site(val map: MutableMap) {
    val name: String by map
    val url: String by map
}

fun main(args: Array) {

    var map:MutableMap = mutableMapOf(
            "name" to " ",
            "url" to "www.runoob.com"
    )

    val site = Site(map)

    println(site.name)
    println(site.url)

    println("--------------")
    map.put("name", "Google")
    map.put("url", "www.google.com")

    println(site.name)
    println(site.url)

}

출력 수행 결과:

 
www.runoob.com
--------------
Google
www.google.com

Not Null

notNull은 초기화 단계에서 속성 값을 정할 수 없는 경우에 적용됩니다.

class Foo {
    var notNullBar: String by Delegates.notNull()
}

foo.notNullBar = "bar"
println(foo.notNullBar)

속성이 값을 부여하기 전에 접근되면 이상이 발생합니다.

로컬 위임 속성

당신은 국부 변수를 위탁 속성으로 성명할 수 있습니다.예를 들어, 로컬 변수의 불활성을 초기화할 수 있습니다.

fun example(computeFoo: () -> Foo) {
    val memoizedFoo by lazy(computeFoo)

    if (someCondition && memoizedFoo.isValid()) {
        memoizedFoo.doSomething()
    }
}

memoizedFoo 변수는 처음 액세스할 때만 계산됩니다.someCondition이 실패하면 변수가 계산되지 않습니다.

속성 위임 요구 사항

읽기 전용 속성 (즉 val 속성) 에 대한 의뢰는 getValue () 라는 함수를 제공해야 합니다.이 함수는 다음 매개변수를 적용합니다.

thisRef - 속성 소유자 유형(확장 속성에 대해 확장된 유형을 가리키는 말)과 같거나 초유형

이어야 합니다

property - 유형 Kproperty 또는 그 초유형이어야 합니다

이 함수는 속성과 같은 형식 (또는 하위 형식) 을 되돌려야 합니다.
값 가변 (mutable) 속성 (즉 var 속성) 은 getValue () 함수를 제외하고 setValue () 라는 함수를 추가로 제공해야 합니다. 이 함수는 다음 인자를 수락합니다.

property - 유형 Kproperty 또는 그 초유형이어야 합니다

newvalue - 속성과 같은 유형이거나 초유형이어야 합니다.

번역 규칙

Kotlin 컴파일러는 모든 위임 속성의 실현 뒤에 보조 속성을 생성하여 위임합니다.예를 들어 속성 prop에 대해 숨겨진 속성 prop$delegate를 생성하고, 액세서리의 코드는 이 추가 속성에 간단하게 의뢰합니다.

class C {
    var prop: Type by MyDelegate()
}

//  ：
class C {
    private val prop$delegate = MyDelegate()
    var prop: Type
        get() = prop$delegate.getValue(this, this::prop)
        set(value: Type) = prop$delegate.setValue(this, this::prop, value)
}

Kotlin 컴파일러는 매개 변수에서prop에 대한 모든 필요한 정보를 제공합니다. 첫 번째 매개 변수인this는 외부 클래스 C의 실례를 인용하고this: property는 Kproperty 형식의 반사 대상입니다. 이 대상은prop 자체를 설명합니다.

위탁을 제공하다

provideDelegate 조작부호를 정의함으로써 위탁 대상의 논리를 실현하는 속성을 확장할 수 있습니다.만약by 오른쪽에 있는 대상이provideDelegate를 구성원이나 확장 함수로 정의한다면, 이 함수를 호출하여 속성 의뢰 실례를 만들 것입니다.
provideDelegate의 가능한 사용 장면은 속성을 만들 때 (Getter나setter뿐만 아니라) 속성 일치성을 검사하는 것입니다.
예를 들어, 바인딩하기 전에 속성 이름을 확인하려면 다음과 같이 하십시오.

class ResourceLoader(id: ResourceID) {
    operator fun provideDelegate(
            thisRef: MyUI,
            prop: KProperty
    ): ReadOnlyProperty {
        checkProperty(thisRef, prop.name)
        //  
    }

    private fun checkProperty(thisRef: MyUI, name: String) { …… }
}

fun  bindResource(id: ResourceID): ResourceLoader { …… }

class MyUI {
    val image by bindResource(ResourceID.image_id)
    val text by bindResource(ResourceID.text_id)
}

provideDelegate의 매개변수는 getValue와 같습니다.

thisRef - 속성 소유자 유형(확장 속성에 대해 확장된 유형을 가리키는 말)과 같거나 초유형

이어야 합니다

property - 유형 Kproperty 또는 하이퍼유형이어야 합니다.

MyUI 실례를 만드는 동안 모든 속성에provideDelegate 방법을 호출하고 필요한 검증을 즉시 실행합니다.
만약 이러한 속성과 그 의뢰 사이의 귀속을 차단하는 능력이 없다면 같은 기능을 실현하기 위해 당신은 반드시 속성명을 현식으로 전달해야 합니다. 이것은 매우 편리하지 않습니다.

//  “provideDelegate” 
class MyUI {
    val image by bindResource(ResourceID.image_id, "image")
    val text by bindResource(ResourceID.text_id, "text")
}

fun  MyUI.bindResource(
        id: ResourceID,
        propertyName: String
): ReadOnlyProperty {
   checkProperty(this, propertyName)
   //  
}

생성된 코드에서provideDelegate 방법을 호출하여 보조적인prop$delegate 속성을 초기화합니다.속성 선언 val prop: Type by My Delegate()에서 생성된 코드와 위쪽(provide Delegate 메서드가 존재하지 않을 때) 생성된 코드를 비교합니다.

class C {
    var prop: Type by MyDelegate()
}

//  “provideDelegate” 
//  ：
class C {
    //  “provideDelegate” “delegate” 
    private val prop$delegate = MyDelegate().provideDelegate(this, this::prop)
    val prop: Type
        get() = prop$delegate.getValue(this, this::prop)
}

provideDelegate 방법은 보조 속성의 생성에만 영향을 주고 Getter나setter에 생성된 코드에는 영향을 주지 않습니다.