CodeGym /課程 /Kotlin SELF /runCatching: try/catch, onSuccess/onFailure

runCatching: try/catch, onSuccess/onFailure

Kotlin SELF
等級 40, 課堂 4
開放

1. Jianjie

Dang ni gang kaishi xue xie chengshi shi,try/catch kan qilai xiang yi ge xiaofang miehuoqi:gua zai qiang shang,fang zhe yong de dao. Dan dang ni xie zhenshi code(jiushi shi console app)shi,huiran faxian zhege “miehuoqi” jianshi yong dao bu de le:shuzi parsing、tongguo require jiancha qianzhitiao jian、fangwen collection、chuli waibu shuju — zhexie dou shi qian zai exception lai yuan.

Wentibushi try/catch bu hao. Wentishi ta hen kuai jiu hui “zhang da”:chuxian duoyu de variable、cengceng nested block,code kan qilai xiang migong. Kotlin de haochu shi try/catch shi expression(keyi ba result assign gei val)。Dan jiushi zheyang,ren hai shi hui xiang yao geng “functional” de xingshi:na dao yi ge result,ran hou yong chain jixu chuli — xiang women zai collection shang yong (map、filter deng) na yang.

Zhe jiu shi runCatching chuxian de didian:ta ba “keyi throw exception de code” biancheng yi ge Result<T> leixing de zhi,ni keyi xiang duidai putong object yiyang chuli:quchu value、chuli error、print message、zai wang shang ceng return.

2. runCatching daodi zai zuo shenme

Ruguo shuo zhenshi hua,runCatching bushi “xin de error handling xitong”. Ta zhishi ba try/catch jinjian de baozhuang jin Result. Ta bu hui bang ni jueding shenme suan error、zai nali chuli. Ta zhishi gaibian le xingshi:yuanlai shi “yong exception kongzhi liucheng”,xianzai shi “yong Result zhe ge value”.

Hai you yi dian hen zhongyao:Kotlin li de try/catch hui return try zhong zuihou yi ge expression de value,huozhe fa sheng de catch block zuihou yi ge expression de value;er finally zong shi hui zhixing,dan bu hui yingxiang jisuan chulai de value. Zhe zhong moxing zai guannian shang feichang xiang: “libian fasheng le shenme → chukou dedao yi ge result”.

Ni keyi xiangxiang runCatching zai guannian shang da gai shi zheyang zuo de(jianhua ban):

fun <T> myRunCatching(block: () -> T): Result<T> =
    try {
        Result.success(block())
    } catch (e: Throwable) {
        Result.failure(e)
    }

Yong runCatching { ... } de syntax,jiu bu yong meici dou xie zhe yi da duan.

Zai yi ge hen zhiguan de renwu shang ju yi ge mini example — parsing zhengshu:

fun parseIntViaTry(text: String): Int? {
    return try {
        text.toInt()
    } catch (e: NumberFormatException) {
        null
    }
}

Xianzai yong runCatching zuo yi yang de shi,dan women return bu zai shi Int?,er shi Result<Int>:

fun parseIntResult(text: String): Result<Int> {
    return runCatching { text.toInt() }
}

Yiyi shang de chabie hen da:Int? zhi neng biao shi “chenggong / shibai”,dan bu shuo ming “wei shenme”. Result<Int> hui ba exception cun qilai,ye jiushi ba cuowu yuanyin de xinxi baoliu le.

3. Ruhe cong Result quchu value,you bu ba code biancheng yituan

Dao zhe yi bu,xinshou changchang hui xiang zheyang: “Oh,Result!na wo xianzai ba value na chu lai,jiu keyi jixu le”. Zhe hen zhengchang — zhi shi yao yishi dao:zai zhe ge shike,ni qi shi zai xuanze error handling policy.

Kotlin li de try/catch zuowei expression,yijing rang women xiguan le “jiezui huide dao yi ge value”. Result ye shi tongyang de siwei,zhi shi zhe ge value keyi shi “success” huo “failure”.

Women kan kan zui shiyong de ji zhong quchu fangshi:

fun main() {
    val r1 = runCatching { "123".toInt() }
    println(r1.getOrNull())          // 123

    val r2 = runCatching { "oops".toInt() }
    println(r2.getOrNull())          // null
}

getOrNull() hen shihe ni zhen de zhi xuyao “you / mei you” zhe liang zhong jieguo de shihou. Dan ta you fengxian:ni na dao le null,ran hou jiu wangji le li mian yuanben you yi ge error. Zhe ji ben shang jiu xiang yinwei alarm tai chao,jiu ba alarm guan le.

