CodeGym /課程 /Kotlin SELF /Ruhe he gu jing gou zhong gu ding jia gou

Ruhe he gu jing gou zhong gu ding jia gou

Kotlin SELF
等級 39, 課堂 1
開放

1. Jian jie

Dang xiang mu hen xiao de shi hou, ni hui jue de mu lu he package shi “gei da er ke pa de enterprise yong de”, wo men zhi yao ba add zhe tiao ming ling xie wan, jiu ke yi qu he cha le. Dan wen ti zai yu: xiang mu de cheng zhang zong shi qiao qiao fa sheng——jin tian 3 ge wen jian, ming tian 12 ge, yi zhou hou ni zai zhao “wo men dao di zai na li parse ming ling”, ran hou fa xian you 4 ge parseCommand function, zhi cha yi ge kong ge.

Kotlin li de package ke yi li jie cheng ni xiang mu de “cheng shi fen qu”: zhe li zhu zhe CLI, zhe li shi ye wu luo ji, zhe li shi cun chu. Dang ni zun shou “shui ke yi import shei” de gui ze shi, jie gou jiu hui xiang lou ti shang de hu lan: ta bu hui zu zhi ni zou lu, que neng hen da cheng du shang fang zhi ni cong lou ti shang diao xia qu.

Kotlin zai ji shu shang bing bu yao qiu ci pan shang de mu lu jie gou bi xu he package ming cheng yi zhi: wen jian ke yi “ai fang na li jiu fang na li”. Dan ren lei de da nao bu shi bian yi qi, ta fei chang xi huan yi zhong dui ying guan xi: domain/model/Expense.kt zhen de bao han package domain.model. Suo yi zai shi wu shang, ji hu zong shi zhi de rang mu lu jie gou he package yi zhi: dao hang geng rong yi, import geng qing chu, yi dong wen jian shi geng bu rong yi chu cuo.

Ke yi zhe me xiang: bian yi qi bu zai hu wen jian fang zai na, dan ren zai hu. Wo men xie cheng xu shi gei ren kan de(shun bian ye gei bian yi qi kan yi dian, rang ta bu yao ku)。

2. Fu xi package he import

Zai Kotlin zhong, package sheng ming xie zai wen jian kai tou, import ze jin gen zai qi hou. Zhe bu zhi shi “yin wei da jia dou zhe yang xie” de chuan tong: ta rang wen jian ke yi cong shang dao xia geng shun chang di yue du——xian shi di zhi(package),zai shi yi lai(import),zui hou cai shi dai ma.

Tong shi, Kotlin zai ji shu shang bing bu yao qiu ci pan shang de mu lu jie gou bi xu he package ming cheng yi zhi: wen jian ke yi “ai fang na li jiu fang na li”. Dan dui tuan dui he IDE lai shuo, dang mu lu jie gou fu ke package jie gou shi hui an xin hen duo, te bie shi zai JVM xiang mu li hai yao he Java fang zai yi qi de qing kuang xia.

Mini li zi: package zuo wei wen jian de “di zhi”


package domain.model

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

Zhe li hen “cheng shi”: wen jian zai shuo “wo lai zi domain.model zhe ge qu”. Ru guo wo men yao zai ling yi ge package li shi yong Expense——jiu bi xu import.

3. Package jie gou: gu ding ze ren

Yao rang package cheng wei jia gou shang de ti shi, ming cheng jiu bi xu fan ying ze ren. Wo men yue ding yi ge jian dan, hao du, you zhu yu gu ding bian jie de jie gou:

Ceng (ze ren) Package Zhe li fang shen me Zhe li bu gai you shen me
CLI
app.cli
du qu ming ling, jie xi zi fu chuan, shu chu, cheng xu liu cheng ye wu gui ze, yi ji “sui bian zen me cun” de shu ju cun chu
Domain (mo xing)
domain.model
data class
ye wu ling yu de zi liao jie gou
readln()
,
println()
, ming ling, UI ge shi hua
Domain (gui ze/ye wu cao zuo)
domain.service
yan zheng, gui yi hua, dui mo xing de cao zuo zhi jie gen kong zhi tai hu dong
Storage
storage
cun qu shu ju(ji yi ti) ming ling jie xi he kong zhi tai shu chu

