DDD之领域层设计规范

在一个DDD架构设计中,领域层的设计合理性会直接影响整个架构的代码结构以及应用层、基础设施层的设计。但是领域层设计又是有挑战的任务,特别是在一个业务逻辑相对复杂应用中,每一个业务规则是应该放在Entity、ValueObject 还是 DomainService是值得用心思考的,既要避免未来的扩展性差,又要确保不会过度设计导致复杂性。

一,需求背景

用代码实现一个龙与魔法的游戏世界的(极简)规则?

基础配置如下

  • 玩家(Player)可以是战士(Fighter)、法师(Mage)、龙骑(Dragoon)

  • 怪物(Monster)可以是兽人(Orc)、精灵(Elf)、龙(Dragon),怪物有血量

  • 武器(Weapon)可以是剑(Sword)、法杖(Staff),武器有攻击力

  • 玩家可以装备一个武器,武器攻击可以是物理类型(0),火(1),冰(2)等,武器类型决定伤害类型

攻击规则如下

  1. 兽人对物理攻击伤害减半
  2. 精灵对魔法攻击伤害减半
  3. 龙对物理和魔法攻击免疫,除非玩家是龙骑,则伤害加倍

二,OOP实现

对于熟悉Object-Oriented Programming的同学,一个比较简单的实现是通过类的继承关系(此处省略部分非核心代码):

public abstract class Player {
     
      Weapon weapon
}
public class Fighter extends Player {
     }
public class Mage extends Player {
     }
public class Dragoon extends Player {
     }
 
 
public abstract class Monster {
     
    Long health;
}
public Orc extends Monster {
     }
public Elf extends Monster {
     }
public Dragoon extends Monster {
     }
 
 
public abstract class Weapon {
     
    int damage;
    int damageType; // 0 - physical, 1 - fire, 2 - ice etc.
}
public Sword extends Weapon {
     }
public Staff extends Weapon {
     }

而实现规则代码如下:

public class Player {
     
    public void attack(Monster monster) {
     
        monster.receiveDamageBy(weapon, this);
    }
}
 
 
public class Monster {
     
    public void receiveDamageBy(Weapon weapon, Player player) {
     
        this.health -= weapon.getDamage(); // 基础规则
    }
}
 
 
public class Orc extends Monster {
     
    @Override
    public void receiveDamageBy(Weapon weapon, Player player) {
     
        if (weapon.getDamageType() == 0) {
     
            this.setHealth(this.getHealth() - weapon.getDamage() / 2); // Orc的物理防御规则
        } else {
     
            super.receiveDamageBy(weapon, player);
        }
    }
}
 
 
public class Dragon extends Monster {
     
    @Override
    public void receiveDamageBy(Weapon weapon, Player player) {
     
        if (player instanceof Dragoon) {
     
            this.setHealth(this.getHealth() - weapon.getDamage() * 2); // 龙骑伤害规则
        }
        // else no damage, 龙免疫力规则
    }
}

然后跑几个单元测试:

public class BattleTest {
     
 
 
    @Test
    @DisplayName("Dragon is immune to attacks")
    public void testDragonImmunity() {
     
        // Given
        Fighter fighter = new Fighter("Hero");
        Sword sword = new Sword("Excalibur", 10);
        fighter.setWeapon(sword);
        Dragon dragon = new Dragon("Dragon", 100L);
 
 
        // When
        fighter.attack(dragon);
 
 
        // Then
        assertThat(dragon.getHealth()).isEqualTo(100);
    }
 
 
    @Test
    @DisplayName("Dragoon attack dragon doubles damage")
    public void testDragoonSpecial() {
     
        // Given
        Dragoon dragoon = new Dragoon("Dragoon");
        Sword sword = new Sword("Excalibur", 10);
        dragoon.setWeapon(sword);
        Dragon dragon = new Dragon("Dragon", 100L);
 
 
        // When
        dragoon.attack(dragon);
 
 
        // Then
        assertThat(dragon.getHealth()).isEqualTo(100 - 10 * 2);
    }
 
 
    @Test
    @DisplayName("Orc should receive half damage from physical weapons")
    public void testFighterOrc() {
     
        // Given
        Fighter fighter = new Fighter("Hero");
        Sword sword = new Sword("Excalibur", 10);
        fighter.setWeapon(sword);
        Orc orc = new Orc("Orc", 100L);
 
 
        // When
        fighter.attack(orc);
 
 
        // Then
        assertThat(orc.getHealth()).isEqualTo(100 - 10 / 2);
    }
 
 
    @Test
    @DisplayName("Orc receive full damage from magic attacks")
    public void testMageOrc() {
     
        // Given
        Mage mage = new Mage("Mage");
        Staff staff = new Staff("Fire Staff", 10);
        mage.setWeapon(staff);
        Orc orc = new Orc("Orc", 100L);
 
 
        // When
        mage.attack(orc);
 
 
        // Then
        assertThat(orc.getHealth()).isEqualTo(100 - 10);
    }
}