getOrElse { ... } shi yi ge ni keyi zidingyi fallback value de xuanze:

fun main() {
    val amount = runCatching { "oops".toInt() }
        .getOrElse { 0 }

    println(amount)                  // 0
}

Zhe hen fangbian,dan dang 0 hui gaibian program yiyi shi,jiu hen weixian. You shihou 0 shi zhengchang default,you shihou ze shi “women yijing mo mo ba zhichu ji cheng 0,ran hou zai baobiao li jingya”.

Hai you yi ge “ying” de xuanze — getOrThrow():ta hui return value,huozhe ba exception zai ci throw chu qu. Dang ni zai zhe yi ceng bu xiang jueding,bing qie renwei zhe shi yi ge yanzhong cuowu shi,zhe hen youyong.

4. onSuccess he onFailure:bu yong if de fen zhi,dan xuyao jijiu

Dang ni kan dao onSuccess { ... } he onFailure { ... } shi,nabei hui hen kaixin: “tai hao le,wo keyi yong chain xie yige hen piaoliang de chuli liucheng!” Zhe que shi meicuo. Dan zhe liang ge method you ge hen zhongyao de te dian:ta men shi gei fu zuoyong yong de(print、gengxin state、jilu message),er bu shi yong lai “ba error biancheng yige value”.

Ye jiushi shuo,onSuccess he onFailure bu hui qu daiti getOrElse,ye bu hui “xiufu” error. Ta men zhi shi tigong yi ge fangbian de weizhi,rang ni keyi genju jieguo zuo dian shenme.

Mini example:

fun main() {
    runCatching { "42".toInt() }
        .onSuccess { println("Chenggong: $it") }           // Chenggong: 42
        .onFailure { println("Cuowu: ${it.message}") }

    runCatching { "x".toInt() }
        .onSuccess { println("Chenggong: $it") }
        .onFailure { println("Cuowu: ${it.message}") } // Cuowu: For input string: "x"
}

Qing zhuyi yi ge xinli shang de xiaoying:jiushi women jiushi hai mei jueding jiexia lai yao zenme zuo,zhi shao women mei you ba “fa sheng le cuowu” zhe jian shi nong diu — ta chu xian zai yi ge hen mingque de difang.

Zheli ye chu xian le ben jiang de guanjian yuanze:kong de onFailure { } jiben shang zong shi yi ge jingxun. Ruguo ni xie le yige shenme dou bu zuo de error handler,ni jiushi chuangzao le yi ge “heidong”,rang wenti de yuanyin xiaoshi.

5. Zai console app li shiyong runCatching:mingling parsing

Xianzai yao shuo yi ge zhongyao dian:women bu shi yinwei “keyi” jiu yong runCatching. Women shi ba ta dangzuo mou ge layer li de tool,rang code geng jianjie,dan error contract rengran qingchu.

Jiashe women de shijian xiangmu shi yi ge console zhichu tracker:BudgetBuddy. Ta yijing neng chuli zhe yang de mingling:

  • add 120 food
  • list
  • remove 3

(Women bu hui ba mingling lie bian de geng fuzha — zheli zhongdian shi error handling jiqiao,er bu shi app gongneng.)

Liucheng yong shi yi xia da gai shi zheyang:

flowchart TD
    A["readln()"] --> B["parseCommand(line)"]
    B -->|Result.Success| C["executeCommand(cmd)"]
    B -->|Result.Failure| D[da yin cuowu gei yonghu]
    C --> E[da yin jieguo]

Guanjian siwei:mingling parsing shi runCatching de lixia changjing,yinwei na li you henduo qian zai exception(toInt()、require(...)),er jieguo you hen rongyi yong Result fan hui gei shang ceng.

Zuo yi ge hen xiao de “add zhichu” mingling model:

data class AddExpenseCommand(
    val amount: Int,
    val category: String,
)

Ran hou xie yige parser,return Result<AddExpenseCommand>:

fun parseAddCommand(tokens: List<String>): Result<AddExpenseCommand> {
    return runCatching {
        require(tokens.size >= 3) { "Usage: add <amount> <category>" }
        val amount = tokens[1].toInt()
        val category = tokens[2]
        AddExpenseCommand(amount = amount, category = category)
    }
}

Zheli you ge hen zhongyao de “meiyou mofa de mofa”:require(...) shibai shi hui throw exception(tongchang shi IllegalArgumentException),er toInt() keneng throw NumberFormatException. Women bu yong shou dong catch ta men — rang ta men ziran fasheng,runCatching hui ba ta men baozhuang jin Result.failure.

