Install

第一个控制器是针对路由 /install/ 的.
TypePress 是一个博客系统, 绑定到某个 blog 帐户的内部 id (自增数值类型)的页面作为首页是完全可行的.
作为支持站群的博客系统, 绑定顶级域名是必要的. 这样就可以为每个用户设定独立的子域名. 当然预留一些域名也是必要的, 这可以通过配置文件进行设定.
自动建立数据库可以为安装提供很大的方便, 也需要实现.
这就是 install 必须要做的几件事了.

TypePress使用了基于gosexy/db 修改版本 achun/db

貌似 gosexy 在考虑更新些和修改版本类似的特性, 如果以后能使用gosexy的话, TypePress 会优先考虑.

此 package 支持MongoDB, MySQL, PostgreSQL 和SQLite3. 写此章的时候 TypePress 只完成了mysql.sql.

如果要更换数据库驱动, 这需要手工修改 main.go, import 对应的驱动. TypePress 把 main.go 也目录化管理, 您新建一个目录做自己的 main.go 是最佳的方式.

子路由

在 InitInstall 中您可以看到 gorilla/mux 路由强大的一面.
也许您注意到 TypePress 把很多不需要导出的函数和变量都做了首字母大写的导出处理, 对于不能大写的 init 函数添加另外的函数完成导出.
这样做完全是为了 go doc 的方便, 对于开发者来说通过 go doc 了解内部实现方法是最方便的.

您也许注意到 TypePress 采用函数的形式完成控制器, 没有用 struct 形式. 不要忘记 Go 语言之下函数是有类型的, 用函数的方法同样也是OOP的方法.

作者在和一位开发者 [北京]老田交流时, 老田说:

[北京]老田 15:03:31

很多人用go还是模拟其他语言的写法而已

[北京]老田 15:03:42

东西做出来了，但还不golang化

他的话让作者意识到 TypePress 开发中实践 golang 化的重要性.

models

models 也是纯手写代码. 设定了所有的记录级别操作完整性检查, 字段完整性调用 meta 的验证器.

models 不考虑操作权限问题, 这由控制器负责.

事实上 medels 包装了 CURD 操作, 通过CurdCond进行数据约束, 那其实就是几个 []string. 这些数据对不同的 CURD 操作约束意义是不同的.

可以预见这种方法满足不了所有的需求. 遇到新状况的时候再想办法解决吧.

meta, models, controllers 就是这样各负其责配合完成业务需求.

事件大杂烩

事件驱动或者事件模型的概念已经很普遍了, 事件机制的价值无可非议. TypePress 采用了最生硬笨拙的实现方法. 为不同的事件建立单独的全局变量, 并且采用slice, 而不是map. 分开独立的变量就是为了避开使用 map. 方法生硬但很有效. 这其实就是一组 On/Fire 作为前缀的函数. 注册事件用 OnXxxx, FireXxxx 其实已经在对应的地方写过了, 一般情况下不需要调用.

预计这种方法, 在未来也会应用到插件中去. 事实上写日志啥的就使用 OnXxxx 来注册. 原先 TypePress 好几处地方都写下了 LogDebug(...) 这样代码, 随着事件机制的完成, 那些代码都移除了. 只是在

func FireEvent(code int, r *http.Request, i ...interface{}) bool {
    for _, f := range events {
        if !f(code, r, i...) {
            return false
        }
    }
    if code != 200 && len(events) == 0 { // 这里
        LogDebug(code, r, i...)
    }
    return true
}

增加了一个 LogDebug 方便遇到错误时进行调试. 配套的 HandlerMux_ServeHTTP 中的 defer

defer func() {
    if e := recover(); e != nil {
        http.Error(wr, "500 Internal Server Error", 500)
        _, file, line, _ := runtime.Caller(4) // 这里
        FireEvent(500, r, "PanicOnHandlerRouter", file, line)
    } else {
        FireEvent(200, r, "deferHandlerRouter")
    }
}()

获取了 panic 出错的代码位置, 并传递给 FireEvent. 记录日志就可以通过 OnEvent 去注册了, 这次更新忘了实现了. 下次补上.

TypePress 的这种做法不是严格的事件模型, 更像一个大杂烩.

Ajax技巧

如果你查看 InitInstall 的代码你会发现最后一行是

w.Write([]byte("/"))

这句代码的本意是要让客户端进行 Redirect 重定向. 因为前端使用了Ajax的提交(糟糕, 应该先做个是否是Ajax的判断), 直接使用 Redirect 是不行的.

常见方法有

输出 JavaScript 脚本
输出 JSON 告诉客户端做什么

其实没有这么麻烦, 我们分析一下输出的数据情况

JSON 通常是被{},[]包裹
HTML 要求以<开头是合理的
重定向 http 或者 / 开头是最常见的
直接执行 JavaScript 代码可以用个小技巧 ; 打头, 这符合 JavaScript 语法标准
文本信息, 用于提示, 上述都不是的话,那可以当作文本信息了

好了, 你发现了,这些信息全部都有特征, 可以通过打头字符进行识别. TypePress 提供的 js 文件中使用了这些技巧.

碎碎念

完成第一个控制器的时候, 时逢 BootStrap 3.0 发布, 让作者遗憾的是:

仍然采用px作为尺度单位. pt 更符合时代发展.
网格仍然沿用float:left的方法. PureCSS 用了新的方法, 当然这需要现代浏览器支持.

可惜 PureCSS 也没有采用 pt做为单位. 为什么作者会有这样的想法, 解释起来很费劲.
作者曾写了静夜思这个框架, 目前还不完善, 作者没有足够的精力把她用于 TypePress. 以后再做吧.

第11章 Install

Install

子路由

meta

models

事件大杂烩

Ajax技巧

碎碎念