COLA各模块理解

• COLA架构使用过程中对各模块的一些理解
• BiliBili视频：https://www.bilibili.com/video/BV1Kw4m1e7oX/

domain

• 与传统结构最大的不同，就是领域层

• 领域层的作用是让我们使用面相对象的思想去编写领域对象

  面相对象

• 初学Java时，一直在强调Java是面相对象语言

• 对象有属性和方法(行为)

  public class Dog {
    String name;
    int age;
  
    void eat() {
    }
  
    void run() {
    }
  }

  面相表格

• 工作一段时间后，感觉较面向表格更为贴切

• 从数据库获取一行数据，修改某些属性，再保存回去

  • 包含大量胶水代码，无法复用

  @Data
  public class User {
    private Long id;
    private String name;
    private Integer age;
    private String password;
  }

  public class UserService {
    @Autowired
    private UserMapper userMapper;
  
    public void changeInfo(Long id) {
        User user = userMapper.selectById(id);
        user.setName("张三");
        user.setAge(18);
        user.setPassword(getMd5("123456"));
        userMapper.updateById(user);
    }
  
    private String getMd5(String password) {
        return password + "-md5"; // 模拟
    }
  }

  领域对象

• 领域对象其实是回归面向对象的做法

• 将逻辑内聚到领域对象中

  @Data
  public class User {
    private Long id;
    private String name;
    private Integer age;
    private String password;
  
    public void changeInfo(String name, Integer age, String password) {
        this.name = name;
        this.age = age;
        this.password = getMd5(password);
    }
  
    private String getMd5(String password) {
        return password + "-md5"; // 模拟
    }
  }

• 减少胶水代码，更易复用

  public class UserService {
    @Autowired
    private UserGateway gateway;
  
    public void changeInfo(Long id) {
        User user = gateway.get(id);
        user.changeInfo("张三", 18, "12345");
        gateway.save(user);
    }
  }

  领域对象与数据对象

• 领域对象和数据对象为什么分开？为什么不合在一起，写个充血的数据对象，当做领域模型？

• 职责单一，各司其职，更利于维护

  代码实例

• 领域对象中，只需要处理好自己的逻辑

  @Data
  public class User {
    private Long id;
    private String name;
    private List<String> roles; // 权限列表
  
    public User(String name) {
        this.name = name;
        this.roles = new ArrayList<>();
    }
  
    public void addRole(String role) {
        this.roles.add(role);
    }
  }

• 在数据对象中，考虑如何存储，如"roles"可以用不同方式存储

  • json字符串
  • ","逗号隔开的字符串
  • 一对多的关联表

  // 数据对象
  @Data
  @TableName("user")
  public class UserDO {
    @TableId(type = IdType.AUTO)
    private Long id;
    private String name;
    private String rolesJson; // 转换为json字符串
  }

• 领域对象和数据对象间使用转换器执行转换

  • 可使用"MapStruce"和"FastJson"实现

  @Mapper(componentModel = MappingConstants.ComponentModel.SPRING)
  public interface UserConvertor {
  
    @Mapping(target = "rolesJson", expression = "java(map(entity.getRoles()))")
    UserDO toDataObject(User entity);
  
    @Mapping(target = "roles", expression = "java(map(dataObject.getRolesJson()))")
    User toEntity(UserDO dataObject);
  
    default String map(List<String> roles) {
        return JSON.toJSONString(roles);
    }
  
    default List<String> map(String rolesJson) {
        return JSON.parseArray(rolesJson, String.class);
    }
  }

• 当业务拓展时，Role需要增加字段做更多功能，用户表里的roles由Json变更为Role子数据表

• 这样的设计能够尽可能减少代码修改

  反例

• 如果省略领域模型，直接将数据模型写成充血模型

  • 好消息：减少代码量，减少类
  • 坏消息：不好维护，屎山代码

  @Data
  @TableName("user")
  public class UserEntity {
    @TableId(type = IdType.AUTO)
    private Long id;
    private String name;
  
    @TableField(exist = false)
    private List<String> roles; // 字段不映射数据表
  
    private String rolesJson;   // 存储字段
  
    public UserEntity(String name) {
        this.name = name;
        this.roles = new ArrayList<>();
        this.rolesJson = "[]";
    }
  
    public void addRole(String role) {
        this.roles.add(role);
        this.rolesJson = JSON.toJSONString(this.roles);
    }
  }

  client

• client层主要用于微服务架构

• 非常适合与Dubbo搭配使用

  client接口定义

• client层的api中编写服务接口

  public interface UserServiceI{
    // 略
  }

  cleint打包发布私有Maven

• pom.xml

• 设置Maven私有仓库(Nexus3)配置

    <dependencies>...略</dependencies>
    <build>...略</build>
  
    <distributionManagement>
        <repository>
            <id>maven-releases</id>
            <name>maven-releases</name>
            <url>${这里填写从nexus页面上复制的maven-releases的url}</url>
        </repository>
        <snapshotRepository>
            <id>maven-snapshots</id>
            <name>maven-snapshots</name>
            <url>${这里填写从nexus页面上复制的maven-snapshots的url}</url>
        </snapshotRepository>
    </distributionManagement>

• maven-settings.xml

• 私有仓库配置

  <?xml version="1.0" encoding="UTF-8"?>
  
  <settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd">
    <servers>
        <server>
            <id>maven-releases</id>
            <username>admin</username>
            <password>${密码}</password>
        </server>
        <server>
            <id>maven-snapshots</id>
            <username>admin</username>
            <password>${密码}</password>
        </server>
    </servers>
  </settings>

• deploy.sh
• maven打包脚本

• 使用maven的容器镜像，执行打包脚本

  # 复制maven配置文件
  cp maven-settings.xml /usr/share/maven/conf/settings.xml
  # 执行maven
  mvn deploy -pl cola-springboot-demo-client -am

  app层接口实现

• app层，编写实现类

• 注册为Dubbo服务

  @Service
  @DubboService    // 注册为Dubbo服务
  public class UserServiceImpl implements UserServiceI{
    // 略
  }

  其他微服务RPC调用

• 其他项目从私有Maven仓库中加载client的接口及入参出参

  <dependency>
    <groupId>com.xxc</groupId>
    <artifactId>cola-springboot-demo-client</artifactId>
    <version>1.0.0</version>
  </dependency>

• 在需要的地方调用，如

  • App层的Executor调用
  • infrastructure层的网关实现类中调用

  @Component
  public class XxxExe{
    @DubboReference
    private UserServiceI userService;
  
    public void execute(){
        // 略
    }
  }