CodeGym /課程 /Kotlin SELF /Ze ren fen li

Ze ren fen li

Kotlin SELF
等級 39, 課堂 0
開放

1. Jian jie

Ji hu suoyou ren dou shi cong tong yi yang de fang shi kai shi: na main, zai li mian xie readln(), ji ge if, yi ge zhi chu qing dan, liang san ge ming ling(add, list, remove)—ran hou jiu kai xin le. Zhe shi hen zheng chang de jie duan: ni zai xue xi, ni xiang kuai su kan dao jie guo, er println() hui dai lai yu yue de duo ba an. Dan jie xia lai jiu shi dian xing ju qing: ming ling bian duo, jian cha bian duo, shu chu ge shi「zai shao shao diao zheng」—ran hou main jiu bian cheng「tai kong chuan de zhi hui zhong xin」,li mian tong shi you cao kong、yin qing、chu fang, hai you yi zhi mao.

Wo men hua yi xia dian xing de「quan bu xie zai yi ge di fang」zuo fa(zhe bu shi「huai ren xie de」,er shi「wo men jiu shi zhe yang cheng zhang」):

fun main() {
    val expenses = mutableListOf<String>()

    while (true) {
        print("> ")
        val line = readln().trim()
        if (line == "exit") break

        if (line.startsWith("add ")) {
            val title = line.removePrefix("add ").trim()
            expenses.add(title)
            println("Added: $title") // Added: Coffee
        } else if (line == "list") {
            println(expenses.joinToString())
        } else {
            println("Unknown command")
        }
    }
}

Yi kai shi ni hui jue de:「en, hai suan hao du」。Dan ran hou ni hui xiang, bi ru: mei bi zhi chu yao you jin e, jin e yao shi zheng shu, ming cheng li de kong bai yao yi zhi di chu li, shu chu yao geng hao kan, hai yao neng suan zong ji. Ran hou ni hui tu ran fa xian, wo men de dai ma li:

  • shu ru he gui ze(yan zheng/zheng li)hun zai yi qi,
  • gui ze he cun chu hun zai yi qi(wo men zhi jie thao zuo MutableList),
  • shu chu ye he qi ta yi qie hun zai yi qi,
  • bing qie ren he xiao gai dong dou rang ren hai pa: wan yi ba add nong huai le, list ye gen zhe gua diao—yin wei wo men zai na li「shao shao fu yong le yi ge bian liang」。

He xin guan nian: dang yi qie dou zai main li, mei tian jia yi ge xin gong neng, hun luan bu shi xian xing zeng chang, er shi xue beng shi bao zhang。

2. San zhong jiao se: CLI, domain, storage

Xian zai wo men yin ru san ge gai nian. Ting qi lai hen「zhuan ye」,dan qi shi hen jian dan: shei fu ze shen me。xiang xiang yi jia mi ni ka fei dian:

  • yi ge ren fu ze xiang gu ke jie dan,
  • yi ge ren fu ze zuo can,
  • di san ge ren fu ze ku cun/zhang wu(yuan liao guan li)。

Ru guo yi ge ren yao zuo quan bu, ta bu shi ying xiong, jiu shi shen ti hen kuai jiu bu hang le(geng ke neng shi hou zhe)。Zai cheng xu li ye cha bu duo: wo men xu yao「fen gong he zuo」。

Wo men zhe ge kong zhi tai xiang mu li de jiao se shi:

Jiao se Zuo shen me Bu ying gai zuo shen me
CLI (Command Line Interface) du qu zi fu chuan, li jie ming ling, da yin hui fu bu cun fang ye wu gui ze, bu zai ben zhi shang pan duan「zheng que/ cuo wu」
Domain (ye wu/ling yu luo ji) zhi dao gui ze: shen me shi zhi chu, xu yao na xie jian cha, ru he ji suan zong ji bu diao yong readln(), ye bu zuo println()
Storage (cun chu) bao cun bing fan hui shu ju(v1 xian zhi cun zai ji yi ti) bu jie xi ming ling, ye bu jue ding ye wu gui ze

Ke yi yong yi ge jian dan de shu ju liu tu lai ji:

flowchart LR
    U[User] --> CLI[CLI: read/parse]
    CLI --> D[Domain: apply rules]
    D --> S[Storage: save/return data]
    D --> CLI
    CLI --> U

Jin tian de guan jian gui ze: domain dai ma ying gai ke yi zai mei you kong zhi tai de qing kuang xia bei diao yong。ye jiu shi shuo, li lun shang wo men ming tian ke yi ba kong zhi tai huan cheng, bi ru, GUI—domain ji hu bu xu yao gai.(wo men bu hui zuo GUI, dan zhe ge guan nian hen you yong。)