Zhe ge fen lei ke yi shuo shi ke yi “ke yi yong” de zui xiao jie gou. Zhong dian shi: ni kan yi yan package, jiu neng zhi dao “zhe shi liu cheng/ji ben UI” hai shi “zhe shi ye wu luo ji”.

4. Yi lai fang xiang: shui import shui

Zhe li jiu kai shi jin ru zhen zheng de jia gou le, ji shi xiang mu hai hen xiao. Yi lai fang xiang jiu shi “shui yi lai shui” de gui ze. Zai dai ma li ta zhi jie ti xian wei: wo men zai na xie package li xie import, import na xie package.

Wo men xi wang wai ceng(CLI)yi lai nei ceng(domain),er bu shi fan guo lai. Zhe yang domain jiu ke yi zai ren he di fang fu yong: dan yuan ce shi, ling yi zhong jie mian, ling yi zhong shu ru ming ling de fang shi. Ji shi ni xian zai hai mei zuo zhe xie——dan “ke yi zuo” zhe jian shi ben shen, jiu hui rang dai ma geng an ding.

Zhi guan shang(yun xu import de tu)da gai shi zhe yang:

flowchart TD
    CLI[app.cli] --> DS[domain.service]
    CLI --> DM[domain.model]
    CLI --> ST[storage]
    DS --> DM
    ST --> DM

    %% zhong yao xian zhi:
    %% domain bu yi lai app.cli

Ru guo yao jian hua cheng yi tiao gui ze: domain.* bu import app.cli.*。Yong yuan bu yao. Ji shi shi “zhi you yi ge hen xiao de printHelp()”. Yin wei zhe bu shi “xiao function”,zhe shi bian jie shang de po dong.

Wei shen me zhe zai zhen shi xiang mu li hen zhong yao

Ru guo domain kai shi import CLI, ni jiu hui de dao yi ge “yi yi shang de huan zhuang yi lai”: ni zai ye bu neng qing chu fen bian na li shi ye wu gui ze, na li shi jie mian. Zai mou ge shi ke, ren he yi ge xiu gai dou hui yao tong shi gai hen duo di fang——xiang mu jiu hui bian de fei chang cui ruo.

5. Shi zuo li zi: an package bai fang dai ma

Xian zai wo men na wo men de jiao xue xiang mu(yi ge jian hua de zhi chu ji lu qi)lai zuo fen lei, rang jie gou fan ying jia gou. Zhong dian: wo men bu shi yao zuo “200 ge wen jian de meng xiang xiang mu”. Wo men yao zuo de shi yi ge xiao xiang mu, dan “di li wei zhi” zheng que.

Jia she src/main/kotlin xia shi zhe yang de jie gou:

src/main/kotlin
├── app
│   └── cli
│       ├── Main.kt
│       └── ParsedCommand.kt
├── domain
│   ├── model
│   │   └── Expense.kt
│   └── service
│       └── ExpenseService.kt
└── storage
    └── InMemoryExpenseStorage.kt

Qing zhu yi: Kotlin bu hui qiang po ni zhe yang zuo, dan dai ma zu zhi de guan li yue ding qi shi hen tui jian——te bie shi rang mu lu jie gou gen sui package.

domain.model: domain mo xing

Wo men cong zui “chun jing” de dong xi kai shi——mo xing.

package domain.model

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

Zhe li mei you kong zhi tai, mei you ming ling, ye mei you “yao zen me piao liang di xian shi”. Zhi you shu ju.

domain.service: gui ze yu cao zuo

Zai lai shi service: ta ba yuan shi can shu bian cheng yi ge he fa de Expense。Qing zhu yi: service bu cun list ye bu print。Ta zuo de shi gui ze.

package domain.service

import domain.model.Expense

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

