1. Jianjie
Dang xiangmu bian da, zui rongyi “nong huai” de bu shi xin daima, er shi “wuyi zhong peng dao jiuyou daima de xin daima”。Zai xiao de xuexi yongyingyong li ye hen kuai chu xian: ni jiale yige xin mingling, ran hou tu ran faxian jiuyou mingling kaishi “yong lingyizhong fangshi” dayin, er cuowu youshi yong yihang zifuchuan, youshi biancheng null, youshi you biancheng println(repo.all()) (dui, zhe jiu shi na zhong “rang Kotlin ziji gen yonghu jieshi fasheng le shenme” de fengge)。
Fix v1 shi yige shike: ni shuo “women you wending de youxi guize”。Bu shi “yiqie dou wanmei”,ye bu shi “NASA ji bie de jiegou”,er shi geng jian dan: mingling fanhui tongyi leixing de jieguo, huida geshi zai yige difang goujian, er main biancheng keyi yuce de zhuangpei yu diaoyong jiaoben. Zhe hui dafu jiangdi hunluan: tianjia mingling geng rongyi, yuedu daima geng rongyi, ni ye geng bu pa qu dong yige wenjian, yinwei ta bu hui yinqi “ban ge xiangmu” de lian dong.
Shuo de geng shijidian: v1 jiu shi ni de xiangmu bu zai xiang “yi he dianxian” de hezi, er shi kaishi xiang “yi he jiekou (connector) de hezi”。Dianxian keyi hen duo, dan tamen zai yange guidings de weizhi shang lianjie.
Wenti: “mingling fanhui shenme dou you”
Zai yinru tongyi heshi zhiqian, kan dao zhenzheng de tongdian hen you bangzhu. Tongchang chuxuezhe (youshi ye shi mang le yitian de laoshou kaifa zhe) hui zheme zuo: yige mingling fanhui zifuchuan, lingyige fanhui Boolean, disange ziji dayin, disige diu yichang, diwuge fanhui null, yinwei “fan zheng mei chenggong ma”。
Jieguo CLI jiu biancheng le yige “jiancha dongwu yuan”: zheli if (result != null), nali try/catch, zheli println zai service li, nali zai repository li (zhe yi jing shi bijiao hanjian de wuzhong, dan que shi jian guo). Zui mafan de shi: ni bu neng yiyan kan chu mingling daodi zuo shenme. Ni bixu ji zhu “zhe ge mingling shi ziji dayin hai shi fanhui yige zifuchuan?”。
Women xuyao yige tongyi de “xin feng” lai chengzai mingling jieguo. Li mian keyi fang chenggong, ye keyi fang cuowu. Zheyang CLI zong shi zuo tong yi jian shi: diaoyong handler, na dao jieguo, dayin jieguo. Chu le routing zhi wai, bu xuyao dui mei ge mingling xie teshu fen zhi.
2. Tongyi de mingling jieguo: sealed interface CommandResult
Ni di yi ci kan dao sealed shi, keneng jue de hen “gaoji”,dan jintian women yong ta feichang shiyong: ba ta dangzuo “jieguo de hefa xuanxiang liebiao”。Sixiang hen jian dan: mingling yao me chenggong (Ok), yao me shibai (Error). Jiu zheyang. Meiyou “chabuduo chenggong”,meiyou “fan hui le 0”,meiyou “kanqilai shi true dan shi...”。
Women chuangjian yi ge jieguo leixing. Ba ta fang zai geng jie jin CLI bianjie de difang shi heli de (yinwei zhe shi mingling chuli de jieguo), biru fang zai package app.cli.contract. Zhongyao: zhe bu shi domain model, er shi “gei jiaohu jiemian yong de mingling jieguo”。
// FILE: app/cli/contract/CommandResult.kt
package app.cli.contract
sealed interface CommandResult {
data class Ok(val message: String) : CommandResult
data class Error(val message: String) : CommandResult
}
Qing zhuyi yi ge xijie: Ok he Error dou you message. Zhe dui v1 shi yige feichang you jiazhi de jilu: mei ge jieguo dou you yige renlei keyi liao jie de shuoming. Houxu banben keyi biangeng fuzahua (biru jia shuju), dan v1 li women yao de shi wending yu jian dan.
3. Jizhonghua geshihua (formatting)
Ruguo ni you guo zai xiangmu li gai guo xiaoxi wenben de jingyan, ni jiu zhidao zhe ge “renwu”: “zhao chu suoyou dayin ERROR de difang”。Tongchang sousuo youyong, dan ranhou ni hui faxian hai you yige difang zai dayin println("Err: ..."). Huan you yige. Huan you yige...
Zai v1, women zheme zuo: jieguo geshihua fang zai yige difang. CLI diaoyong render() ran hou dayin zifuchuan. Geshi keyi jizhong xiugai, suoyou mingling hui zhidong biancheng yizhi de yangzi.
// FILE: app/cli/contract/CommandResultRender.kt
package app.cli.contract
fun CommandResult.render(): String =
when (this) {
is CommandResult.Ok -> "OK: $message"
is CommandResult.Error -> "ERROR: $message"
}
Zheli guanjian zai yu when de wanquan xing. Women bu xie else. Wei shenme? Yinwei sealed interface baozheng: xuanxiang shi you xian ge. Ruguo ni zhihou tianjia xin xuanxiang (biru Help huo Exit), bianyiqi hui shuo: “hey, ni lou le yi ge case”。Zhe shi yige feichang hao de “genggai menwei”: ta bu rang ni zuochu bu wanquan de xiugai.
4. Tongyi de mingling chuli heshi: handle(...) -> CommandResult
Xianzai women xuyao yige duixiang (huo function), jie shou parse hao de mingling bing fanhui CommandResult. Zhe jiu shi CLI dui wai de v1 “gongkai rukou”: ni ba zifuchuan gei parser, parser ba jiegou gei handler, handler fanhui jieguo.
Xian guding “parse hou de mingling” model. Women bu zuo fuzade parser, zhi xuyao mingling mingcheng he yige zifuchuan can shu jiuke.
// FILE: app/cli/parse/ParsedCommand.kt
package app.cli.parse
data class ParsedCommand(
val name: String,
val arg: String?
)
Ranhou shi yi ge jiandan de parsing function. Zheli women bu zhuiqiu “wanmei CLI”,zhi shi jianli yige wending yueding: mingling shi yi ge dan ci, can shu shi shengxia de suoyou neirong.
// FILE: app/cli/parse/CommandLineParser.kt
package app.cli.parse
fun parseCommandLine(line: String): ParsedCommand {
val s = line.trim()
val space = s.indexOf(' ')
return if (space == -1) ParsedCommand(s.lowercase(), null)
else ParsedCommand(s.substring(0, space).lowercase(), s.substring(space + 1).trim().ifEmpty { null })
}
Meicuo, zhe hang you dian chang, dan luoji hen jian dan: guifan hua mingling ming ( lowercase() ), can shu qiege bing ba kong zifuchuan biancheng null. Zhe zai houmian hen fangbian: arg == null jiu shi “meiyou can shu”。
Xianzai — mingling handler. Ta shiyong domain service he exporter (women zai qian jiang yi jing zuo guo), dan dui wai zhi shuchu CommandResult.
// FILE: app/cli/CommandHandler.kt
package app.cli
import app.cli.contract.CommandResult
import app.cli.parse.ParsedCommand
import domain.service.ExpenseService
import domain.service.ReportExporter
class CommandHandler(
private val service: ExpenseService,
private val exporter: ReportExporter
) {
fun handle(cmd: ParsedCommand): CommandResult =
when (cmd.name) {
"list" -> CommandResult.Ok(service.report(exporter))
else -> CommandResult.Error("Unknown command: ${cmd.name}")
}
}
Women zan shi zhi shixian "list", rang li zi bao chi jingjian. Dan zui zhongyao de shi xingzhuang: renhe lujing dou fanhui CommandResult. Jiu suan shi weizhi mingling, ye bu shi yichang, bu shi null, ye bu shi zhijie zai zheli dayin, er shi yige zhengchang de Error(...).
5. Cengci ruhe zuhe: zai main li “zhuangpei” yilaizhi
Zai main li women bu xiang yao yewu luoji. Women xiang yao de shi yige jiaoben: zhuangpei yilaizhi → du mingling → parse → chuli → render → shuchu. Zhe zheng shi “jiandan chengxu” biancheng you xu de biaozhi, er bu shi youzhi.
Women xianshi yi ge zuixiao de main, zhi chuli yi tiao mingling. Zai zhenshi xiangmu li ni keneng yijing zuo le loop, dan xianzai women yao kan dao wan zheng de v1 jiegou.
// FILE: app/cli/Main.kt
package app.cli
import app.cli.contract.render
import app.cli.parse.parseCommandLine
import storage.InMemoryExpenseRepository
import domain.service.ExpenseService
import domain.service.PlainTextExporter
fun main() {
val handler = CommandHandler(ExpenseService(InMemoryExpenseRepository()), PlainTextExporter())
val result = handler.handle(parseCommandLine(readln()))
println(result.render()) // OK: ... 或 ERROR: ...
}
Meicuo, zhuangpei handler de na hang kan qilai hen “ji mi”。Zhe dui v1 hen zhengchang. Women ke yi teshu bu yinru dependency injection container he “moshu shi zhuangpei”。Geng zhongyao de shi: main bu zhidao guanyu zhichu guize he baogao geshi de renhe dongxi; ta zhi shi xiang LEGO yiyang ba lingjian lian qilai (youshi huan hui hen tong de cai dao kuai).
Ruguo ni xiang jia loop, ta ye hui baochi “bo”:
// FILE: app/cli/MainLoop.kt
package app.cli
import app.cli.contract.render
import app.cli.parse.parseCommandLine
fun runLoop(handler: CommandHandler) {
while (true) {
val result = handler.handle(parseCommandLine(readln()))
println(result.render()) // 统一的回答格式
}
}
Zheli hai meiyou "exit" mingling — mei wenti. Women guding de shi jieguo heshi, bu shi dazao wanmei zhongduan.
6. Wei shenme Ok/Error shi wending API
Zhe ge shike zuo yi ge xiao xiao de “jiegou zan ting” hen you bangzhu. Kan qilai women zhi xie le liang ge xiao xiao de data class he yi ge extension function. Dan xiaoguo shang, zhe jiu xiang ni zhongyu ba jia li dian xiang de duanlu qi biaoji qingchu: yiqian dian ye tong, dan xianzai ni bu hui zai xiang guan zoulang de deng shi, shouhua ba bingxiang ge guan le.
Zhe jiu shi Ok/Error neng wending de yuanyin:
Cong diaoyong fang (CLI) de shijiao, jieguo bu zai duo yang. Bu xuyao ji “mingling fanhui le shenme”。Ni yongyuan na dao yige leixing, yongyuan yong yi zhong fangshi render.
Cong xiangmu kuozhan de shijiao, xin mingling de tianjia bian de keyi yuce. Ni bu hui ba xiaoxi sa zai main li, ye bu hui zai qiguai de difang zengjia println. Ruguo ni jia yige "add", ta ye hui fanhui Ok/Error.
Cong bianyiqi de shijiao, ni de xi tong you le “wanquan xing baoxian”. sealed + when meiyou else — zhe shi mianfei de jing tai shenji: bianyiqi hui bi ni ba suoyou xuanxiang dou chuli hao.
Wei le jia shen zhe ge guannian, kan yi yan zhe zhang pipeline tu hen fangbian:
flowchart LR
A[readln] --> B[parseCommandLine]
B --> C[CommandHandler.handle]
C --> D[CommandResult]
D --> E[render]
E --> F[println]
Zhe shi “v1 zuo hao le” de yi ge hao zhengzhao: meiyi bu dou qingchu, qie meiyi bu dou zhi fuze ziji.
Xianzai you ge feichang zhongyao de dian: v1 de “zhiliang biaozhun” bu shi wei le xie list, er shi rang ni zai lei le, xiang “sui bian kuai kuai xie wan yige feature” de shihou, neng kuai su jiancha jiegou hai mei you zou yang. Ruguo domain ceng bu shiyong readln() he println(), storage cang zai interface hou mian, exporter fanhui zifuchuan, er main kan qilai xiang yige jiaoben, na ni jiushi zhenzheng guding le bianjie, er bu shi zhishi ba wenjian fen lei dao butong folder.
7. Yi ge xiao de shiyong xijie
Youshi ni hui xiang zuo de “geng congming”: "list" fanhui baogao zifuchuan, "add" fanhui Boolean, "help" fanhui zifuchuan liebiao... dengdeng. Kan qilai zhe yang “geng type-safe” (mei ge mingling dou “dute”). Dan zai CLI ceng, zhe hui biancheng you bi xu zai fenbian yi ci: “ruguo shi list jiu zheyang dayin, ruguo shi add jiu lingwai yi tao”。
Tongyi jieguo shi wei le wending er zuo de zhonghe. Women shuo: zai CLI ceng, women zhi zaihu yi jian shi — chenggong hai shi shibai, yi ji yao gei yonghu xianshi shenme xiaoxi. Zai domain nei bu ni keyi fanhui renhe jiegou, dan zai mingling bianjie, women ba yiqie gui yi dao tongyi xingshi.
Zai v1 li zhe tebie you yong, yinwei ni hai mei you dazao fuzade jiaohu jiemian. Ni you de shi kongzhi tai, er kongzhi tai xihuan jian dan guize: yi ge mingling — yi hang huida, zui hao bu yao you jingxi.
Wei le shijue shang de duibi, ni keyi ji zhu zhe yang yi zhang biao:
| Fangshi | Mingling fanhui shenme | CLI li fasheng shenme |
|---|---|---|
| “mei ge mingling ziji zuo zhu” | String, Boolean, null, nei bu dayin | hen duo teshu qingkuang |
| Tongyi heshi v1 | CommandResult | yi ge tongyi de chuli jiaoben |
Hai you, ruguo ni jue de zhe “tai jian dan” — na gongxi ni: ni kaishi ba “jiandan” dangzuo gongcheng gongju le. Zhe shi yi tiao weixian de lu — jie xia lai ni hui kaishi ba bianliang ming qu de geng zhengchang, bing qie bu zai xie x1, x2, x3. Jiben mei you huitou lu.
8. Fix v1 yu shiyong Ok/Error de changjian cuowu
Cuowu 1: mingling rengran zai nei bu dayin, CommandResult zhishi “zhuang yangzi”.
Zhe hen changjian: ni tianjia le CommandResult, dan ExpenseService li hai you println("Added!"). Jieguo jiu hui chuxian xiaoxi dayin liang bian, huo zhe zai qiguai de difang dayin, huo zhe “OK/ERROR” geshi bu bei zunshou. Jiejue fangfa hen jian dan ye you dian tong: ba domain he storage li de println shanchu, qiangpo ziji ba shuju/jieguo fanhui chuqu. CLI dayin, qita ceng bu dayin.
Cuowu 2: dui sealed de when xie le else, “wei le rang ta yongyuan neng bianyi”.
else kan qilai xiang anquan dian, dan shiji shang shi ba jingbao qi guan le. Dang yiqie zhengchang shi ni bu hui zhuyi. Dan dang ni tianjia xin jieguo leixing shi, bianyiqi jiu bu hui bang ni zhao dao naxie lou chu li de difang. Zai v1 li geng hao de xiguan shi: ruguo sealed, na jiu xianshi chuli mei ge xuanxiang, bu yao else.
Cuowu 3: ba CommandResult dangzuo “shenme dou wang li mian zhuang de dai zi”, ranhou ban ge domain model dou jinqu le.
Youshi ni hui xiang zai Ok li fang de bu shi zifuchuan, er shi zhichu liebiao, zonghe, tongji... ran hou CommandResult jiu biancheng le xin de domain model ceng, zhi shi mingzi bu yiyang. Zai v1 li, ba heshi bao chi “zhai”: message: String. Ruguo zhen de xiang yao shuju — geng hao de fangshi shi domain fanhui shuju, exporter zuo zifuchuan, ran hou mingling zai Ok li fanhui zifuchuan.
Cuowu 4: handler kaishi zhijie qu repository, huo zhe ba ying gai zai domain li de zhuangtai fang zai ziji shen shang.
Ruguo CommandHandler tu ran kaishi zuo repo.items.add(...) huo zhe ziji validate jine, na jiu shuo ming bianjie kai shi mohu: CLI mingling biancheng le “ban domain”。Zai v1 li zui hao ren zhen ba chi fen gong: handler routing bing diaoyong service, service yingyong guize, repository cun chu, exporter geshihua.
Cuowu 5: bu tong mingling yong bu tong de xiaoxi fengge, yinwei zi fu chuan zai “lu jing shang suibian yige difang” bei geshihua le.
Jintian ni zai yige difang xie le "OK: ...", mingtian you zai lingwai yige difang xie "Success: ...". Yonghu kan dao de shi bu yizhi, er ni hua shijian zai mei guanxi de meiguan er bu shi luoji. Zai v1 li, yong jizhonghua de render() he yige xiguan jiejue: fanhui gei yonghu kan de dongxi dou yao jingguo tong yi ge geshihua rukou.
Cuowu 6: main bu zai shi jiaoben, you kaishi chang cheng luoji — zhi bu guo zhe ci shi “fang zai piaoliang de package li”.
Zhe shi yi zhong yinbi de regress: wenjian fen hao le, interface you le, ranhou main li chu xian le 60 hang if/when. Yige jiankang de v1 de tezheng: main keyi cong shang dao xia xiang “caipu” yiyang du. Ruguo caipu biancheng le xiaoshuo — na jiu gai ba zeren fang hui handler/service/exporter.
GO TO FULL VERSION