3. Shi zuo li zi: zhi chu ji zhang

Domain mo xing:「chun shu ju」

Zai fen ceng zhi qian, wo men yao xian yue ding: dao di yao cun shen me. Yi qian wo men ke neng ba zhi chu cun cheng yi ge zi fu chuan, huo zhe Pair<String, Int>, huo zhe「en... zai zi fu chuan li yong ; ge kai」。Jin tian wo men xiang geng zheng chang de mo xing qian jin yi bu: zhi chu shi yi ge you qing xi zi duan de dui xiang.

Chong dian: domain mo xing bu shi「luo ji」,er shi「ling yu shu ju」。ta ying gai jin liang jian dan、gan jing: bu du qu shu ru, bu da yin, bu zuo ge shi hua.

data class Expense(
    val title: String,
    val amount: Int
)

Zhe li you ge xiao dan hen guan jian de yi yi: dang ni kan dao Expense(title, amount), ni jiu bu xu yao zai hui yi「.first shi shen me, .second shi shen me」。Ni zai yong「ren lei de fang shi」yue du.

Ru guo ni xiang jia category, createdAt zhi lei de—xian ren zhu. Jin tian wo men lian xi de shi ze ren fen li, bu shi zuo「wan mei de ji zhang xi tong」。

Storage: ji yi ti cang ku

Hen duo ren yi ting dao「cang ku/storage」,jiu hui xiang dao shu ju ku, migration, transaction, ran hou kai shi you dian jin zhang. Jin tian hen jian dan: v1 de storage ceng jiu shi yi ge ba list cang zai nei bu de lei, bing ti gong「tian jia」he「qu de quan bu」de fang fa.

Wei shen me bu zhi jie zai main li fang yi ge mutableListOf() jiu hao? Yin wei wo men xiang ba「ju ti ru he cun」zuo cheng yi ge du li de xi jie, er bu shi san luo zai zheng ge cheng xu li.

Qing zhu yi yi ge hen zhong yao de dian: dui wai wo men fan hui List<Expense>, er bu shi MutableList<Expense>。Zhe ge xi guan hen jiu ming: na dao List de ren, jiu bu neng「qiao qiao」shan chu yi ge yuan su, ran hou gei ni liu xia yi ge shen mi bug. Zai Kotlin li, zhe zhi jie dui ying dao collection de read-only interface guan nian.

class ExpenseStorage {
    private val items = mutableListOf<Expense>()

    fun add(expense: Expense) {
        items.add(expense)
    }

    fun all(): List<Expense> = items
}

Zhu yi: zhe li mei you readln(), ye mei you println()。Cang ku ying gai xiang yi tai hao bing xiang: an jing, bu ping lun ni de jue ding.

Domain: you gui ze de service, dan bu fu ze da yin

Domain ceng shi「you xi gui ze」suo zai de di fang. Ru guo shuo CLI shi「ru he gen yong hu dui hua」,na domain jiu shi「shen me cai suan shi he fa de zhi chu」。Zhe li cai shi require、jian cha, yi ji zi fu chuan zheng li(normalization)de he shi wei zhi.

Xian zai wo men xie yi ge ExpenseService。Ta jie shou yi jing zhun bei hao de zhi(title, amount), ba ta men zheng li cheng zheng chang ge shi, ran hou tong guo storage bao cun.

class ExpenseService(
    private val storage: ExpenseStorage
) {
    fun addExpense(title: String, amount: Int) {
        val normalizedTitle = title.trim()
        require(normalizedTitle.isNotEmpty()) { "Title must not be empty" }
        require(amount > 0) { "Amount must be > 0" }

        storage.add(Expense(normalizedTitle, amount))
    }

    fun listExpenses(): List<Expense> = storage.all()
}

Zhe li you liang ge zhong yao guan nian.

Di yi: domain jie shou de shi yi jing zhun bei hao de can shu, er bu shi「yuan shi de ming ling zi fu chuan」。ye jiu shi shuo, ExpenseService bu ying gai qu jie xi "add coffee 200"。Zhe shi CLI de gong zuo.

Di er: domain bu da yin「Added!」,ye bu wen yong hu「qing shu ru jin e」。Ta yao me cheng gong wan cheng cao zuo, yao me tong guo exception tong zhi cuo wu(jin tian zhe yang zuo; zhi hou wo men hui zuo geng「ke kong」de fan hui jie guo, dan na shi jie xia lai de nei rong)。