Wo men cong domain.model import mo xing, zhe shi zheng chang de “service → model” yi lai.

storage: ji yi ti cun chu

Ji yi ti cun chu shi wo men de “zui xiao storage ceng”: ta neng bao cun yi bi zhi chu, ye neng hui chuan quan bu zhi chu. Ta bu zhi dao ming ling he kong zhi tai, ta zhi zhi dao mo xing.

package storage

import domain.model.Expense

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

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

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

Zhe li you ge zhong dian: dui wai fan hui List<Expense>, er bu shi MutableList<Expense>。Zhe yang ke yi bi mian ba storage bian cheng “shui dou ke jin lai gai yi dian” de chang suo.

app.cli: ming ling yu zi fu chuan jie xi

CLI ceng shi ni gen zi fu chuan, kong ge, yi ji ren lei shu ru cuo wu da jiao dao de di fang——bi ru “wo shu ru le add coffee 200” zhe zhong. Domain bu ying gai guan zhe xie.

Wo men zuo yi ge xiao xing bie ParsedCommand, rang main bu yong chu li “mo fa index”.

package app.cli

data class ParsedCommand(val name: String, val args: List<String>)

Ran hou shi parse function(xian zai jin liang jian dan, bu zhui qiu wan mei):

package app.cli

fun parseCommandLine(line: String): ParsedCommand {
    val parts = line.trim().split(" ").filter { it.isNotEmpty() }
    val name = parts.firstOrNull()?.lowercase() ?: ""
    val args = if (parts.size > 1) parts.drop(1) else emptyList()
    return ParsedCommand(name = name, args = args)
}

Zhe li quan shi “CLI feng ge”: trim、split、lowercase。

app.cli.Main: zu zhuang ying yong yu liu cheng

Zui hou shi main。Ta import ta xu yao de dong xi, ran hou ba liu cheng “nian he” qi lai: du yi hang → parse → ying yong gui ze → cun qi lai → xian shi jie guo.

package app.cli

import domain.service.ExpenseService
import storage.InMemoryExpenseStorage

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

    print("Command: ")                  // Command:
    val cmd = parseCommandLine(readln())

    when (cmd.name) {
        "add" -> {
            val title = cmd.args.getOrNull(0) ?: ""
            val amount = cmd.args.getOrNull(1)?.toIntOrNull() ?: 0

            val expense = service.createExpense(title, amount)
            storage.add(expense)

            println("Added: $expense")  // Added: Expense(title=..., amount=...)
        }
        "list" -> println(storage.all())
        else -> println("Unknown command: ${cmd.name}")
    }
}

Cong yi lai guan xi lai kan, zhe yang hen piao liang: CLI yi lai domain he storage。Domain bu yi lai CLI。Storage ye bu yi lai CLI。Suo yi ru guo ni ming tian xiang huan yi zhong jie mian(bi ru bu shi kong zhi tai), ni bu hui de dao yi chuan “println lie che”.

6. Yong import zuo wei wen ti zhi biao, yi ji utils de xian jing

You ge hen shi yong de ji qiao: you shi hou zhi yao da kai yi ge wen jian, kan kan ta de import, jiu zhi dao jia gou you mei you “piao” diao. Ru guo ni kan dao domain.service li de wen jian import le app.cli li de dong xi, ji ben shang jiu shi xin hao: “wo men ba UI xi jie ying sai jin ye wu luo ji le”.

Huan you yi ge xi jie: Kotlin de ming cheng jie xi gui ze hui gen ju import you you xian ji. Bi ru, xian shi import tong chang bi xing hao import(*)huo “tong package li zhao dao de” you geng gao de you xian ji. Zhe bu dai biao wo men yao dui import huo zai kong ju zhong. Ta dai biao import shi xiang mu she ji de yi bu fen, er bu shi “shang mian de la ji”.

