📖 第二部分：核心理论、操作契约与用例实现实战#

1
                          23种经典设计模式 (GoF)
2
                                  |
3
         +------------------------+------------------------+
4
         |                        |                        |
5
  创建型模式 (Creational)   结构型模式 (Structural)   行为型模式 (Behavioral)
6
  关注“如何优雅地创建对象”  关注“类与对象的组合/桥接” 关注“算法在对象间的职责分配”
7
         |                        |                        |
8
  1. 单例模式 (Singleton)   1. 适配器模式 (Adapter)   1. 策略模式 (Strategy)
9
  2. 工厂方法 (Factory M.)  2. 装饰器模式 (Decorator)  2. 观察者模式 (Observer)
10
  3. 抽象工厂 (Abst. Fact.) 3. 代理模式 (Proxy)       3. 状态模式 (State)
11
  4. 建造者模式 (Builder)   4. 外观模式 (Facade)      4. 模板方法 (Template Method)
12
  5. 原型模式 (Prototype)   5. 桥接模式 (Bridge)      5. 命令模式 (Command)
13
                            6. 组合模式 (Composite)   6. 职责链模式 (Chain of Resp.)
14
                            7. 享元模式 (Flyweight)   7. 迭代器模式 (Iterator)
15
                                                      8. 中介者模式 (Mediator)
16
                                                      9. 备忘录模式 (Memento)
17
                                                      10. 访问者模式 (Visitor)
18
                                                      11. 解释器模式 (Interpreter)

1
// 1. 账户实体类
2
data class Account(
3
    val accountId: Long,
4
    var balance: Double // 余额
5
)
6

7
// 2. 交易记录实体类（取款成功后生成）
8
data class Transaction(
9
    val transactionId: Long,
10
    val accountId: Long,
11
    val amount: Double,
12
    val timestamp: Long
13
)

1
class AccountService(private val accountRepository: AccountRepository) {
2

3
    /**
4
     * 执行取款操作
5
     * @param accountId 账户ID
6
     * @param amount 取款金额
7
     */
8
    fun withdraw(accountId: Long, amount: Double): Long {
9
        // ------------------ 【前置状态校验】 ------------------
10
        // 校验1：账户在系统数据库中必须存在
11
        val account = accountRepository.findById(accountId)
12
            ?: throw IllegalArgumentException("账户不存在")
13

14
        // 校验2：账户余额必须大于或等于取款金额
15
        if (account.balance < amount) {
16
            throw IllegalStateException("余额不足")
17
        }
18

19
        // ------------------ 【执行状态改变】 ------------------
20
        // 改变1：修改已有账户对象的属性（余额扣减）
21
        account.balance -= amount
22

23
        // 改变2：创建了一个新的交易记录对象实例
24
        val newTxnId = System.currentTimeMillis() // 模拟生成唯一ID
25
        val transaction = Transaction(
26
            transactionId = newTxnId,
27
            accountId = account.accountId, // 改变3：新交易记录关联到了该账户
28
            amount = amount,
29
            timestamp = System.currentTimeMillis()
30
        )
31

32
        // ------------------ 【持久化保存】 ------------------
33
        accountRepository.update(account)
34
        accountRepository.saveTransaction(transaction)
35

36
        return newTxnId
37
    }
38
}