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

AntonydasWang · 2015-12-29 11:37:53 · 3498 次点击 · 大约8小时之前 开始浏览    置顶
这是一个创建于 2015-12-29 11:37:53 的主题,其中的信息可能已经有所发展或是发生改变。

我觉得 看书 -> 练习 -> 看源码 -> 实现 ,是一个可行的螺旋式学习节奏。

当我看一本书并且跟着书上的实例走完一遍后,发现自己的好像没什么可学的了,这时候我一般会先看看书上的东西我是否能全部举一反三,然后会计划看源码,应为看开源库可以让我们犹如有一个高手老师和朋友,而且还能感受相当丰富的实战技巧。

由于 Golang 足够简洁,所以有很多小而精悍的开源库,其实就一两个文件啦。但是对于初学者来说相当受用。

最重要的心态:看 Golang 代码基本不有太大的心智负担,所以,不、要、怕。

步骤概括如下:

  1. 拿到源码
  2. 看文档,确定需求,确定项目对外接口
  3. 小步迭代 TTD参考源码,考虑:测试,算法,安全
  4. 对照源码,优化自己代码,甚至超过源码
  5. 码代码以外:注释,README, License

今天的练习项目是 gorilla/context

准备

  1. 拿到源码 go get github.com/gorilla/context

  2. 看文档 go doc github.com/gorilla/context

    1. 项目需求:在一个 request 的处理期间,保存一些值。
    2. 基本用法和项目对外接口(界限):
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. 实现 参考代码
V2: 实现 Delete(), Clear(), ClearHandler()
  1. ClearHandler() 利用 http.HandlerFunc() + defer
  2. 写测试,实现 参考源码
V3: 实现 Purge()
  1. 看文档 go doc github.com/gorilla/context.Purge 涉及到数据存储的时间,所以需要一个数据结构存储时间, map[*http.Request]int64
  2. 写测试,实现 Purge() 参考源码
V4: 使用 RWMutex 保证数据可靠性 参考源码

​对照源码

  1. 不足:

    1. 缺少 benchmark
  2. 比源码好地方:

    1. 测试虽多写了几行,但是测试结果更直观
    2. 使用 defer 增加代码可读性
    3. 简化 Get() GetAll() 逻辑
  3. V5: 添加 benchmark 参考代码

完善项目

  1. doc.go
  2. README.md
  3. LICENSE
  4. .travis.yml

总结

虽然这个开源库的源码只有 100 左右,但是需求很明确,代码干净,考虑的比较全面,除了核心代码,有比较完备的测试,文档,持续集成,让我们动手实现的过程中不仅在实践中加深对基本语法的理解,体会到 Golang 开发的迭代思路,并且认识到编码只是软件工程的一部分,测试、文档、规范化也很种重要。

联想到平时的开发,花时间最多的往往不是 最终 代码的编写,而是 小修小改 + 推倒重来。再看看我们这次的开发过程,基本没有走弯路,原因很简单,我们是由结果倒退的解决思路,当然,在日常开发中,不可能每次都能将一个库的最终接口先准确地设计出来,但是,我们可看到前期设计的重要性。


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

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

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