三,分析OOP代码设计的缺陷

1.编程语言的强类型无法承载业务规则

以上的OOP代码可以跑得通,直到我们加一个限制条件:

  • 战士只能装备剑
  • 法师只能装备法杖

这个规则在Java语言里无法通过强类型来实现,虽然Java有Variable Hiding(或者C#的new class variable),但实际上只是在子类上加了一个新变量,所以会导致以下的问题:

@Data
public class Fighter extends Player {
     
    private Sword weapon;
}
 
 
@Test
public void testEquip() {
     
    Fighter fighter = new Fighter("Hero");
 
 
    Sword sword = new Sword("Sword", 10);
    fighter.setWeapon(sword);
 
 
    Staff staff = new Staff("Staff", 10);
    fighter.setWeapon(staff);
 
 
    assertThat(fighter.getWeapon()).isInstanceOf(Staff.class); // 错误了
}

在最后,虽然代码感觉是setWeapon(Staff),但实际上只修改了父类的变量,并没有修改子类的变量,所以实际不生效,也不抛异常,但结果是错的。

当然,可以在父类限制setter为protected,但这样就限制了父类的API,极大的降低了灵活性,同时也违背了Liskov substitution principle,即一个父类必须要cast成子类才能使用:

@Data
public abstract class Player {
     
    @Setter(AccessLevel.PROTECTED)
    private Weapon weapon;
}
 
 
@Test
public void testCastEquip() {
     
    Fighter fighter = new Fighter("Hero");
 
 
    Sword sword = new Sword("Sword", 10);
    fighter.setWeapon(sword);
 
 
    Player player = fighter;
    Staff staff = new Staff("Staff", 10);
    player.setWeapon(staff); // 编译不过,但从API层面上应该开放可用
}

最后,如果规则增加一条:

  • 战士和法师都能装备匕首(dagger)

好家伙,之前写的强类型代码都废了,需要重构。

2.对象继承导致代码强依赖父类逻辑,违反开闭原则

开闭原则(OCP)规定“对象应该对于扩展开放,对于修改封闭“,继承虽然可以通过子类扩展新的行为,但因为子类可能直接依赖父类的实现,导致一个变更可能会影响所有对象。在这个例子里,如果增加任意一种类型的玩家、怪物或武器,或增加一种规则,都有可能需要修改从父类到子类的所有方法。

比如,如果要增加一个武器类型:狙击枪,能够无视所有防御一击必杀,需要修改的代码包括:

  • Weapon

  • Player和所有的子类(是否能装备某个武器的判断)

  • Monster和所有的子类(伤害计算逻辑)

public class Monster {
     
    public void receiveDamageBy(Weapon weapon, Player player) {
     
        this.health -= weapon.getDamage(); // 老的基础规则
        if (Weapon instanceof Gun) {
      // 新的逻辑
            this.setHealth(0);
        }
    }
}
 
 
public class Dragon extends Monster {
     
    public void receiveDamageBy(Weapon weapon, Player player) {
     
        if (Weapon instanceof Gun) {
      // 新的逻辑
                      super.receiveDamageBy(weapon, player);
        }
        // 老的逻辑省略
    }
}

在一个复杂的软件中为什么会建议“尽量”不要违背OCP?最核心的原因就是一个现有逻辑的变更可能会影响一些原有的代码,导致一些无法预见的影响。这个风险只能通过完整的单元测试覆盖来保障,但在实际开发中很难保障单测的覆盖率。OCP的原则能尽可能的规避这种风险,当新的行为只能通过新的字段/方法来实现时,老代码的行为自然不会变。

继承虽然能Open for extension,但很难做到Closed for modification。所以今天解决OCP的主要方法是通过Composition-over-inheritance,即通过组合来做到扩展性,而不是通过继承。

3.Player.attack(monster) 还是 Monster.receiveDamage(Weapon, Player)?

在这个例子里,其实业务规则的逻辑到底应该写在哪里是有异议的:当我们去看一个对象和另一个对象之间的交互时,到底是Player去攻击Monster,还是Monster被Player攻击?目前的代码主要将逻辑写在Monster的类中,主要考虑是Monster会受伤降低Health,但如果是Player拿着一把双刃剑会同时伤害自己呢?是不是发现写在Monster类里也有问题?代码写在哪里的原则是什么?

4.多对象行为类似,导致代码重复

当我们有不同的对象,但又有相同或类似的行为时,OOP会不可避免的导致代码的重复。在这个例子里,如果我们去增加一个“可移动”的行为,需要在Player和Monster类中都增加类似的逻辑:

public abstract class Player {
     
    int x;
    int y;
    void move(int targetX, int targetY) {
     
        // logic
    }
}
 
 
public abstract class Monster {
     
    int x;
    int y;
    void move(int targetX, int targetY) {
     
        // logic
    }
}

一个可能的解法是有个通用的父类:

public abstract class Movable {
     
    int x;
    int y;
    void move(int targetX, int targetY) {
     
        // logic
    }
}
 
 
public abstract class Player extends Movable;
public abstract class Monster extends Movable;

但如果再增加一个跳跃能力Jumpable呢?一个跑步能力Runnable呢?如果Player可以Move和Jump,Monster可以Move和Run,怎么处理继承关系?要知道Java(以及绝大部分语言)是不支持多父类继承的,所以只能通过重复代码来实现。

5.总结

在这个案例里虽然从直觉来看OOP的逻辑很简单,但如果你的业务比较复杂,未来会有大量的业务规则变更时,简单的OOP代码会在后期变成复杂的一团浆糊,逻辑分散在各地,缺少全局视角,各种规则的叠加会触发bug。有没有感觉似曾相识?对的,电商体系里的优惠、交易等链路经常会碰到类似的坑。而这类问题的核心本质在于:

  • 业务规则的归属到底是对象的“行为”还是独立的”规则对象“?

  • 业务规则之间的关系如何处理?

  • 通用“行为”应该如何复用和维护?

四,基于DDD的解法

1.领域对象

回到我们原来的问题域上面,我们从领域层拆分一下各种对象:

实体类

在DDD里,实体类包含ID和内部状态,在这个案例里实体类包含Player、Monster和Weapon。Weapon被设计成实体类是因为两把同名的Weapon应该可以同时存在,所以必须要有ID来区分,同时未来也可以预期Weapon会包含一些状态,比如升级、临时的buff、耐久等。

public class Player implements Movable {
     
    private PlayerId id;
    private String name;
    private PlayerClass playerClass; // enum
    private WeaponId weaponId; // (Note 1)
    private Transform position = Transform.ORIGIN;
    private Vector velocity = Vector.ZERO;
}
 
 
public class Monster implements Movable {
     
    private MonsterId id;
    private MonsterClass monsterClass; // enum
    private Health health;
    private Transform position = Transform.ORIGIN;
    private Vector velocity = Vector.ZERO;
}
 
 
public class Weapon {
     
    private WeaponId id;
    private String name;
    private WeaponType weaponType; // enum
    private int damage;
    private int damageType; // 0 - physical, 1 - fire, 2 - ice
}

在这个简单的案例里,我们可以利用enum的PlayerClass、MonsterClass来代替继承关系,后续也可以利用Type Object设计模式来做到数据驱动。

Note 1: 因为 Weapon 是实体类,但是Weapon能独立存在,Player不是聚合根,所以Player只能保存WeaponId,而不能直接指向Weapon。

值对象的组件化

可以通过接口的方式对领域对象做组件化处理:

public interface Movable {
     
    // 相当于组件
    Transform getPosition();
    Vector getVelocity();
 
 
    // 行为
    void moveTo(long x, long y);
    void startMove(long velX, long velY);
    void stopMove();
    boolean isMoving();
}
 
 
// 具体实现
public class Player implements Movable {
     
    public void moveTo(long x, long y) {
     
        this.position = new Transform(x, y);
    }
 
 
    public void startMove(long velocityX, long velocityY) {
     
        this.velocity = new Vector(velocityX, velocityY);
    }
 
 
    public void stopMove() {
     
        this.velocity = Vector.ZERO;
    }
 
 
    @Override
    public boolean isMoving() {
     
        return this.velocity.getX() != 0 || this.velocity.getY() != 0;
    }
}
 
 
@Value
public class Transform {
     
    public static final Transform ORIGIN = new Transform(0, 0);
    long x;
    long y;
}
 
 
@Value
public class Vector {
     
    public static final Vector ZERO = new Vector(0, 0);
    long x;
    long y;
}

注意两点:

Moveable的接口没有Setter。一个Entity的规则是不能直接变更其属性,必须通过Entity的方法去对内部状态做变更。这样能保证数据的一致性。

抽象Movable的好处是如同ECS一样,一些特别通用的行为(如在大地图里移动)可以通过统一的System代码去处理,避免了重复劳动。

2.装备行为

因为我们已经不会用Player的子类来决定什么样的Weapon可以装备,所以这段逻辑应该被拆分到一个单独的类里。这种类在DDD里被叫做领域服务(Domain Service)。

public interface EquipmentService {
     
    boolean canEquip(Player player, Weapon weapon);
}

在DDD里,一个Entity不应该直接参考另一个Entity或服务,也就是说以下的代码是错误的:

public class Player {
     
    @Autowired
    EquipmentService equipmentService; // BAD: 不可以直接依赖
 
 
    public void equip(Weapon weapon) {
     
       // ...
    }
}

这里的问题是Entity只能保留自己的状态(或非聚合根的对象)。任何其他的对象,无论是否通过依赖注入的方式弄进来,都会破坏Entity的Invariance,并且还难以单测。

正确的引用方式是通过方法参数引入(Double Dispatch):

public class Player {
     
 
 
    public void equip(Weapon weapon, EquipmentService equipmentService) {
     
        if (equipmentService.canEquip(this, weapon)) {
     
            this.weaponId = weapon.getId();
        } else {
     
            throw new IllegalArgumentException("Cannot Equip: " + weapon);
        }
    }
}

在这里,无论是Weapon还是EquipmentService都是通过方法参数传入,确保不会污染Player的自有状态。

Double Dispatch是一个使用Domain Service经常会用到的方法,类似于调用反转。

然后在EquipmentService里实现相关的逻辑判断,这里我们用了另一个常用的Strategy(或者叫Policy)设计模式:

public class EquipmentServiceImpl implements EquipmentService {
     
    private EquipmentManager equipmentManager; 
 
 
    @Override
    public boolean canEquip(Player player, Weapon weapon) {
     
        return equipmentManager.canEquip(player, weapon);
    }
}
 
 
// 策略优先级管理
public class EquipmentManager {
     
    private static final List<EquipmentPolicy> POLICIES = new ArrayList<>();
    static {
     
        POLICIES.add(new FighterEquipmentPolicy());
        POLICIES.add(new MageEquipmentPolicy());
        POLICIES.add(new DragoonEquipmentPolicy());
        POLICIES.add(new DefaultEquipmentPolicy());
    }
 
 
    public boolean canEquip(Player player, Weapon weapon) {
     
        for (EquipmentPolicy policy : POLICIES) {
     
            if (!policy.canApply(player, weapon)) {
     
                continue;
            }
            return policy.canEquip(player, weapon);
        }
        return false;
    }
}
 
 
// 策略案例
public class FighterEquipmentPolicy implements EquipmentPolicy {
     
 
 
    @Override
    public boolean canApply(Player player, Weapon weapon) {
     
        return player.getPlayerClass() == PlayerClass.Fighter;
    }
 
 
    /**
     * Fighter能装备Sword和Dagger
     */
    @Override
    public boolean canEquip(Player player, Weapon weapon) {
     
        return weapon.getWeaponType() == WeaponType.Sword
                || weapon.getWeaponType() == WeaponType.Dagger;
    }
}
 
 
// 其他策略省略,见源码

这样设计的最大好处是未来的规则增加只需要添加新的Policy类,而不需要去改变原有的类。

3.攻击行为

在上文中曾经有提起过,到底应该是Player.attack(Monster)还是Monster.receiveDamage(Weapon, Player)?在DDD里,因为这个行为可能会影响到Player、Monster和Weapon,所以属于跨实体的业务逻辑。在这种情况下需要通过一个第三方的领域服务(Domain Service)来完成。

public interface CombatService {
     
    void performAttack(Player player, Monster monster);
}
 
 
public class CombatServiceImpl implements CombatService {
     
    private WeaponRepository weaponRepository;
    private DamageManager damageManager;
 
 
    @Override
    public void performAttack(Player player, Monster monster) {
     
        Weapon weapon = weaponRepository.find(player.getWeaponId());
        int damage = damageManager.calculateDamage(player, weapon, monster);
        if (damage > 0) {
     
            monster.takeDamage(damage); // (Note 1)在领域服务里变更Monster
        }
        // 省略掉Player和Weapon可能受到的影响
    }
}

同样的在这个案例里,可以通过Strategy设计模式来解决damage的计算问题:

// 策略优先级管理
public class DamageManager {
     
    private static final List<DamagePolicy> POLICIES = new ArrayList<>();
    static {
     
        POLICIES.add(new DragoonPolicy());
        POLICIES.add(new DragonImmunityPolicy());
        POLICIES.add(new OrcResistancePolicy());
        POLICIES.add(new ElfResistancePolicy());
        POLICIES.add(new PhysicalDamagePolicy());
        POLICIES.add(new DefaultDamagePolicy());
    }
 
 
    public int calculateDamage(Player player, Weapon weapon, Monster monster) {
     
        for (DamagePolicy policy : POLICIES) {
     
            if (!policy.canApply(player, weapon, monster)) {
     
                continue;
            }
            return policy.calculateDamage(player, weapon, monster);
        }
        return 0;
    }
}
 
 
// 策略案例
public class DragoonPolicy implements DamagePolicy {
     
    public int calculateDamage(Player player, Weapon weapon, Monster monster) {
     
        return weapon.getDamage() * 2;
    }
    @Override
    public boolean canApply(Player player, Weapon weapon, Monster monster) {
     
        return player.getPlayerClass() == PlayerClass.Dragoon &&
                monster.getMonsterClass() == MonsterClass.Dragon;
    }
}

4.单元测试

@Test
@DisplayName("Dragoon attack dragon doubles damage")
public void testDragoonSpecial() {
     
    // Given
    Player dragoon = playerFactory.createPlayer(PlayerClass.Dragoon, "Dart");
    Weapon sword = weaponFactory.createWeaponFromPrototype(swordProto, "Soul Eater", 60);
    ((WeaponRepositoryMock)weaponRepository).cache(sword);
    dragoon.equip(sword, equipmentService);
    Monster dragon = monsterFactory.createMonster(MonsterClass.Dragon, 100);
 
 
    // When
    combatService.performAttack(dragoon, dragon);
 
 
    // Then
    assertThat(dragon.getHealth()).isEqualTo(Health.ZERO);
    assertThat(dragon.isAlive()).isFalse();
}
 
 
@Test
@DisplayName("Orc should receive half damage from physical weapons")
public void testFighterOrc() {
     
    // Given
    Player fighter = playerFactory.createPlayer(PlayerClass.Fighter, "MyFighter");
    Weapon sword = weaponFactory.createWeaponFromPrototype(swordProto, "My Sword");
    ((WeaponRepositoryMock)weaponRepository).cache(sword);
    fighter.equip(sword, equipmentService);
    Monster orc = monsterFactory.createMonster(MonsterClass.Orc, 100);
 
 
    // When
    combatService.performAttack(fighter, orc);
 
 
    // Then
    assertThat(orc.getHealth()).isEqualTo(Health.of(100 - 10 / 2));
}

具体的代码比较简单,解释省略

5.移动系统

最后还有一种Domain Service,通过组件化,我们其实可以实现ECS一样的System,来降低一些重复性的代码:

public class MovementSystem {
     
 
 
    private static final long X_FENCE_MIN = -100;
    private static final long X_FENCE_MAX = 100;
    private static final long Y_FENCE_MIN = -100;
    private static final long Y_FENCE_MAX = 100;
 
 
    private List<Movable> entities = new ArrayList<>();
 
 
    public void register(Movable movable) {
     
        entities.add(movable);
    }
 
 
    public void update() {
     
        for (Movable entity : entities) {
     
            if (!entity.isMoving()) {
     
                continue;
            }
 
 
            Transform old = entity.getPosition();
            Vector vel = entity.getVelocity();
            long newX = Math.max(Math.min(old.getX() + vel.getX(), X_FENCE_MAX), X_FENCE_MIN);
            long newY = Math.max(Math.min(old.getY() + vel.getY(), Y_FENCE_MAX), Y_FENCE_MIN);
            entity.moveTo(newX, newY);
        }
    }
}

单元测试

@Test
@DisplayName("Moving player and monster at the same time")
public void testMovement() {
     
    // Given
    Player fighter = playerFactory.createPlayer(PlayerClass.Fighter, "MyFighter");
    fighter.moveTo(2, 5);
    fighter.startMove(1, 0);
 
 
    Monster orc = monsterFactory.createMonster(MonsterClass.Orc, 100);
    orc.moveTo(10, 5);
    orc.startMove(-1, 0);
 
 
    movementSystem.register(fighter);
    movementSystem.register(orc);
 
 
    // When
    movementSystem.update();
 
 
    // Then
    assertThat(fighter.getPosition().getX()).isEqualTo(2 + 1);
    assertThat(orc.getPosition().getX()).isEqualTo(10 - 1);
}

在这里MovementSystem就是一个相对独立的Domain Service,通过对Movable的组件化,实现了类似代码的集中化、以及一些通用依赖/配置的中心化(如X、Y边界等)。

五,DDD领域层的一些设计规范

  • 基于继承关系的OOP代码:OOP的代码最好写,也最容易理解,所有的规则代码都写在对象里,但是当领域规则变得越来越复杂时,其结构会限制它的发展。新的规则有可能会导致代码的整体重构。
  • 基于领域对象 + 领域服务的DDD架构:DDD的规则其实最复杂,同时要考虑到实体类的内聚和保证不变性(Invariants),也要考虑跨对象规则代码的归属,甚至要考虑到具体领域服务的调用方式,理解成本比较高。

1.实体类

大多数DDD架构的核心都是实体类,实体类包含了一个领域里的状态、以及对状态的直接操作。Entity最重要的设计原则是保证实体的不变性(Invariants),也就是说要确保无论外部怎么操作,一个实体内部的属性都不能出现相互冲突,状态不一致的情况。所以几个设计原则如下:

1)创建即一致

