Solo 架构理念和约定

本贴最后更新于 1449 天前,其中的信息可能已经事过景迁

本文是《Solo 从设计到实现》的一个章节,该系列文章将介绍 Solo 这款 Java 博客系统是如何从无到有的,希望大家能通过它对 Solo 从设计到实现有个直观地了解、能为想参与贡献的人介绍清楚项目,也希望能为给重复发明重新定义博客系统的人做个参考 ❤️

Latke 框架

之前写过,复用一下:《为什么又要造一个叫 Latke 的轮子》

数据模型

在持久层,数据模型主要指的是持久化数据库的数据定义,也就是表结构。所有数据模型都是定义在 repository.json 文件中,初始化时会根据该文件自动生成建表 SQL。

在应用层,基于 JSON 的数据模型理论上是不用定义结构的,因为 JSON 本身是 schemaless 的。但为了使用方便,我们还是定义了一些 model 类,但是这些 model 类的作用仅仅是为了归类字段,比如属于文章表的字段都放到 article 类中,包括持久化字段和易变字段

持久化字段对应的是数据库表的列,易变字段是在应用层、控制器层随时可能增减的字段。通过这样约定,避免出现模型转换,提高开发效率。

当然,你可能会问,“这还不是一样要写类么,和写一个实体 POJO 有啥区别?”区别是有的,并且这是设计理念(Philosophy)上的区别。一言以蔽之,使用 JSON 贯穿整个处理栈(请求-验证-计算-持久化)可以简化很多处理,但类型化的数据模型(POJO)会成为快速开发的阻碍。

公共约定

主键都用 oId 表示,类型是字符串 UTC 时间戳。这样设计主要是考虑到:

  1. 不使用数据库自增,避免迁移数据
  2. 保持有序,有利于数据库性能
  3. 实现简单

这也算是一个折中的方案,对于数据量不大的小型应用上已经足够。

关于配置

之前写过,复用一下:Latke 配置剖析

  • Solo

    Solo 是一款小而美的开源博客系统,专为程序员设计。Solo 有着非常活跃的社区,可将文章作为帖子推送到社区,来自社区的回帖将作为博客评论进行联动(具体细节请浏览 B3log 构思 - 分布式社区网络)。

    这是一种全新的网络社区体验,让热爱记录和分享的你不再感到孤单!

    1424 引用 • 10041 回帖 • 469 关注
  • 设计
    111 引用 • 796 回帖 • 1 关注
  • 文档
    56 引用 • 1288 回帖 • 2 关注
1 操作
88250 在 2020-03-30 20:58:05 更新了该帖

相关帖子

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...