[Golang] apifaker 开发记

最近在准备毕业设计，虽然为 Android 项目，但还是需要一些后端支持，所以我就想能不能有一种方便的方式开发后端 api 的方式。

在之前 Rails 开发中，养成的了“急躁”的好习惯，转到 Go 后，明显感觉思维的转变，Go 的思维方式相对 Rails 来说，更注重正交性，清晰度，KISS。

所以开发之前，我明确了这个项目的定位：

1. 能快速开启一个符合 Restful 原则的 api 服务器。
2. 实现 http.Helper 接口，能组合别的路由，保证扩展性。
3. 用 json 文件，不用数据库，降低复杂度，能回写到文件，保证数据一致性。
4. 能实现简单的数据验证。

然后，决定了主要的 struct ApiFaker 的主要成员变量及其对外接口：

type ApiFaker struct {
     // 匿名组合，使用 Engine 的路由
    *gin.Engine

     // json api 文件目录
    ApiDir string

    // 内部路由
    Routers []*Router

    // 外部路由
    TrueMux http.Handler

    // 内部路由的前缀
    Prefix string
}

// 创建新的 ApiFaker
func NewWithApiDir(dir string) (*ApiFaker, error)

// 设置 ApiFaker 前缀并组合其外部路由
func (af *ApiFaker) MountTo(path string, handler http.Handler)

// 将运行事的数据回写到 json 文件中
func (af *ApiFaker) SaveToFile()

// 实现 http.Handler 接口
func (af *ApiFaker) ServeHTTP(rw http.ResponseWriter, req *http.Request)

这一步，非常重要，因为它关系到整个项目的走向，正所谓，选择比努力重要。然而，大部分项目都不能在一开始就确定所有变量和方法，然后不再改变，所以我们的设计标准就是KISS，从最核心的功能出发，逐步迭代。

接下来要设计的就是 Router 及其包含的最复杂的 Model:

1. 一个 Rouer 应该包含一个资源，可等同于数据库中的 table, 及其一系列 restful 的 path。
2. 资源对应的就是 Model，它应该：
   1. 记录资源的每一个 table 的 column
   2. 基本的 CRUD
   3. 由于还要回写到 json 文件，所以应该有一个标示记录数据是否改变
   4. 需要对应 json 文件的结构，和运行时数据的容器

type Router struct {
    Model  *Model
    Routes []Route
    filePath string
}

type Model struct {
    Name string
    Seeds   []map[string]interface{}
    Columns []*Column                
    Set *gset.SetThreadSafe
    dataChanged bool
    sync.Mutex
}

这里用到的我之前的实现的一个集合 gset

到这里，我们已经设计好项目的边界，和主要的数据结构，当然还有一些细节没有设计，比如，Route 和 Colmun 还有运行时的数据管理。 然而只要方向确定，内部不断迭代，一定能到达一个稳定的水平。

由于我 Go 开发经验和设计能力有限，还请高手可以指点。

源码：github.com/Focinfi/apifaker

服务器设计文章：许式伟：服务端开发那些事儿