在贫血模型里,通常见到的代码是一个模型通过手动new出来之后,由调用方一个参数一个参数的赋值,这就很容易产生遗漏,导致实体状态不一致。所以DDD里实体创建的方法有两种:

constructor参数要包含所有必要属性,或者在constructor里有合理的默认值。

比如,账号的创建:

public class Account {
     
    private String accountNumber;
    private Long amount;
}
 
 
@Test
public void test() {
     
    Account account = new Account();
    account.setAmount(100L);
    TransferService.transfer(account); // 报错了,因为Account缺少必要的AccountNumber
}

如果缺少一个强校验的constructor,就无法保障创建的实体的一致性。所以需要增加一个强校验的constructor:

public class Account {
     
    public Account(String accountNumber, Long amount) {
     
        assert StringUtils.isNotBlank(accountNumber);
        assert amount >= 0;
        this.accountNumber = accountNumber;
        this.amount = amount;
    }
}
 
 
@Test
public void test() {
     
    Account account = new Account("123", 100L); // 确保对象的有效性
}

2)使用Factory模式来降低调用方复杂度

另一种方法是通过Factory模式来创建对象,降低一些重复性的入参。比如:

public class WeaponFactory {
     
    public Weapon createWeaponFromPrototype(WeaponPrototype proto, String newName) {
     
        Weapon weapon = new Weapon(null, newName, proto.getWeaponType(), proto.getDamage(), proto.getDamageType());
        return weapon;
    }
}