Hen kuai, xiang mu li hui chu xian “fang bian function”: formatMoney、readInt、normalizeTitle、parseSomething。Ran hou ni hui xiang chuang yi ge utils package, ba quan bu dong xi dou diu jin qu. Zhe kan qi lai xiang zheng li, dan jing chang hui bian cheng “xian lu xiang”: fan zheng xian zai bu zhi dao fang na li, jiu xian diu jin qu.

Wen ti bu zai utils zhe ge ming zi, er zai “mei you ze ren ding wei”. Dang yi ge util bu shu yu mou ge ceng, ta jiu kai shi wang si mian ba fang la che yi lai. Bi ru, utils.formatExpense() tu ran kai shi import domain.model.Expense, ran hou you ren zai li mian jia le println “yong yu debug”,zhe ge util jiu bu zai shi util, er shi yi ge xiao xing hun luan chuan song men.

Geng wen ding de zuo fa shi: rang fu zhu function dai zai ta suo shu ceng de pang bian. Ming ling parse zai app.cli, gui yi hua gui ze zai domain.service, dui cun chu list de cao zuo zai storage。Package bu shi la ji tong, shi di zhi.

7. Chang jian cuo wu

Cuo wu 1: domain dai ma tong guo “wu gu de import” kai shi yi lai CLI。
Tong chang zhe hui cong yi ju hua kai shi: “wo zhi shi xiang piao liang di da yin yi ge cuo wu xin xi”. Ran hou jiu chu xian le import app.cli.printError。Zhi yao fa sheng zhe jian shi, domain jiu bu neng tuo li kong zhi tai du li shi yong, ze ren bian jie ye xiao shi. Geng hao de zuo fa shi: rang domain fan hui qing chu de cuo wu(huo zhe diu require),ran hou you CLI jue ding yao zen me xian shi gei yong hu.

Cuo wu 2: mu lu he package bu yi zhi, yin wei “Kotlin ben lai jiu yun xu”。
Mei cuo, yun xu: wen jian ke yi fang zai ren he di fang. Dan guan yu yuan ma zu zhi de jian yi ming que shuo: mu lu jie gou ying gai gen sui package jie gou, te bie shi zai JVM shang. Fou ze IDE dao hang hui hen qi guai, yi dong wen jian hui hen tong ku, xiang mu kan qi lai jiu xiang mei you di tu de mi gong.

Cuo wu 3: storage dui wai fan hui MutableList, dao zhi ren he dai ma dou ke yi sui yi xiu gai shu ju。
Kan qi lai hen fang bian: “wo hui xiao xin de”. Dan yi zhou hou ni jiu hui wang ji ni dao di zai na li “xiao xin” le, ran hou zhuang tai bei mo ming qi miao di gai le. Dui wai fan hui List, ba mu ti bian geng kong zhi zai storage ceng nei bu——zhe yang geng rong yi guan li “shui zai na li gai le shu ju”.

Cuo wu 4: xing hao import(import something.*)kai shi “zi ji guan zi ji”。
* import you shi hou kan qi lai hen fang bian, dan zai da xiang mu li hui jiang di ke du xing, ye ke neng yin fa yi xiang bu dao de ming cheng chong tu. Er qie Kotlin de ming cheng jie xi you you xian ji: xian shi import hui “zhan shang feng”, gai gai guo * dai lai de dong xi——zhe ye shi yi ge bu yao ba import bian cheng chou qian you xi de li you.

Cuo wu 5: utils bian cheng “shen me dou wang li mian reng” de za wu dui。
Xiang mu xiao de shi hou, zhe kan qi lai hen you tiao li. Dan zhi yao ba bu tong ceng de function diu jin qu, zhe ge package jiu hui ba yi lai wang si mian ba fang la, bing po huai ze ren bian jie. Geng hao de zuo fa shi: ba “util” fang zai ta dui ying de ceng he ren wu pang bian——zhe yang import geng hao guan, jie gou ye geng zi ming.

1
任務
Kotlin SELF, 等級 39, 課堂 1
上鎖
使用者註冊
使用者註冊
1
任務
Kotlin SELF, 等級 39, 課堂 1
上鎖
購物清單
購物清單
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION