1. Wei shenme「jishu exception」changchang mei yong
Ru guo ni gang kai shi xue, exception jingchang kan qi lai xiang「hongse de zi, rang ren bu hao guo ri zi」。Dan wenti bu zai yu exception fa sheng le, er zai yu exception de xiaoxi jingchang genben mei you shuo dao ni de renwu. Diannao hen lao shi di shuo:「wo mei banfa ba zifuchuan bian cheng shuzi」,er ni zuo zai na li xiang:「hao ba… dan dao di zai na li? wei shenme? yonghu dao di shu ru le shenme?」
Xiangxiang ni you yi ge kongzhi tai yingyong, yonghu hui shu ru mingling, bi ru:
add coffee 120
Ru guo yonghu shu ru:
add coffee twelve
na me dianxing de di ceng bao zha hui shi NumberFormatException。Wenti zai yu, zhe ge「bu shi shuzi」de xinx sui ran zhengque, dan tai guoyu yiban. Zai ni de yingyong li, geng zhongyao de shi:「zhichu jine bi xu shi shuzi」,zui hao hai neng xian shi dao di chuan jin lai de shi shenme zhi.
Ye jiu shi shuo, wo men xi wang cuowu geng xiang lao shi (you shan de) shuo de hua:「Zhichu jine bi xu shi zhengshu, dan ni shu ru le twelve」。Er bu shi xiang bianyi qi (ta ye hen you shan, zhi shi ge xing bijiao ying) shuo de:「NumberFormatException」。
2. cause yu yuanyin lian
Dang ni catch yi ge exception bing jue ding pao chu ling yi ge—geng rongyi dong de—exception shi, ni hen rongyi fan yi ge jingdian cuowu: diu diao genben yuanyin. Er genben yuanyin (zai JVM shang tongchang jiao cause) jiu shi「zui yuan shi de na ci che huo」, yi qie dou shi cong na li kai shi de.
Zai Kotlin/Java li, exception shi yi ge duixiang, ta ke yi bao han dui ling yi ge exception de yinyong:「wo gua le, yinwei na ge gua le」。Kotlin wen dang qiangdiao, ni ke yi zi dingyi xiaoxi, tong shi bao liu yuan shi de cause, rang ta chu xian zai stack trace li.
Cong shi jue shang kan, ta xiang yi tiao lian:
CommandParseException("Amount must be a number, got 'twelve'")
caused by NumberFormatException("For input string: \"twelve\"")
Zhe tiao lian dui debugging lai shuo shi huang jin. Ji shi ni gei yonghu zhi xian shi zui shang ceng («jine bi xu shi shuzi»), dui kaifa zhe (jiu shi wei lai de ni—ban ye liang dian zai xiu bug de ni) lai shuo, zhi dao jingque de genben yuanyin fei chang you jiazhi.
Yi ge xiao de liucheng tu (shi de, jiu shi na ge「liucheng tu zhen de you yong」de shun jian):
flowchart TD
A["Di ceng dai ma: toInt()"] -->|pao chu| B["NumberFormatException"]
B --> C["catch(e)"]
C --> D["throw CommandParseException(..., cause=e)"]
D --> E["shang ceng catch CommandParseException"]
E --> F["yonghu kan dao qingchu de xinx"]
E --> G["kaifa zhe xu yao shi ke yi kan dao cause lian"]
3. Ru he shengming zi ji de exception
Dang wo men shuo「zi ji de exception」, bing bu shi shuo「gan kuai jian yi ge you 48 ge class de jicheng shu」。Tongchang mei ge yingyong ceng ji zhi xu yao 1–2 ge class jiu gou le.
Zai Kotlin li, zi dingyi exception jiu shi yi ge pu tong class, jicheng Exception (huo qi ta exception)。Kotlin wen dang jiu shi zhe yang miao shu custom exceptions de.
Dui wo men de mu biao zui shi yong de mu ban shi—jie shou message he ke xuan de cause:
class CommandParseException(
message: String,
cause: Throwable? = null
) : Exception(message, cause)
Qing zhu yi liang ge dian.
Di yi: wo men yong Throwable?, er bu shi Exception?。Zhe zai JVM shijie li geng chang jian: cause ke yi shi renhe「ke bei pao chu」de duixiang.
Di er: mo ren null rang ni ke yi zai mei you genben yuanyin de qingkuang xia ye pao chu exception—bi ru zhe ge cuowu shi ni cong ling ziji zhuang chu lai de.
Wei shenme bu yao zuo object MyException : Exception(...)
You shi hou xin shou kan dao Kotlin you object, jiu xiang:「O! Wo zuo yi ge quan ju tong yong de exception, jiu bu yong yi zhi new duixiang le」。Zhe shi ge huai xiangfa. Exception shi「zhuangtai + stack trace」, Kotlin wen dang ye zhi jie jianyi bu yao yong object lai chuangjian exception, er shi mei ci dou chuangjian xin shili, rang zhuangtai fan ying zhen shi de shangxiawen.
4. Wrapping: zhua zhu, tian jia shangxiawen, zai wang shang pao
Lai ba ben ji de he xin jiqiao lian shu: wo men catch di ceng cuowu, ran hou pao chu xin de exception, dan shi yong「yingyong de yu yan」lai biao da. Tong shi yi ding yao chuan ru cause。
Li zi: parsing zhichu jine bing tian jia yiyi
fun parseAmount(text: String): Int {
val prepared = text.trim()
try {
return prepared.toInt()
} catch (e: NumberFormatException) {
throw CommandParseException("Amount must be an integer, got '$text'", e)
}
}
Zhe li zui zhongyao de shi: wo men mei you yin cang genben yuanyin. Wo men tian le qingchu de xinx, dan ye ba e bao liu zai cause li.
Li zi:「mei you yuanyin de bao zhuang」—ru he ba xiansuo diu diao
You shi hou hui xie cheng zhe yang:
fun parseAmountBad(text: String): Int {
return try {
text.trim().toInt()
} catch (e: NumberFormatException) {
throw CommandParseException("Bad amount") // cause yi shi
}
}
Zhe ge ban ben de wen ti shi: ru guo shang ceng na li ni xiang zhi dao dao di chuan jin lai le shenme, wei shenme toInt() gua le, ni yi jing mei you yuan shi exception he ta de xiangxi xinxi le.
Li zi: dang shangxiawen bi exception「lei xing」geng zhongyao
Cong jishu shang shuo, NumberFormatException yi jing shi「guan yu shuzi」de exception le. Dan zai ni de yingyong li ke neng you hen duo ge shuzi: jine, xian e, shuliang, yuefen bianhao, yonghu ID. Na me zhi shuo「bu shi shuzi」jiu mei shenme yong. Suo yi wo men cai yong CommandParseException lai fen li yiyi:「mingling parsing cuowu」。
5. Mini yingyong: zhichu jilu qi yu qingchu de cuowu
Xian zai wo men lai zuo yi ge xiao er wan zheng de xunlian pian duan. Wo men zuo yi ge zui jian dan de zhichu jilu qi: ba zhichu lie biao cun zai neicun, bing zhi chi mingling:
add <title> <amount>
list
exit
Wo men bu hui ba jia gou gao de hen fu za—jin tian mu biao bu shi「wan mei xi tong」, er shi lianxi: zai na li wrapping cuowu, yi ji ru he bu diu cause。
Shuju mo xing yu neicun cun chu
Zai qian ji tian, wo men yi jing yong guo class he duixiang jihe, suo yi zhe li zuo yi ge jian dan mo xing:
data class Expense(
val title: String,
val amount: Int
)
Ran hou yong yi ge list dang zuo cun chu:
val expenses = mutableListOf<Expense>()
Yingyong ceng de zi dingyi exception
Wo men hui ding yi liang zhong exception: yi ge gei mingling shu ru cuowu, ling yi ge gei luoji shang bu ke neng de zhuangtai (jin tian ji hu bu tai hui yong dao di er ge, dan kan dao chabie hen you bangzhu)。
class CommandParseException(message: String, cause: Throwable? = null) : Exception(message, cause)
class AppStateException(message: String, cause: Throwable? = null) : Exception(message, cause)
Mingling parser: fan hui jiegou huo pao chu exception
Wei le rang dai ma hao du, ba parsing hou de mingling biao shi cheng yi ge type hui hen fangbian. Wo men yi jing xue guo sealed class, suo yi zhe yang xie:
sealed class Command {
data class Add(val title: String, val amount: Int) : Command()
data object ListAll : Command()
data object Exit : Command()
}
Xian zai shi parsing function:
fun parseCommand(line: String): Command {
val parts = line.trim().split(" ").filter { it.isNotBlank() }
if (parts.isEmpty()) throw CommandParseException("Empty command")
return when (parts[0].lowercase()) {
"add" -> parseAdd(parts)
"list" -> Command.ListAll
"exit" -> Command.Exit
else -> throw CommandParseException("Unknown command: '${parts[0]}'")
}
}
Zhe li, dui yu mei you di ceng genben yuanyin de qingkuang (yinwei shi wo men ziji jian ce chu lai de wenti), wo men jiu「zhi jie」pao chu CommandParseException。
Jie xia lai zui jingcai de shi—parseAdd。
parseAdd: ba NumberFormatException bao zhuang cheng hao li jie de cuowu
fun parseAdd(parts: List<String>): Command.Add {
if (parts.size < 3) {
throw CommandParseException("Usage: add <title> <amount>")
}
val title = parts[1]
val amountText = parts[2]
val amount = try {
amountText.toInt()
} catch (e: NumberFormatException) {
throw CommandParseException("Amount must be a number, got '$amountText'", e)
}
return Command.Add(title = title, amount = amount)
}
Qing zhu yi: wo men ben lai ke yi jiao yong wo men de parseAmount(...), dan xian zai ke yi te yi zai shi yong dian zhi jie xian shi jiqiao, rang ni kan qingchu「zhua zhu → dai zhe cause zai pao chu」。
Zhu xun huan: zhi catch yu qi zhong de cuowu
Xian zai shi main。An zhao wo men zhi qian tao lun guo de fengge, wo men bu xiang catch「suo you dongxi」。Wo men zhi catch yu qi de parsing cuowu.
fun main() {
val expenses = mutableListOf<Expense>()
while (true) {
print("> ")
val line = readln()
try {
when (val cmd = parseCommand(line)) {
is Command.Add -> {
expenses.add(Expense(cmd.title, cmd.amount))
println("Added: ${cmd.title} (${cmd.amount})") // Added: coffee (120)
}
Command.ListAll -> {
printExpenses(expenses)
}
Command.Exit -> return
}
} catch (e: CommandParseException) {
println("Input error: ${e.message}") // li ru: Input error: Amount must be a number, got 'twelve'
// Wei le xuexi, ke yi lin shi da yin genben yuanyin:
// println("Cause: ${e.cause?.javaClass?.simpleName}") // Cause: NumberFormatException
}
}
}
printExpenses wo men xie de duan yi dian, bing qie an quan:
fun printExpenses(expenses: List<Expense>) {
if (expenses.isEmpty()) {
println("(empty)") // (empty)
return
}
for (e in expenses) {
println("- ${e.title}: ${e.amount}") // - coffee: 120
}
}
6. require/check vs zi dingyi exception
Dao mou ge shike, ni ke neng hui xiang:「Na wo wei shenme hai yao zi dingyi exception? bu shi yi jing you require() ma?」。Zhe ge wenti hen hao, yinwei zhe li gang hao chu xian le「yanzheng」he「shangxiawen」zhi jian de cheng shu fen jie xian.
require(...) he check(...) shi predicte, ta men hui pao chu biao zhun exception: IllegalArgumentException he IllegalStateException。Kotlin wen dang dui ta men de yongtu he hui pao chu shenme exception miao shu de hen qingchu.
Yong ren hua shuo, require shi「ni gei le wo huai de input, wo bu xu yao gongzuo」; check shi「wo nei bu zhuangtai bu dui, zhe shi dai ma luoji cuowu」。
Er zi dingyi exception tongchang yong zai ling yi ge wei zhi: dang ni xiang ba ni de yewu lingyu cuowu biao da de geng you yiyi. Bi ru「mingling bu ren shi」,「bu neng tian jia fu shu jine de zhichu」,「leibie bu cun zai」。Zai zhe xie qingkuang, zi dingyi exception type hui you bangzhu:
- di yi, ke yi dan du catch (bu hui he qi ta cuowu hun zai yi qi),
- di er, ke yi tong yi xinx fengge,
- di san, ru guo cuowu shi cong「di ceng」lai de, ke yi bao liu cause。
Bi ru, ru guo ni xiang jin zhi fu shu jine, ke yi zhe yang xie:
fun validateAmount(amount: Int): Int {
require(amount > 0) { "Amount must be > 0, got $amount" }
return amount
}
Zhe ge zuo fa hen bang, yinwei fu shu jine shi yi ge precondition wei fan.
Dan ru guo ni zai parsing mingling, bing xiang ba「parsing cuowu」he qi ta wen ti qu fen kai lai, CommandParseException du qi lai hui geng zi ran.
Mini zhenduan: ru he kan dao yuanyin lian
You shi hou ni xiang gei yonghu xian shi jian duan xinx, dan gei zi ji (huo zhe zai xuexi/lin shi zhenduan mo shi) da yin cause yuanyin lian. Zai Kotlin li, mei ge Throwable dou you cause: Throwable?。
Xie yi ge xiao function, da yin「yuanyin ti jie」。Bu yao guo du, 7–8 hang jiu hao:
fun printCauseChain(e: Throwable) {
var current: Throwable? = e
while (current != null) {
println("${current::class.simpleName}: ${current.message}")
current = current.cause
}
}
Ru guo zhe yang jiao yong:
try {
parseCommand("add coffee twelve")
} catch (e: CommandParseException) {
printCauseChain(e)
}
ni hui kan dao lei si zhe yang de output:
CommandParseException: Amount must be a number, got 'twelve'
NumberFormatException: For input string: "twelve"
Zhe shi yi ge hen hao de zhe zhong: bu ba ke pa de xiangxi diu gei yonghu, dan zai kaifa mo shi xia you neng hen kuai ding wei wenti.
7. Chang jian cuowu
Cuowu №1: bao zhuang exception dan diu diao cause。
Dang ni catch NumberFormatException ran hou pao chu zi ji de exception que bu chuan ru cause, ni de que de dao le hao kan de xinx, dan shi shi qu le diao cha nengli. Guo ji zhou ni kan dao CommandParseException("Bad amount") shi, hui jue de zhe ge cuowu xiang zai shuo:「wo bu zhi dao fa sheng le shenme, dan que shi fa sheng le」。Qing ba genben yuanyin zuo wei di er ge can shu chuan jin qu (Exception(message, cause))—Kotlin he JVM dou neng bao liu zhe zhong guan xi.
Cuowu №2: yong yi zhong exception ying fu suo you qingkuang。
You shi hou hui you you huo:「Wo zuo yi ge AppException, ran hou shenme dou pao ta」。Jie guo shi exception de lei xing zai ye bu biao da yi yi, ni you hui bei po yong xinx wen ben lai qu fen. Zui hao zhi shao you yi ge dui ying ni zhe yi ceng de you yi yi type, bi ru yong CommandParseException zhuan men chu li shu ru yu parsing cuowu, bing qie yi zhi shi yong ta.
Cuowu №3: wei le「bu fen pei」er yong object chuangjian exception。
Exception bao han stack trace he chuangjian shi de shangxiawen. Ru guo ni yong singleton exception, ta hui bao chi yi ge bu fu he dang qian qingkuang de shangxiawen, rang zhenduan bian de qi guai. Kotlin wen dang ye zhi jie jinggao: exception shi you zhuangtai de duixiang, ying gai mei ci chuangjian xin shili.
Cuowu №4: catch tai guang de lei xing, ran hou「shenme dou xiu」。
Zai main de ban ge function wai wei xie yi ge catch (e: Exception) kan qi lai xiang「bao hu zhao」, dan shi shi ji shang hui bian cheng「cuowu xi chen qi」: ni ke neng wu yi zhong tun diao ben gai bao zha bing bei xiu fu de bug. Jin tian de jiqiao zheng shi wei le zhe ge: yong cause zuo dui, zhi catch ni yu qi de (bi ru CommandParseException), qi ta de jiu rang ta diao—zhe shi gei kaifa zhe de xinhao.
Cuowu №5: exception xinx mei you ju ti zhi。
Xiang "Bad amount" zhe zhong xinx ting qi lai jiu shi「huai de mou ge dongxi」。Xiang "Amount must be a number, got 'twelve'" zhe yang de xinx cai xiang yi ge zhi nan: gao su ni gai zen me gai, bing bao han zhenduan suo xu de shuju. Jin liang an zhe ge gongshi xie:「qi dai shenme」+「shi ji na dao shenme」。
Cuowu №6: ba precondition he changjing cuowu hun zai yi qi。
Ru guo ni ba require na lai shenme dou yong, hen kuai jiu hui diu diao yiyi: dao di shi yonghu shu ru cuowu, hai shi luoji bug, hai shi changjing bu fu he. Ji zhu: require()/check() shi guan yu input he zhuangtai (bing qie pao chu biao zhun exception)。Er zi dingyi exception zai ni xiang yong「yingyong de yu yan」biao da cuowu, bing zai xu yao shi bao liu genben yuanyin shi hen you yong.
GO TO FULL VERSION