martini备忘录

martini框架有两大核心功能：

1、注册处理函数功能

注册方法有三个：

Martini 对象设置Handler的方法：

• Use 一次设置一个 handler

• Handlers 一次设置全部 handler, 除了最后一个 Invoke 的 handler

• Action 设置的最后一个被 Invoke的 Handler(内部成员单独命名为 action ). 通常是 Router.Handle.

Martini.ServeHTTP 方法主要执行了 m.createContext(res, req).run()

Context

Martini 对象在收到 http.Request 的时候动态创建 context, 并把所有的 handlers copy 一份给 context.

所有的 handlers 在 context.run 方法中被遍历 Invoke. 当遇到 error 或者有 Written 发生终止遍历.

2、路由功能

按照注册的请求类型已经请求url内容的匹配，调用对应的处理函数

Router

Router 有自己独立的 handlers.

每一个RESTful 方法都会构建一个 Route, 通过 RESTful 方法设置 Route handlers.

NotFound 设置 notFounds handlers.

Router.Handle 在 context.run 中被最后 Invoke.

Router.Handle 遍历匹配所有的 routes, 如果匹配到一个route, 通过 context.Invoke(route.Handle) 进行调用.

如果没有匹配到 route, 动态构建 routeContext 并把 notFounds 作为其 handlers 进行 routeContext.run.

Route

route.Handle 方法动态构建 routeContext 并把 route.handlers 作为其 handlers 进行 routeContext.run.

routeContext

routeContext.run 方法遍历并 Ivoke 所有的 routeContext.handlers, 当遇到 error 或者有 Written 发生终止遍历.

ResponseWriter.beforeFuncs

ResponseWriter 是在 Martini.createContext 的时候被动态 MapTo Context了.

ResponseWriter.Before 可以添加 beforeFuncs, beforeFuncs 会在任何 Write 操作前以倒序遍历调用一次.

当然 Before 在某个handler中才能被调用到.

Context.Next

前文参见 Martini 的工作方式 中曾经简单提到, Martini 内置Handler Logger和Recovery 是如何配合 Context.Next 进行工作的. 虽然Logger和Recovery的具体功能很简单.

这非常实用. 在使用 Handler 的时候切勿忘记.

使用

通过上述分析可知

• 所有的 Martini.handlers 都会被调用, 发生 error 或 Written 终止.

• 所有匹配到的 Route.handlers 都会被调用, 发生 error 或 Written 终止.

• 所有 ResponseWriter.beforeFuncs 在 Write 时会先被倒序调用一次.

• Martini 的 Action 方法提供了机会允许使用者自己控制 Router.Handle.

• 在 Handler 中与 context.Next() 的配合.

可以用通过下列途径使用 Handler

• Martini.Use 或者 Martini.Handlers 设置 handlers.

• Router 的 RESTful(pattern string, h …Handler) 方法 设置 handlers.

• Router.NotFound 设置 notFounds.

• 在 Handler 中设置 beforeFuncs.

这些 Handlers, notFounds, beforeFuncs 形成了调用队列, Handlers 和 notFounds 有明确的终止队列条件.

参考 http://my.oschina.net/achun/blog/197546