Zai CLI li yong onSuccess/onFailure chuli result

Xianzai kan kan zai console layer zhong zenme xie. Women du yi hang zifuchuan,qie cheng token,ran hou changshi parse.

Zhe duan code zhongyao zai:zhe li zui rongyi chuxian “xiao sheng”(suppression):kaifa zhe kan dao error,lei le,jiu xie le getOrElse { ... },program bu zai crash… dan kaishi yichang xingwei.

Women xie yi ge zhengchang de handler:

fun handleLine(line: String) {
    val tokens = line.trim().split(" ").filter { it.isNotBlank() }
    if (tokens.isEmpty()) return

    when (tokens[0]) {
        "add" -> parseAddCommand(tokens)
            .onSuccess { cmd ->
                println("Jiang yao tianjia zhichu: ${cmd.amount}, leibie=${cmd.category}")
            }
            .onFailure { e ->
                println("add mingling cuowu: ${e.message}")
            }

        else -> println("Weizhi mingling: ${tokens[0]}")
    }
}

Wei shenme zhe yang hao:cuowu bu hui xiaoshi. Women mingque gaosu yonghu daodi na li bu dui. Cong shijian shang shuo,zheli de onFailure jiushi ba error “fan yi” cheng ren ke du de xinxi.

Dangran,zhe bu shi contract de ti dai:ruguo zai zhe yi ceng cuowu hen zhiming,women keneng bu hui print,er shi zhijie jieshu program. Dan dui CLI mingling lai shuo,parsing cuowu often shi yukeqi de(“yonghu shuru cuo le”)— suoyi tishi + jixu yunxing shi heshi de.

6. Cuowu “xiao sheng”:ta kan qilai zenyang,wei shenme hen tong

“Xiao sheng” zhe ge ci ting qilai xiang che chang: “wo gei ni ba cuowu xiao sheng le,Check Engine deng jiu bu fan ren le”. Deng que shi bu liang le… dan engine hai shi.

Zai programming li,“xiao sheng” tongchang you liang zhong xingshi.

Di yi zhong — ni yong le getOrNull(),ran hou bu li null,zhijie yong default ding shang,daozhi yiyi bei gaibian:

fun parseAmountUnsafe(text: String): Int {
    return runCatching { text.toInt() }.getOrNull() ?: 0
}

Ruguo 0 shi hefa de — ye xu mei wenti. Dan ruguo 0 yiwei zhe “mianfei” huo “meiyou zhichu”,na ni jiushi zai bu zhijue zhong gaibian le business logic. Yonghu shuru add abc food,ni que tianjia le 0 food de zhichu. Er qie hai “chenggong” le. Ke pa de chenggong.

Di er zhong — “kong handler”:

fun parseAmountSilently(text: String): Result<Int> {
    return runCatching { text.toInt() }
        .onFailure { /* silence */ }
}

Wai mian kan qilai ni “chuli le error”,dan qi shi mei you — ni zhishi ba ta bian de bu ke jian.

Ruhe fang zhi?Jiben shang liang tiao guize jiuzai:

Guize 1:ruguo ni yao fallback(getOrElse),na ge fallback bixu you yiyi,bing qie zuihao pei he dui yonghu de tishi. Guize 2:ruguo ni zai zhe li hai bu xiang jueding,na jiu bu yao jueding — ba Result wang shang fan hui,huozhe ba exception rethrow.

“You yiyi de fallback + shuo ming” example:

fun parseAmountWithMessage(text: String): Int {
    return runCatching { text.toInt() }
        .getOrElse { e ->
            println("Jine bu zhengque '$text': ${e.message}")
            0
        }
}

Shi de,zhe rengran shi fallback. Dan xianzai 至 shao zhi dao ta wei shenme fasheng.

7. Shenme shihou runCatching bu shi zui hao xuanze:zhe shi hou zhengchang de try/catch geng hao

Hen rongyi chongdong de ba runCatching yong lai ba “suoyou dongxi” dou bao qilai. Dan zhe yang ni hui ba program biancheng yi dui container:error zai li mian chuan lai chuan qu,dan conglai bu chu xian zai biaomian.

Lingwai,runCatching hui catch Throwable(fanwei keneng guo da)。You shihou ni zhi xiang catch mou yi zhong yukeqi de exception bing chuli,dan qita cuowu yinggai rang ta crash(dangzuo accident)。Zai zhe zhong qingkuang,yong zhiding type de try/catch geng hao du,yiyi shang ye geng ke kao. Er Kotlin ye hen mingque de zhan shi try/catch de jichu xingshi,bing tixing ni try/catch ke yi zuowei expression return yi ge value.