CLI: du qu zi fu chuan, jie xi ming ling, diao yong domain

CLI ceng shi ren yu cheng xu zhi jian de「fan yi qi」。Ren shu ru zi fu chuan, domain xu yao zheng chang de can shu. Suo yi CLI yao zuo san bu: du qu → jie xi → diao yong.

readln() he println() jiu ying gai zai zhe li—zhe shi zheng chang qie yu qi zhong de.

Xie yi ge xiao xiao de ming ling mo xing he zui jian dan de parser. Zhu yi: dai ma hen duan, ye hen「zhi jie」,mei you shen me mo fa—wo men yao de shi ke du xing.

data class ParsedCommand(
    val name: String,
    val args: String
)

fun parseCommand(line: String): ParsedCommand {
    val trimmed = line.trim()
    val space = trimmed.indexOf(' ')
    return if (space == -1) {
        ParsedCommand(name = trimmed.lowercase(), args = "")
    } else {
        val name = trimmed.substring(0, space).lowercase()
        val args = trimmed.substring(space + 1).trim()
        ParsedCommand(name = name, args = args)
    }
}

Jie xia lai shi CLI de zhu luo ji: wo men du qu yi hang, jie xi, dui ming ling ming cheng zuo when, ran hou diao yong service.

Xian zuo liang ge ming ling:

  • add <title>;<amount>
  • list
  • exit

Wei shen me yong ;? Yin wei title li ke neng you kong ge, er wo men zhi xu yao jian dan di ba jin e ge kai. Zhe bu shi「zui wan mei de ge shi」,zhi shi「shi he jiao xue li zi de fang bian ge shi」。

fun main() {
    val storage = ExpenseStorage()
    val service = ExpenseService(storage)

    while (true) {
        print("> ")
        val cmd = parseCommand(readln())

        if (cmd.name == "exit") break

        when (cmd.name) {
            "add" -> handleAdd(cmd.args, service)
            "list" -> handleList(service)
            else -> println("Unknown command: ${cmd.name}")
        }
    }
}

Zhe shi hou main yi jing hen xiang yi ge「jiao ben」:「du qu → jie xi → jiao gei hou mian」。Zhe shi fei chang hao de xin hao.

Hai sheng xia handleAdd he handleList。Zhu yi: zhe li reng ran shi CLI ceng, suo yi zai zhe li da yin shi OK de.

fun handleAdd(args: String, service: ExpenseService) {
    val parts = args.split(';', limit = 2)
    val title = parts.getOrNull(0)?.trim().orEmpty()
    val amount = parts.getOrNull(1)?.trim()?.toIntOrNull() ?: 0

    try {
        service.addExpense(title, amount)
        println("OK: added") // OK: added
    } catch (e: IllegalArgumentException) {
        println("ERROR: ${e.message}") // ERROR: Amount must be > 0
    }
}

Wo men te yi zhua IllegalArgumentException, yin wei require(...) zheng hao hui diu chu zhe ge. Zhe shi yi zhong「wen he」de chu li: cheng xu bu hui zhi jie gua diao, er shi gen yong hu jie shi na li bu dui.

handleList:

fun handleList(service: ExpenseService) {
    val items = service.listExpenses()
    if (items.isEmpty()) {
        println("(empty)") // (empty)
        return
    }

    for ((index, e) in items.withIndex()) {
        println("${index + 1}. ${e.title} — ${e.amount}")
    }
}

Qing dan de ge shi hua shi CLI de ren wu. Domain ying gai fan hui shu ju, ran hou CLI jue ding yao zen me piao liang di zhan shi.

Ge ceng zhi jian de bian jie zai na li

Dang ni kai shi fen ceng, jiu hui chu xian yi ge wei miao de wen ti:「wo ke bu ke yi shao shao fan gui, fan zheng zhi shi yi ge println()? 」Ke yi. Zhi dao ni you le shi ge「zhi shi yi ge println」de na yi tian.

Wei le rang bian jie bu yao「shan kai」,ke yi ji zhu ji ge「fan mian xin hao」。

  • Ru guo ni zai service li kan dao readln()—ji ben shang ji hu zong shi she ji cuo wu. readln() shi kong zhi tai de dong xi, kong zhi tai shi CLI. Domain ying gai neng zai mei you ren zai pang bian de qing kuang xia gong zuo.
  • Ru guo ni zai storage li kan dao println()—zhe ye shi xin hao: cang ku bu ying gai「ping lun ren sheng」。 Ta ying gai zhi fu ze cun he qu.
  • Ru guo ni dui wai bao lu MutableList, na wai bu ren he dai ma dou ke yi diao clear(), ran hou ni jiu hui kai shi zhao「shi shui chi le wo de shu ju」。 Kotlin de collections ming que fen kai read-only yu mutable interface, zhe ge qu bie zhi de yong lai dang zuo bao hu lan gan.

