4.2 Kotlin標(biāo)準(zhǔn)庫函數(shù)

歡迎前往我的CSDN
Kotlin提供了一個(gè)系統(tǒng)庫巍膘，是Java庫的增強(qiáng)缨硝，很多函數(shù)適配了Java的類型和方法击罪，同時(shí)使用Kotlin的語法哲嘲，下面我們來研究下廣泛使用的函數(shù)。

Apply

apply 是 Any 的擴(kuò)展函數(shù), 因而所有類型都能調(diào)用媳禁。
apply 接受一個(gè)lambda表達(dá)式作為參數(shù)眠副，并在apply調(diào)用時(shí)立即執(zhí)行，apply返回原來的對象竣稽。
apply 主要作用是將多個(gè)初始化代碼鏈?zhǔn)讲僮鞔雅拢岣叽a可讀性。

參考以下實(shí)例我們來分析下：

fun main(args: Array<String>) {
    val runnable  = Runnable { 
        print("is running")
    }
    val thread = Thread(runnable)

    thread.isDaemon = true
    thread.start()
}

我們用標(biāo)準(zhǔn)庫函數(shù)Apply來改寫代碼：

fun main(args: Array<String>) {
    val runnable = Runnable {
        print("is running")
    }
    Thread(runnable).apply { isDaemon = true }.start()
}

看看代碼是不是減少了不少啊毫别，我們創(chuàng)建了一個(gè)Runnable實(shí)例娃弓，然后創(chuàng)建了一個(gè)線程運(yùn)行這個(gè)實(shí)例，在閉包中我們配置線程實(shí)例為一個(gè)守護(hù)線程岛宦。閉包中的代碼會(huì)在線程實(shí)例上運(yùn)行台丛，并且可以直接在返回值上調(diào)用start()方法。

let

let默認(rèn)當(dāng)前這個(gè)對象作為閉包的it參數(shù)砾肺，返回值是函數(shù)的最后一行或者指定return結(jié)果挽霉。
let 和 apply 類似私恬，唯一的不同是返回值，let返回的不是原來的對象炼吴，而是閉包里面的值本鸣。

fun main(args: Array<String>) {
    println(testLet())
}

fun testLet():Int{
    "Alfred".let {
        println(it)
        println(it.length)
        return 999  //指定返回值為999
    }
}

結(jié)果：

Alfred
6
999

fun main(args: Array<String>) {
    val name = "Alfred".let {
        println(it)
        println(it.length)
        "張三" //沒指定返回值時(shí)，默認(rèn)返回值為閉包的最后一行
    }

    println(name)
}

結(jié)果：

Alfred
6
張三

with

有時(shí)候我們在執(zhí)行對象的多個(gè)方法時(shí)硅蹦，必須要寫很多次對象名荣德，顯得很啰嗦。比如：

class Persion(val name: String, val age: Int, val sex: String) {

    fun showName() {
        println(name)
    }

    fun showAge() {
        println(age)
    }

    fun showSex() {
        println(sex)
    }
}


fun main(args: Array<String>) {
    val persion = Persion("alfred",29,"男")
    persion.showName()
    persion.showSex()
    persion.showAge()
}

執(zhí)行結(jié)果：

alfred
男
29

persion這個(gè)實(shí)例名是不是重復(fù)寫了很多遍啊童芹。雖然很整齊啊涮瞻，但是不推崇。
下面我們使用with來簡化下代碼：

fun main(args: Array<String>) {
    val persion = Persion("alfred",29,"男")
    with(persion){
        showName()
        showSex()
        showAge()
    }
}

看看是不是相對來說簡化了假褪，也挺清晰易懂的署咽。

run

run函數(shù)跟apply函數(shù)很像，只不過apply返回當(dāng)前自身對象生音，而run返回最后一行或指定值宁否，run 就是with與let組合。

fun main(args: Array<String>) {
    val name = "Alfred".run {
        println(this)
        println(this.length)
        "張三" //返回最后一行
    }

    println(name)
    println(testRun()) 
}

fun testRun():String{
    "Alfred".run {
        return "jack" //指定返回
    }
}

結(jié)果：

Alfred
6
張三
jack

lazy

lazy是另一個(gè)很有用的函數(shù)缀遍，可以把非常耗費(fèi)資源的操作延遲到第一次調(diào)用時(shí)加載慕匠。比如：