Biru,ni xiang ba “bu shi shuzi” dangzuo yukeqi cuowu,dan qita qingkuang dou rang ta crash(dangzuo accident),na zhengchang de try/catch you shihou geng qingchu:

fun parseIntOrZero(text: String): Int {
    return try {
        text.toInt()
    } catch (e: NumberFormatException) {
        0
    }
}

Zhe hen zhiguan: “ruguo bu shi shuzi — return 0”. Dan zai zhe li yong runCatching fan er hui duo yi ceng abstraction,bu yiding you biyao.

8. Shiyong runCatching de changjian cuowu

Cuowu 1:ba tai da yi duan logic dou fang jin runCatching.
Dang runCatching li bao han le “ban ge function”,ni hui shiqu dui “daodi na yi bu hui diao” de zhijue. Ran hou zai onFailure li kan dao exception,dan context bian de mobo:bu zhi dao shi toInt(),shi require,shi list access,hai shi qita. Jiejue fangfa hen simple:zhi bao zhu zui xiao de、zhen de keneng throw de duanluo,tebie shi ni xiang gei ren yige qingchu tishi de shihou.

Cuowu 2:“yi fang wan yi” xie onFailure { }.
Kong de onFailure jiben shang jiushi “wo zhidao keneng cuowu,dan wo bu zai hu”. Zhe yang hui chuxian hen nan reproduce de bug:program you shihou guai guai de,dan mei log、mei message,ye meiren kan guo exception. Ruguo ni yijing xie le onFailure,jiu zhi shao zuo yige zuixiao fan ying:tishi、return Error、zhongduan liucheng — renhe you yiyi de jueding dou bi kong zhe hao.

Cuowu 3:bu fenxi jiu ba renhe cuowu dou biancheng default(daochu dou shi getOrElse { 0 }).
You shihou hui juede default shi haoshi:program “bu hui crash”. Dan ruguo default huai le yiyi,ni zhi shi ba cuowu wang hou tui,zuihou ta hui zai baobiao、zongjie、yonghu shuju li baofa. Zhe jiu shi “mei crash” bi “dangchang crash” geng zao de qingkuang:yinwei ni ba cuowu zhuangtai baoliu le xia lai.

Cuowu 4:ba “gaibian xingshi” dangcheng “yi chuli”.
runCatching zhi shi ba error de xingshi bian le:ba exception biancheng Result.failure. Dan zhe bu shi handling. Handling shi:ni zuo le jueding — jixu / tingzhi、gei yonghu tishi、return Error gei waibu、rethrow exception. Ruguo runCatching zhi hou ni cong lai mei you zai renhe difang zuo jueding ye mei you xianshi cuowu — na ta hen keneng jiushi “xiao sheng” le.

Cuowu 5:meiyou biyao de qingkuang xia hunyong Result<T> he ziji de sealed result.
Zai project li,changchang hui you ziji de convention:Ok/Error(bizhi zai domain layer)。Result ye shi “success/failure”,dan zhexue bu tong. Ruguo ni yi hui er return Result,yi hui er return Ok/Error,you mei you qingchu guize,code hui hen nan du. Yi ban bi jiao hao de zuofa shi:zai layer neibu keyi yong runCatching he Result,dan zai layer bianjie ba ta zhuan cheng ni men wending de contract(Ok/Error),bing pei shang qingchu de message.

Cuowu 6:yiwei runCatching dengyu validation.
runCatching shi catch exception. Dan henduo jiancha geng shihe yong xianxing validation biao da(biru if/when ran hou return Error)。Ruguo ni zong shi yong exception lai kongzhi zhengchang de logic branch,code du qi lai hui geng nan. Exception shihe “zhen de chule shenme da shi”,er bu shi “yonghu duo da le yi ge kongge”.

1
任務
Kotlin SELF, 等級 40, 課堂 4
上鎖
代幣掃描器
代幣掃描器
1
任務
Kotlin SELF, 等級 40, 課堂 4
上鎖
報表中的除法
報表中的除法
1
任務
Kotlin SELF, 等級 40, 課堂 4
上鎖
今日折扣
今日折扣
1
任務
Kotlin SELF, 等級 40, 課堂 4
上鎖
城市導覽
城市導覽
1
問卷/小測驗
例外,等級 40,課堂 4
未開放
例外
深入了解例外
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION