后端【免费下载链接】martiniClassy web framework for Go项目地址https://gitcode.com/gh_mirrors/ma/martini点击查看免费下载Martini 是一个面向 Go 语言的高性能 Web 应用/服务开发库它以任意函数皆可为 handler的非侵入式设计、基于反射的依赖注入和开箱即用的 Classic 模式著称被社区评价为简单到极致、又足够强大的模块化 Web 框架。本文以官方法文文档translations/README_fr_FR.md为主体脉络结合仓库源码逐一讲解从快速启动、路由匹配、服务注入到中间件编排的完整用法读完后你将能独立用 Martini 搭建可维护的 REST 服务并理解其底层执行机制。快速开始创建你的第一个 Martini 应用在动手之前请确保已经安装好 Go 并正确配置了GOPATH环境变量。Martini 要求Go 1.1 或更高版本。创建一个.go文件这里命名为server.go内容如下package main import github.com/go-martini/martini func main() { m : martini.Classic() m.Get(/, func() string { return Hello world! }) m.Run() }这段代码做了三件事用martini.Classic()创建一个带默认配置的 Martini 实例通过m.Get(/, ...)注册一个 GET/路由调用m.Run()启动 HTTP 服务。接着安装 Martini 包并运行服务go get github.com/go-martini/martinigo run server.go此时你的浏览器访问localhost:3000即可看到 Hello world!。Martini 已经跑起来了。从源码角度看一下m.Run()究竟做了什么在 martini.go 中Run()先读取环境变量PORT为空时默认使用3000再读取HOST环境变量最终拼成host:port交给RunOnAddr。也就是说不设置任何环境变量时服务默认监听localhost:3000。Classic Martini开箱即用的默认配置为了让你尽快上手martini.Classic()预置了一组足以覆盖大多数 Web 应用需求的默认配置m : martini.Classic() // ... 在这里插入中间件与路由 ... m.Run()查看 martini.go 中Classic()的实现可以发现它实际上自动装配了以下四个核心组件请求/响应日志—— martini.Logger记录每条请求的开始与完成时间、耗时panic 恢复—— martini.Recovery捕获 handler 中抛出的 panic按环境返回 500 或调试信息静态文件服务—— martini.Static自动服务public目录下的静态资源路由分发—— martini.Router作为最后一个 action handler 处理路由匹配。Classic()还做了一件容易被忽略的事它把路由实例通过m.MapTo(r, (*Routes)(nil))映射为Routes服务并把r.Handle设置为最终 action。如果你想要完全掌控中间件栈可以使用martini.New()创建裸实例它只预置了 logger 和默认的ReturnHandler服务martini.go。HandlersMartini 的核心与灵魂在 Martini 中任意可调用函数都可以作为 handler这是整个框架最核心的设计理念m.Get(/, func() { println(hello world) })返回值处理如果 handler 返回一个值Martini 会把它以字符串形式写入当前的http.ResponseWriterm.Get(/, func() string { return hello world // HTTP 200 : hello world })你还可以选择性地返回 HTTP 状态码m.Get(/, func() (int, string) { return 418, im a teapot // HTTP 418 : im a teapot })返回值到底是如何变成 HTTP 响应的关键在于 return_handler.go 中注册的默认ReturnHandler当 handler 返回(int, string)这类多值时它先通过res.WriteHeader(int(vals[0].Int()))写入状态码再把第二个返回值作为响应体如果返回值是[]byte则直接写入字节否则先解引用指针/接口再转成字符串写入。这解释了为什么 Martini 能容忍 handler 返回任意类型。服务注入Handler 是通过反射被调用的Martini 利用依赖注入解析 handler 参数列表中的依赖只要给 handler 添加参数Martini 就会遍历已注册的服务列表按类型断言为其注入实例。这一点保证了 Martini与 Go 标准库的http.HandlerFunc接口完全兼容m.Get(/, func(res http.ResponseWriter, req *http.Request) { // res 和 req 由 Martini 注入 res.WriteHeader(200) // HTTP 200 })每次请求到达时martini.go 中的createContext会新建一个请求上下文它继承全局Injector把当前请求的http.Request、包装过的ResponseWriter以及Context自身都映射为服务随后依次调用每个 handler。正因为依赖被逐个解析任何遵循标准接口的 Go 包都能无缝嵌入 Martini。martini.Classic()内置的服务包括log.Logger—— Martini 全局日志器martini.Context—— 当前 HTTP 请求上下文martini.Params——map[string]string存放路由匹配出的命名参数martini.Routes—— 路由辅助服务http.ResponseWriter—— HTTP 响应写入接口*http.Request—— 当前 HTTP 请求。路由路径匹配与 HTTP 方法在 Martini 中一条路由 一个 HTTP 方法 一个 URL 匹配模式。每个路由可以挂载一个或多个 handlerm.Get(/, func() { // 展示内容 }) m.Patch(/, func() { // 更新内容 }) m.Post(/, func() { // 创建内容 }) m.Put(/, func() { // 替换内容 }) m.Delete(/, func() { // 删除内容 }) m.Options(/, func() { // 处理 http options }) m.NotFound(func() { // 处理 404 })路由按定义顺序依次匹配第一个命中的路由 handler 会被调用。除上述方法外从 router.go 的Router接口可以看到还支持Head、Any匹配任意方法和通用的AddRoute(method, pattern, ...)。命名参数路由模式可以包含命名参数通过martini.Params服务访问m.Get(/hello/:name, func(params martini.Params) string { return Hello params[name] })Glob 通配路由模式也支持 glob 通配符m.Get(/hello/**, func(params martini.Params) string { return Hello params[_1] })正则表达式更复杂的场景可以直接使用正则表达式m.Get(/hello/(?Pname[a-zA-Z]), func(params martini.Params) string { return fmt.Sprintf(Hello %s, params[name]) })关于正则语法可以参考 Go 官方regexp/syntax文档。从实现上看router.go 的newRoute会把:name转换为命名捕获组(?Pname[^/#?])把**转换为(?P_1[^#?]*)并在模式末尾自动追加\/?以容忍结尾斜杠。堆叠 Handler多个 handler 可以在一条路由上叠加非常适合鉴权这类前置逻辑m.Get(/secret, authorize, func() { // 只要 authorize 没有写入响应这里的代码就会执行 })注意 router.go 中routeContext.run()的执行规则handler 依次执行一旦某个 handler 写入了响应Written()返回 true执行链立即终止后续 handler 不再调用。路由组使用Group方法可以为一组相关路由统一添加前缀m.Group(/books, func(r martini.Router) { r.Get(/:id, GetBooks) r.Post(/new, NewBook) r.Put(/update/:id, UpdateBook) r.Delete(/delete/:id, DeleteBook) })既然能给单个 handler 传中间件自然也能给路由组传中间件m.Group(/books, func(r martini.Router) { r.Get(/:id, GetBooks) r.Post(/new, NewBook) r.Put(/update/:id, UpdateBook) r.Delete(/delete/:id, DeleteBook) }, MyMiddleware1, MyMiddleware2)从 router.go 可以看到Group的实现是把组前缀与组中间件暂存到栈中组内注册的路由在addRoute时自动拼接前缀、前置中间件从而让组内所有路由共享同一套前置逻辑。服务依赖注入的三种映射方式服务是可注入到 handler 参数列表中的对象既可以在全局级别映射也可以在请求级别映射。全局映射Global MappingMartini 实例实现了inject.Injector接口因此全局映射非常简单db : MyDatabase{} m : martini.Classic() m.Map(db) // 该服务对后续所有 handler 以 *MyDatabase 形式可用 // ... m.Run()请求级映射Request-Level Mapping请求级映射需要借助martini.Context在 handler 中完成func MyCustomLoggerHandler(c martini.Context, req *http.Request) { logger : MyCustomLogger{req} c.Map(logger) // 以 *MyCustomLogger 映射 }由于每个请求都会创建独立的上下文继承全局 Injector请求级映射天然做到一次请求一套服务互不污染。将值映射到接口服务最强大的特性之一是可以把实现映射到接口。例如你想用一个包装对象覆盖http.ResponseWriter、为其扩展额外功能可以这样写func WrapResponseWriter(res http.ResponseWriter, c martini.Context) { rw : NewSpecialResponseWriter(res) c.MapTo(rw, (*http.ResponseWriter)(nil)) // 用包装后的 ResponseWriter 覆盖原接口 }MapTo(value, (*Interface)(nil))是依赖注入库inject的标准用法它明确声明我要按这个接口类型注册服务之后任何以该接口为参数类型的 handler 都会拿到这个实现。静态文件服务martini.Classic()实例会自动服务服务器根目录下public文件夹中的静态文件。你也可以通过追加martini.Statichandler 服务更多目录m.Use(martini.Static(assets)) // 同时服务 assets 目录martini.Static支持通过StaticOptions精细化配置见 static.goPrefix—— 静态目录的可选 URL 前缀如/static实现时会自动规范化首尾斜杠SkipLogging—— 关闭静态文件的日志输出IndexFile—— 目录访问时默认加载的文件默认值为index.htmlExpires—— 自定义函数用于生成Expires响应头以利用浏览器缓存Fallback—— 请求资源不存在时兜底提供的默认 URLExclude—— 该前缀开头的 URL 一律不进入静态处理。基于Fallback与Exclude还能实现默认文档服务当请求的 URL 既匹配不到任何本地文件、也不以某个前缀如/api/v开头时统一回退到/index.html——这对同时提供静态页面和 REST API、以及托管 AngularJS 等 SPAHTML5 模式非常有用static : martini.Static(assets, martini.StaticOptions{Fallback: /index.html, Exclude: /api/v}) m.NotFound(static, http.NotFound)从 static.go 的实现看静态中间件只处理GET/HEAD请求访问目录时若缺少结尾斜杠会自动 302 重定向补上最终通过http.ServeContent输出文件并带上修改时间与Expires头。中间件 Handlers中间件 handler 位于进入的 HTTP 请求与路由器之间本质上与 Martini 中其他 handler 没有任何区别。添加中间件只需m.Use(func() { // 做点中间件该做的事 })如果想完全掌控中间件栈可以用Handlers函数——它会整体替换此前设置的所有 handlerm.Handlers( Middleware1, Middleware2, Middleware3, )中间件非常适合日志、鉴权、会话、gzip 压缩、错误页等需要在每次请求前后统一执行的操作。例如校验 API Key// 校验 api key m.Use(func(res http.ResponseWriter, req *http.Request) { if req.Header.Get(X-API-KEY) ! secret123 { res.WriteHeader(http.StatusUnauthorized) } })由于Use是顺序追加、执行也是顺序进行见 martini.go 中context.run()的循环这个中间件会在后续所有 handler 之前运行一旦它写入了 401 响应请求链立即短路。Next()在请求之后继续Context.Next()是中间件 handler 可选的调用函数调用它意味着让出控制权等待其余 handler 全部执行完毕。这对于需要在请求之后收尾的操作非常合适// 在请求前后各记一条日志 m.Use(func(c martini.Context, log *log.Logger){ log.Println(avant la requête) c.Next() log.Println(après la requête) })执行原理很简单martini.go 中Next()只是把上下文索引index加一然后继续run()剩余的 handler 链待链上所有 handler 返回后再回到Next()之后的代码。内置的 Logger 和 Recovery 中间件正是利用这一机制分别实现记录请求开始→其余 handler 执行→记录完成耗时和整个链内 panic 的兜底恢复。Martini Env区分开发与生产环境若干 Martini handler 会读取全局变量martini.Env以提供开发环境与生产环境不同的行为。官方建议在生产环境部署时务必设置环境变量MARTINI_ENVproduction。从 env.go 的源码可以看到框架定义了三个环境常量development、production、test其中Env默认值为Devdevelopment并在包初始化时读取MARTINI_ENV环境变量完成覆盖。同时env.go还通过os.Getwd()把Root记录为进程工作目录——这正是Static(public)等相对目录最终解析为绝对路径的依据见 static.go。环境变量最直观的影响体现在Recovery中间件上recovery.go开发模式下发生 panic 会返回一个包含堆栈信息的 HTML 调试页面方便排查而生产模式下只返回500 Internal Server Error避免泄露内部细节。仓库中的 recovery_test.go 和 env_test.go 也分别用setENV(Dev)对两种分支进行了验证。FAQ实战高频问题去哪里找中间件首选 martini-contrib 组织下的中间件仓库如果找不到所需功能也可以联系该组织成员贡献新仓库。社区常见中间件及其用途包括auth—— 身份认证 handlersbinding—— 将原始请求映射/校验到结构体gzip—— 为请求/响应添加 gzip 压缩render—— 提供轻松渲染 JSON 与 HTML 模板的服务acceptlang—— 解析Accept-LanguageHTTP 头sessions—— 提供 Session 服务strip—— URL 前缀剥离method—— 通过 Header 或表单字段覆盖 HTTP 方法secure—— 快速实现若干安全加固encoder—— 多格式数据渲染与内容协商的编码服务cors—— 启用 CORS 支持oauth2—— 提供 OAuth 2.0 登录支持 Google Sign-in、Facebook Connect、GitHub 登录vauth—— 供方 webhook 认证 handlers目前支持 GitHub 与 TravisCI。如何与既有服务器集成Martini 实例实现了http.Handler接口因此可以轻松地挂载到现有 Go 服务器的子路径上。以下是运行在 Google App Engine 上的完整示例package hello import ( net/http github.com/go-martini/martini ) func init() { m : martini.Classic() m.Get(/, func() string { return Hello world! }) http.Handle(/, m) }其中http.Handle(/, m)正是把整个 Martini 实例当作标准http.Handler交给标准库复用——这也是ServeHTTP方法存在的意义martini.go。如何修改端口与地址Run函数会优先读取PORT与HOST环境变量找不到时默认使用localhost:3000。若需要对端口与地址做更灵活的控制请改用martini.RunOnAddrm : martini.Classic() // ... log.Fatal(m.RunOnAddr(:8080))RunOnAddr 会打印一行形如listening on :8080 (development)的日志再调用http.ListenAndServe正式对外提供监听。支持代码热重载吗支持。gin和fresh这两个工具都可以在 Martini 应用代码发生改动时自动重启服务非常适合开发期迭代。深入阅读仓库脉络一览本文的代码示例与源码引用均来自当前仓库继续深入研究可以按以下脉络阅读martini.go —— 框架主体Classic()/New()的装配、Run/RunOnAddr、ServeHTTP、Use/Handlers、请求上下文执行循环router.go —— 路由层HTTP 方法注册、:name/**/正则模式的编译、路由组、Params/Routes服务return_handler.go —— 返回值到 HTTP 响应的转换逻辑static.go —— 静态文件中间件与StaticOptions全部配置项logger.go 与 recovery.go —— 内置的请求日志与 panic 恢复中间件response_writer.go —— 包装标准ResponseWriter提供Status/Size/Written/Before等增强能力env.go ——MARTINI_ENV环境变量与Dev/Prod/Test常量martini_test.go、router_test.go、static_test.go 等测试文件 —— 各模块行为的可执行验证用例。Martini 的设计灵感来自 Node.js 的express与 Ruby 的sinatra追求小而干净的哲学核心保持精简丰富的扩展能力全部沉淀在中间件生态中。掌握本文的路由、注入与中间件三大主线你就能用极少的样板代码搭建出结构清晰、易于扩展的 Go Web 服务。赞分享后端【免费下载链接】martiniClassy web framework for Go项目地址https://gitcode.com/gh_mirrors/ma/martini点击查看免费下载相关推荐Martini 框架实战指南用 Go 快速构建模块化 Web 应用与路由服务Martini 框架实战指南用 Go 快速构建模块化 Web 应用与路由服务 Martini 是一个面向 Go 语言的 Web 框架包致力于让开发者以极简代后端Martini 实战指南用 Go 快速构建模块化 Web 应用的经典微框架Martini 实战指南用 Go 快速构建模块化 Web 应用的经典微框架 本文以当前仓库 README.md https://link.gitcode.co后端SuperBottomSheet让Android底部弹窗焕发新生的终极解决方案SuperBottomSheet让Android底部弹窗焕发新生的终极解决方案 SuperBottomSheet是一款为Android应用打造的增强型底部弹窗上一篇告别格式烦恼重庆大学LaTeX毕业论文模板完全指南下一篇哔咔漫画下载器完整指南3分钟打造个人离线漫画库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考