You shi hou ni hui jue de:「fan zheng dou shi wo yi ge ren xie, cha bu duo ba」。Cha hen duo. Cha bie zai yu: liang zhou hou de ni da kai zhe ge xiang mu, ni de nao zi li yi jing shi ling yi ge sheng huo, ling yi tao ren wu, bing qie wan quan bu xiang jie mi yi dui cong main li sheng cheng de mi ti.

4. Zai fen li CLI / domain / storage shi de chang jian cuo wu

Zai jie shu zhi qian, wo men zou yi bian da jia ji hu dou hui cai dao de keng(wo ye cai guo, bie dan xin—zhe suan shi chuan tong, jiu xiang cheng xu yuan de chuan tong shi zai tong yi ge mu lu li jian yi ge you yi ge「zui hou」wen jian final_final2.kt)。

Cuo wu 1: domain kai shi zai kong zhi tai da yin.
Tong chang kan qi lai hen wu hai:「wo zhi shi xiang zai addExpense li zhi jie println("Added!")」。Dan zhe yang domain jiu yi lai kong zhi tai le. Jie xia lai ni yi dan xiang yao bu tong de shu chu(bi ru yi hang bao biao, huo zhe gan cui bu shu chu), ni jiu de ba println cong luo ji li wa chu lai. Zheng que de xiang fa shi: domain yao me fan hui shu ju, yao me bao cuo, er da yin shi CLI de ze ren.

Cuo wu 2: domain wei le「fang bian」qu du ru (readln()).
Zhe hen you you huo:「rang service zi ji wen jin e bu jiu hao le」。Dan zhe yang service jiu wu fa zai mei you hu dong kong zhi tai de qing kuang xia shi yong(bi ru qi ta jie mian), er qie「dao di shei zai kong zhi zheng ge liu cheng」ye bian de bu qing bu chu. readln() yan ge lai shuo jiu shi CLI gong ju, ta jiu ying gai dai zai na li.

Cuo wu 3: storage yi public val de fang shi ba items: MutableList<Expense> bao lu chu qu.
Zhe zhong「wei le jian dan」de xie fa hen chang jian, ran hou某 ge CLI dai ma sui shou items.removeAt(0), zheng ge luo ji jiu huai le. Cang ku ying gai ba「ke bian xing」cang zai zi ji nei bu, dui wai zhi gei List。Zhe ji zhi chi read-only interface de guan nian, ye fang zhi ou ran de mutation.

Cuo wu 4: CLI kai shi zhi xing ye wu gui ze.
Bi ru, ni zai handleAdd li jue ding「jin e bi xu > 0」bing zai CLI li jian cha, dan domain li wang le. Ran hou yi dan chu xian ling yi tiao tian jia lu jing(ling yi ge ming ling, dao ru, shen me dou ke yi), yi bu fen gui ze jiu zhi zai yi ge di fang. Ye wu gui ze ying gai zhu zai domain, er CLI ying gai shi「fan yi qi」,bu shi「fa guan」。

Cuo wu 5: ba zheng li(normalization)he xian shi hun zai yi qi.
Fei chang chang jian: zi fu chuan title zhi zai da yin shi cai trim(), yin wei「zhe yang bi jiao hao kan」。Dan geng hao de zuo fa shi zai jin ru domain shi jiu zheng li(xiang wo men zuo de zhe yang), rang cheng xu nei bu de shu ju yong yuan zai tong yi ge ge shi. Na yang shu chu jiu zhi shi shu chu, bu xu yao zai「xiu bu yi yi」。

Cuo wu 6: tai zao xiang yao zuo「wan mei jia gou」。
Hai you yi zhong fan xiang ji duan: you ren ting dao「architecture」jiu xiang li ke zuo 25 ge class, 12 ge interface, zai hua yi zhang lian zi ji dou hai pa de tu. Jin tian mu biao geng pu su: ba shu ru/shu chu, gui ze, cun chu fen kai. Ru guo ni neng qing chu jie shi na li shi CLI, na li shi domain, na li shi storage—ni jiu yi jing zuo dui le, er qie dai ma hui ming xian geng「an ding」。

1
任務
Kotlin SELF, 等級 39, 課堂 0
上鎖
口袋筆記
口袋筆記
1
任務
Kotlin SELF, 等級 39, 課堂 0
上鎖
終端命令
終端命令
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION