Golang 学习 -- “听写” gorilla/context

AntonydasWang · · 3327 次点击 · 开始浏览    置顶
这是一个创建于 的主题,其中的信息可能已经有所发展或是发生改变。

我觉得 看书 -> 练习 -> 看源码 -> 实现 ,是一个可行的螺旋式学习节奏。 当我看一本书并且跟着书上的实例走完一遍后,发现自己的好像没什么可学的了,这时候我一般会先看看书上的东西我是否能全部举一反三,然后会计划看源码,应为看开源库可以让我们犹如有一个高手老师和朋友,而且还能感受相当丰富的实战技巧。 由于 Golang 足够简洁,所以有很多小而精悍的开源库,其实就一两个文件啦。但是对于初学者来说相当受用。 最重要的心态:看 Golang 代码基本不有太大的心智负担,所以,不、要、怕。 步骤概括如下: 1. 拿到源码 2. 看文档,确定需求,确定项目对外接口 3. 小步迭代 TTD参考源码,考虑:测试,算法,安全 4. 对照源码,优化自己代码,甚至超过源码 5. 码代码以外:注释,README, License 今天的练习项目是 [gorilla/context](https://github.com/gorilla/context) #### 准备 1. 拿到源码 `go get github.com/gorilla/context` 2. 看文档 `go doc github.com/gorilla/context` 1. 项目需求:在一个 request 的处理期间,保存一些值。 2. 基本用法和项目对外接口(界限): ``` go package foo import ( "github.com/gorilla/context" ) // 1.定义要保存值的名字(key interface{}) type key int const MyKey key = 0 // 2.设置和获取值 context.Set(r, MyKey, "bar") func MyHandler(w http.ResponseWriter, r *http.Request) { // val is "bar". val := context.Get(r, foo.MyKey) // returns ("bar", true) val, ok := context.GetOk(r, foo.MyKey) // ... } // 3.清除缓存 context.Clear(r) // clear all caches of one request context.ClearHanlder() // wrap a handler to clear varaibles at end of a request lifetime // 4. 对外接口 func Clear(r *http.Request) func ClearHandler(h http.Handler) http.Handler func Delete(r *http.Request, key interface{}) func Get(r *http.Request, key interface{}) interface{} func GetAll(r *http.Request) map[interface{}]interface{} func GetAllOk(r *http.Request) (map[interface{}]interface{}, bool) func GetOk(r *http.Request, key interface{}) (interface{}, bool) func Purge(maxAge int) int func Set(r *http.Request, key, val interface{}) ``` #### 小步迭代开发 ----- ###### V1: 实现 Set(), Get(), GetOk(), GetAll(), GetAllOk() 1. 设计数据结构存储数据:`map[*http.Request]map[interface{}]interface{}` 2. 写测试 3. 实现 [参考代码](https://github.com/Focinfi/context/commit/10e84279d3843802a70a7d0e97a4dd6cd95ae3dc) ​ ###### V2: 实现 Delete(), Clear(), ClearHandler() 1. ClearHandler() 利用 http.HandlerFunc() + defer 2. 写测试,实现 [参考源码](https://github.com/Focinfi/context/commit/8815e040a99d6b4fa64f0be2419ced61764c63f6) ###### V3: 实现 Purge() 1. 看文档 `go doc github.com/gorilla/context.Purge` 涉及到数据存储的时间,所以需要一个数据结构存储时间, `map[*http.Request]int64` 2. 写测试,实现 Purge() [参考源码](https://github.com/Focinfi/context/commit/aa3f92612ac6f31b201bcda93897d339d4edf3e6) ​ ###### V4: 使用 RWMutex 保证数据可靠性 [参考源码](https://github.com/Focinfi/context/commit/d58da37ad6005b59c165468aeee650203e44c5f0) --- #### ​对照源码 1. 不足: 1. 缺少 benchmark 2. 比源码好地方: 1. 测试虽多写了几行,但是测试结果更直观 2. 使用 defer 增加代码可读性 3. 简化 Get() GetAll() 逻辑 3. V5: 添加 benchmark [参考代码](https://github.com/Focinfi/context/commit/ac52f5468b28d3b490ef63b11727957ca9814ca5) #### 完善项目 1. doc.go 2. README.md 3. LICENSE 4. .travis.yml #### 总结 虽然这个开源库的源码只有 100 左右,但是需求很明确,代码干净,考虑的比较全面,除了核心代码,有比较完备的测试,文档,持续集成,让我们动手实现的过程中不仅在实践中加深对基本语法的理解,体会到 Golang 开发的迭代思路,并且认识到编码只是软件工程的一部分,测试、文档、规范化也很种重要。 联想到平时的开发,花时间最多的往往不是 最终 代码的编写,而是 小修小改 + 推倒重来。再看看我们这次的开发过程,基本没有走弯路,原因很简单,我们是由结果倒退的解决思路,当然,在日常开发中,不可能每次都能将一个库的最终接口先准确地设计出来,但是,我们可看到前期设计的重要性。

有疑问加站长微信联系(非本文作者)

入群交流(和以上内容无关):加入Go大咖交流群,或添加微信:liuxiaoyan-s 备注:入群;或加QQ群:692541889

3327 次点击  
加入收藏 微博
暂无回复
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传