fun main(args: Array<String>) {
    val name = lazy {
        for (i in 1..10) {
            print("# ")
        }
        "alfred"
    }

    println(name.value)
    println(name.value)
}

結(jié)果：

# # # # # # # # # # alfred
alfred

第一次調(diào)用println(name.value)時(shí)，才會(huì)初始化name域醇，先執(zhí)行for循環(huán)打印10次#台谊，再初始化值為alfred。第二次調(diào)用println(name.value)時(shí)譬挚，name已經(jīng)賦值為alfred锅铅，所以直接打印alfred。
總結(jié)：第一次調(diào)用時(shí)减宣，lazy 閉包會(huì)調(diào)用盐须。一般用在單例模式。

use

use與try語句類似蚪腋，實(shí)現(xiàn)了Closeable接口的對象可調(diào)用use函數(shù)丰歌，use函數(shù)會(huì)自動(dòng)關(guān)閉調(diào)用者（無論中間是否出現(xiàn)異常）。下面我們看下源碼：

/**
 * Executes the given [block] function on this resource and then closes it down correctly whether an exception
 * is thrown or not.
 *
 * @param block a function to process this [Closeable] resource.
 * @return the result of [block] function invoked on this resource.
 */
@InlineOnly
@RequireKotlin("1.2", versionKind = RequireKotlinVersionKind.COMPILER_VERSION, message = "Requires newer compiler version to be inlined correctly.")
public inline fun <T : Closeable?, R> T.use(block: (T) -> R): R {
    var exception: Throwable? = null
    try {
        return block(this)
    } catch (e: Throwable) {
        exception = e
        throw e
    } finally {
        when {
            apiVersionIsAtLeast(1, 1, 0) -> this.closeFinally(exception)
            this == null -> {}
            exception == null -> close()
            else ->
                try {
                    close()
                } catch (closeException: Throwable) {
                    // cause.addSuppressed(closeException) // ignored here
                }
        }
    }
}

可以看出屉凯，use函數(shù)內(nèi)部實(shí)現(xiàn)也是通過try-catch-finally塊捕捉的方式，所以不用擔(dān)心會(huì)有異常拋出導(dǎo)致程序退出眼溶。
close操作在finally里面執(zhí)行悠砚，所以無論是正常結(jié)束還是出現(xiàn)異常，都能正確關(guān)閉堂飞。
看個(gè)例子：

fun main(args: Array<String>) {
val io = Files.newInputStream(Paths.get("/data/home/alfred/TestKotlin/.idea/encodings.xml"))
    val info = io.use {
        it.bufferedReader().readLines()
    }
   println(info)
}

結(jié)果：

[<?xml version="1.0" encoding="UTF-8"?>, <project version="4">,   <component name="Encoding">,     <file url="PROJECT" charset="UTF-8" />,   </component>, </project>]

use 無論如何都會(huì)將 io close, 避免了寫復(fù)雜的 try-catch-finally 代碼灌旧。Kotlin的IO流操作變得行云流水绑咱。

repeat

顧名思義，repeat 接受函數(shù)和整數(shù)作為參數(shù)枢泰，函數(shù)會(huì)被調(diào)用指定次描融，這個(gè)函數(shù)避免寫循環(huán)。
還記得lazy初始化那個(gè)打印#的例子嗎衡蚂？我們把for循環(huán)改寫下：

fun main(args: Array<String>) {
    val name = lazy {
        repeat(10) { print("# ") }
        "alfred"
    }

    println(name.value)
    println(name.value)
}

結(jié)果：

# # # # # # # # # # alfred
alfred

簡單吧Ａ恕！語法可有抽象為：

repeat(次數(shù)) { 
    重復(fù)語句
}

require/assert/check

require負(fù)責(zé)檢查輸入的參數(shù)毛甲，如果有問題年叮，拋出IllegalArgumentException
check負(fù)責(zé)檢查自身是否萬事俱備可以執(zhí)行了，如果不是玻募，拋出IllegalStateException
require + check就是在做前置條件的檢查只损，通過了才可以執(zhí)行真正的程序邏輯
assert負(fù)責(zé)確保程序執(zhí)行完畢后的結(jié)果/內(nèi)部狀態(tài)是否符合預(yù)期，如果不是七咧，拋出AssertionError

此處只列出相關(guān)知識點(diǎn)跃惫，有興趣的話可以參考如下博客,寫得非常詳盡。
用好 Require,check,assert,寫好 Kotlin 代碼