ส่วนขยายตามขอบเขตและส่วนขยายของ Companion

เหตุใดจึงต้องกำหนดขอบเขตให้ส่วนขยาย

ส่วนขยายที่เป็นส่วนตัวระดับไฟล์

private fun String.shout() = uppercase() + "!"
fun main() {
    println("hello".shout()) // HELLO!
}

การมองเห็นภายใน

internal fun List<Int>.sumIfPositive(): Int = filter { it > 0 }.sum()
fun main() {
    println(listOf(-1, 2, 3, -4).sumIfPositive()) // 5
}

ฟังก์ชันส่วนขยายสมาชิก

class StringHelper(val prefix: String) {
    fun String.withPrefix() = prefix + this
    fun build(): String = "world".withPrefix() // calls extension via instance
}
fun main() {
    println(StringHelper("hello ").build()) // hello world
}

การมองเห็นของส่วนขยายสมาชิก

class Repo {
    fun List<Int>.allPositive() = all { it > 0 }
    fun check(xs: List<Int>) = xs.allPositive()
}
fun main() {
    val r = Repo()
    println(r.check(listOf(1, 2, 3))) // true
    // listOf(1).allPositive() // ERROR — no access
}

ส่วนขยายบนอ็อบเจ็กต์คู่หู

class Greeter {
    companion object
}
fun Greeter.Companion.morning() = "Good morning!"
fun main() {
    println(Greeter.morning())
}

เหตุใดจึงใช้ส่วนขยายของอ็อบเจ็กต์คู่หู

class User(val name: String) {
    companion object
}
fun User.Companion.guest() = User("Guest")
fun User.Companion.system() = User("System")
fun main() {
    println(User.guest().name)
    println(User.system().name)
}

ต้องมีอ็อบเจ็กต์คู่หูที่ว่างเปล่า

class Box {
    companion object // required, even if empty
}
fun Box.Companion.create(): Box = Box()
fun main() {
    println(Box.create())
}

ส่วนขยายแบบกำหนดขอบเขตผ่านการนำเข้า

// File A:
// fun String.shout() = uppercase()
// File B imports:
// import com.example.shout
// Only File B can call shout()
fun String.shout() = uppercase() + "!"
fun main() { println("hi".shout()) }

ฟังก์ชันส่วนขยายผ่านฟังก์ชันกำหนดขอบเขต

class StringTools {
    fun String.greet() = "Hello, $this!"
    fun process(name: String) = with(this) {
        name.greet()
    }
}
fun main() {
    println(StringTools().process("Ada"))
}

พร็อพเพอร์ตีส่วนขยายบนออบเจ็กต์ร่วม

class HttpStatus {
    companion object
}
val HttpStatus.Companion.OK_CODE: Int get() = 200
val HttpStatus.Companion.NOT_FOUND: Int get() = 404
fun main() {
    println(HttpStatus.OK_CODE)
    println(HttpStatus.NOT_FOUND)
}

แนวทางปฏิบัติที่ดี

class StringUtils {
    companion object
}
fun StringUtils.Companion.isAlpha(s: String) = s.all { it.isLetter() }
fun main() {
    println(StringUtils.isAlpha("hello"))
    println(StringUtils.isAlpha("hi5"))
}

ตรวจสอบความเข้าใจอย่างรวดเร็ว

สรุปทบทวน