通过传入一个已经存在的Prototype,可以快速的创建新的实体。还有一些其他的如Builder等设计模式就不一一指出了。

3)尽量避免public setter

一个最容易导致不一致性的原因是实体暴露了public的setter方法,特别是set单一参数会导致状态不一致的情况。比如,一个订单可能包含订单状态(下单、已支付、已发货、已收货)、支付单、物流单等子实体,如果一个调用方能随意去set订单状态,就有可能导致订单状态和子实体匹配不上,导致业务流程走不通的情况。所以在实体里,需要通过行为方法来修改内部状态:

@Data @Setter(AccessLevel.PRIVATE) // 确保不生成public setter
public class Order {
     
    private int status; // 0 - 创建,1 - 支付,2 - 发货,3 - 收货
    private Payment payment; // 支付单
    private Shipping shipping; // 物流单
 
 
    public void pay(Long userId, Long amount) {
     
        if (status != 0) {
     
            throw new IllegalStateException();
        }
        this.status = 1;
        this.payment = new Payment(userId, amount);
    }
 
 
    public void ship(String trackingNumber) {
     
        if (status != 1) {
     
            throw new IllegalStateException();
        }
        this.status = 2;
        this.shipping = new Shipping(trackingNumber);
    }
}

4)通过聚合根保证主子实体的一致性

在稍微复杂一点的领域里,通常主实体会包含子实体,这时候主实体就需要起到聚合根的作用,即:

子实体不能单独存在,只能通过聚合根的方法获取到。任何外部的对象都不能直接保留子实体的引用

子实体没有独立的Repository,不可以单独保存和取出,必须要通过聚合根的Repository实例化

子实体可以单独修改自身状态,但是多个子实体之间的状态一致性需要聚合根来保障

常见的电商域中聚合的案例如主子订单模型、商品/SKU模型、跨子订单优惠、跨店优惠模型等。很多聚合根和Repository的设计规范在我前面一篇关于Repository的文章中已经详细解释过,可以拿来参考。

5)不可以强依赖其他聚合根实体或领域服务

一个实体的原则是高内聚、低耦合,即一个实体类不能直接在内部直接依赖一个外部的实体或服务。这个原则和绝大多数ORM框架都有比较严重的冲突,所以是一个在开发过程中需要特别注意的。这个原则的必要原因包括:对外部对象的依赖性会直接导致实体无法被单测;以及一个实体无法保证外部实体变更后不会影响本实体的一致性和正确性。

所以,正确的对外部依赖的方法有两种:

只保存外部实体的ID:这里我再次强烈建议使用强类型的ID对象,而不是Long型ID。强类型的ID对象不单单能自我包含验证代码,保证ID值的正确性,同时还能确保各种入参不会因为参数顺序变化而出bug。具体可以参考我的Domain Primitive文章。

针对于“无副作用”的外部依赖,通过方法入参的方式传入。比如上文中的equip(Weapon,EquipmentService)方法。

如果方法对外部依赖有副作用,不能通过方法入参的方式,只能通过Domain Service解决,见下文。

6)任何实体的行为只能直接影响到本实体(和其子实体)

这个原则更多是一个确保代码可读性、可理解的原则,即任何实体的行为不能有“直接”的”副作用“,即直接修改其他的实体类。这么做的好处是代码读下来不会产生意外。

另一个遵守的原因是可以降低未知的变更的风险。在一个系统里一个实体对象的所有变更操作应该都是预期内的,如果一个实体能随意被外部直接修改的话,会增加代码bug的风险。

2.领域服务

在上文讲到,领域服务其实也分很多种,在这里根据上文总结出来三种常见的:

1)单对象策略型

这种领域对象主要面向的是单个实体对象的变更,但涉及到多个领域对象或外部依赖的一些规则。在上文中,EquipmentService即为此类:

变更的对象是Player的参数

读取的是Player和Weapon的数据,可能还包括从外部读取一些数据

在这种类型下,实体应该通过方法入参的方式传入这种领域服务,然后通过Double Dispatch来反转调用领域服务的方法,比如:

Player.equip(Weapon, EquipmentService) {
     
    EquipmentService.canEquip(this, Weapon);
}

为什么这种情况下不能先调用领域服务,再调用实体对象的方法,从而减少实体对领域服务的入参型依赖呢?比如,下面这个方法是错误的:

boolean canEquip = EquipmentService.canEquip(Player, Weapon);
if (canEquip) {
     
    Player.equip(Weapon); // ❌,这种方法不可行,因为这个方法有不一致的可能性
}

其错误的主要原因是缺少了领域服务入参会导致方法有可能产生不一致的情况。

2)跨对象事务型

当一个行为会直接修改多个实体时,不能再通过单一实体的方法作处理,而必须直接使用领域服务的方法来做操作。在这里,领域服务更多的起到了跨对象事务的作用,确保多个实体的变更之间是有一致性的。

在上文里,虽然以下的代码虽然可以跑到通,但是是不建议的:

public class Player {
     
    void attack(Monster, CombatService) {
     
        CombatService.performAttack(this, Monster); // ❌,不要这么写,会导致副作用
    }
}

而我们真实调用应该直接调用CombatService的方法:

public void test() {
     
    //...
    combatService.performAttack(mage, orc);
}

Player.attack会直接影响到Monster,但这个调用Monster又没有感知。

3)通用组件型

这种类型的领域服务更像ECS里的System,提供了组件化的行为,但本身又不直接绑死在一种实体类上。具体案例可以参考上文中的MovementSystem实现。

3.策略对象

Policy或者Strategy设计模式是一个通用的设计模式,但是在DDD架构中会经常出现,其核心就是封装领域规则。

一个Policy是一个无状态的单例对象,通常需要至少2个方法:canApply 和 一个业务方法。其中,canApply方法用来判断一个Policy是否适用于当前的上下文,如果适用则调用方会去触发业务方法。通常,为了降低一个Policy的可测试性和复杂度,Policy不应该直接操作对象,而是通过返回计算后的值,在Domain Service里对对象进行操作。

在上文案例里,DamagePolicy只负责计算应该受到的伤害,而不是直接对Monster造成伤害。这样除了可测试外,还为未来的多Policy叠加计算做了准备。

除了本文里静态注入多个Policy以及手动排优先级之外,在日常开发中经常能见到通过Java的SPI机制或类SPI机制注册Policy,以及通过不同的Priority方案对Policy进行排序,在这里就不作太多的展开了。

六,领域事件

一般的副作用发生在核心领域模型状态变更后,同步或者异步对另一个对象的影响或行为。在这个案例里,我们可以增加一个副作用规则:

  • 当Monster的生命值降为0后,给Player奖励经验值

这种问题有很多种解法,比如直接把副作用写在CombatService里:

public class CombatService {
     
    public void performAttack(Player player, Monster monster) {
     
        // ...
        monster.takeDamage(damage);
        if (!monster.isAlive()) {
     
            player.receiveExp(10); // 收到经验
        }
    }
}

但是这样写的问题是:很快CombatService的代码就会变得很复杂,比如我们再加一个副作用:

  • 当Player的exp达到100时,升一级

这时我们的代码就会变成:

public class CombatService {
     
    public void performAttack(Player player, Monster monster) {
     
        // ...
        monster.takeDamage(damage);
        if (!monster.isAlive()) {
     
            player.receiveExp(10); // 收到经验
            if (player.canLevelUp()) {
     
                player.levelUp(); // 升级
            }
        }
    }
}

如果再加上“升级后奖励XXX”呢?“更新XXX排行”呢?依此类推,后续这种代码将无法维护。所以我们需要介绍一下领域层最后一个概念:领域事件(Domain Event)。

1.领域事件介绍

领域事件是一个在领域里发生了某些事后,希望领域里其他对象能够感知到的通知机制。在上面的案例里,代码之所以会越来越复杂,其根本的原因是反应代码(比如升级)直接和上面的事件触发条件(比如收到经验)直接耦合,而且这种耦合性是隐性的。领域事件的好处就是将这种隐性的副作用“显性化”,通过一个显性的事件,将事件触发和事件处理解耦,最终起到代码更清晰、扩展性更好的目的。

所以,领域事件是在DDD里,比较推荐使用的跨实体“副作用”传播机制。

2.领域事件实现

和消息队列中间件不同的是,领域事件通常是立即执行的、在同一个进程内、可能是同步或异步。我们可以通过一个EventBus来实现进程内的通知机制,简单实现如下:

// 实现者:瑜进 2019/11/28
public class EventBus {
     
 
 
    // 注册器
    @Getter
    private final EventRegistry invokerRegistry = new EventRegistry(this);
 
 
    // 事件分发器
    private final EventDispatcher dispatcher = new EventDispatcher(ExecutorFactory.getDirectExecutor());
 
 
    // 异步事件分发器
    private final EventDispatcher asyncDispatcher = new EventDispatcher(ExecutorFactory.getThreadPoolExecutor());
 
 
    // 事件分发
    public boolean dispatch(Event event) {
     
        return dispatch(event, dispatcher);
    }
 
 
    // 异步事件分发
    public boolean dispatchAsync(Event event) {
     
        return dispatch(event, asyncDispatcher);
    }
 
 
    // 内部事件分发
    private boolean dispatch(Event event, EventDispatcher dispatcher) {
     
        checkEvent(event);
        // 1.获取事件数组
        Set<Invoker> invokers = invokerRegistry.getInvokers(event);
        // 2.一个事件可以被监听N次,不关心调用结果
        dispatcher.dispatch(event, invokers);
        return true;
    }
 
 
    // 事件总线注册
    public void register(Object listener) {
     
        if (listener == null) {
     
            throw new IllegalArgumentException("listener can not be null!");
        }
        invokerRegistry.register(listener);
    }
 
 
    private void checkEvent(Event event) {
     
        if (event == null) {
     
            throw new IllegalArgumentException("event");
        }
        if (!(event instanceof Event)) {
     
            throw new IllegalArgumentException("Event type must by " + Event.class);
        }
    }
}

调用方式

public class LevelUpEvent implements Event {
     
    private Player player;
}
 
 
public class LevelUpHandler {
     
    public void handle(Player player);
}
 
 
public class Player {
     
    public void receiveExp(int value) {
     
        this.exp += value;
        if (this.exp >= 100) {
     
            LevelUpEvent event = new LevelUpEvent(this);
            EventBus.dispatch(event);
            this.exp = 0;
        }
    }
}
@Test
public void test() {
     
    EventBus.register(new LevelUpHandler());
    player.setLevel(1);
    player.receiveExp(100);
    assertThat(player.getLevel()).equals(2);
}

3.目前领域事件的缺陷和展望

从上面代码可以看出来,领域事件的很好的实施依赖EventBus、Dispatcher、Invoker这些属于框架级别的支持。同时另一个问题是因为Entity不能直接依赖外部对象,所以EventBus目前只能是一个全局的Singleton,而大家都应该知道全局Singleton对象很难被单测。这就容易导致Entity对象无法被很容易的被完整单测覆盖全。

另一种解法是侵入Entity,对每个Entity增加一个List:

public class Player {
     
  List<Event> events;
 
 
  public void receiveExp(int value) {
     
        this.exp += value;
        if (this.exp >= 100) {
     
            LevelUpEvent event = new LevelUpEvent(this);
            events.add(event); // 把event加进去
            this.exp = 0;
        }
    }
}
 
 
@Test
public void test() {
     
    EventBus.register(new LevelUpHandler());
    player.setLevel(1);
    player.receiveExp(100);
 
 
    for(Event event: player.getEvents()) {
      // 在这里显性的dispatch事件
        EventBus.dispatch(event);
    }
 
 
    assertThat(player.getLevel()).equals(2);
}

但是能看出来这种解法不但会侵入实体本身,同时也需要比较啰嗦的显性在调用方dispatch事件,也不是一个好的解决方案。

也许未来会有一个框架能让我们既不依赖全局Singleton,也不需要显性去处理事件,但目前的方案基本都有或多或少的缺陷,大家在使用中可以注意。

七,总结

在真实的业务逻辑里,我们的领域模型或多或少的都有一定的“特殊性”,如果100%的要符合DDD规范可能会比较累,所以最主要的是梳理一个对象行为的影响面,然后作出设计决策,即:

  • 是仅影响单一对象还是多个对象,

  • 规则未来的拓展性、灵活性,

  • 性能要求,

  • 副作用的处理,等等

当然,很多时候一个好的设计是多种因素的取舍,需要大家有一定的积累,真正理解每个架构背后的逻辑和优缺点。一个好的架构师不是有一个正确答案,而是能从多个方案中选出一个最平衡的方案。

你可能感兴趣的:(DDD,设计模式,java,编程语言)