Golang macaron

Macaron shi Golang 的一个Web框架
Macaron 是一个具有高生产力和模块化设计的 Go Web 框架。框架秉承了 Martini 的基本思想,并在此基础上做出高级扩展。

主要特性

  • 支持子路由的强大路由设计
  • 支持灵活多变的路由组合
  • 支持无限路由组的无限嵌套
  • 支持直接集成现有的服务
  • 支持运行时动态设置需要渲染的模板集
  • 支持对模块的轻松接入与解除
  • 采用 inject 提供的便利的依赖注入
  • 采用更好的路由层和更少的反射来提升执行速度

使用案例

Gogs:https://gogs.io/极易搭建的自助 Git 服务
Peach:https://peachdocs.org/现代 Web 文档服务器
Go Walker:https://gowalker.org/ Go 语言在线 API 文档
Switch:https://gopm.io/ Go 语言包管理
YouGam http://yougam.com/:在线论坛
Critical Stack Intel:https://intel.criticalstack.com/ A 100% free intel marketplace from Critical Stack, Inc.
齐全的中间件支持

开始使用 Macaron

在我们开始之前,必须明确的一点就是,文档不会教授您任何有关 Go 语言的基础知识。所有对 Macaron 使用的讲解均是基于您已有的知识基础上展开的。

通过执行以下命令来安装 Macaron:

go get gopkg.in/macaron.v1

并且可以在今后使用以下命令来升级 Macaron:

go get -u gopkg.in/macaron.v1

最简示例

创建一个名为 main.go 的文件,然后输入以下代码:

package main

import "gopkg.in/macaron.v1"

func main() {
    m := macaron.Classic()
    m.Get("/", func() string {
        return "Hello world!"
    })
    m.Run()
}

函数 macaron.Classic 创建并返回一个 经典 Macaron 实例。

方法 m.Get 是用于注册针对 HTTP GET 请求的路由。在本例中,我们注册了针对根路径 / 的路由,并提供了一个 处理器 函数来进行简单的处理操作,即返回内容为 Hello world! 的字符串作为响应。

您可能会问,为什么处理器函数可以返回一个字符串作为响应?这是由于 返回值 所带来的特性。换句话说,我们在本例中使用了 Macaron 中处理器的一个特殊语法来将返回值作为响应内容。

最后,我们调用 m.Run 方法来让服务器启动。在默认情况下,Macaron 实例 会监听 0.0.0.0:4000

接下来,就可以执行命令 go run main.go 运行程序。您应该在程序启动后看到一条日志信息:

[Macaron] listening on 0.0.0.0:4000 (development)

现在,打开您的浏览器然后访问 localhost:4000。您会发现,一切是如此的美好!

扩展示例

现在,让我们对 main.go 做出一些修改,以便进行更多的练习。

package main

import (
    "log"
    "net/http"

    "gopkg.in/macaron.v1"
)

func main() {
    m := macaron.Classic()
    m.Get("/", myHandler)

    log.Println("Server is running...")
    log.Println(http.ListenAndServe("0.0.0.0:4000", m))
}

func myHandler(ctx *macaron.Context) string {
    return "the request path is: " + ctx.Req.RequestURI
}

当您再次执行命令 go run main.go 运行程序的时候,您会看到屏幕上显示的内容为 the request path is: /

那么,是什么改变了事物原本的样貌?(答:爱情)

首先,我们依旧使用了 经典 Macaron 来为根路径 / 注册针对 HTTP GET 请求的路由。但我们不再使用匿名函数,而是改用名为 myHandler 的函数作为处理器。需要注意的是,注册路由时,不需要在函数名称后面加上括号,因为我们不需要在此时调用这个函数。

函数 myHandler 接受一个类型为 *macaron.Context 的参数,并返回一个字符串。您可能已经发现我们并没有告诉 Macaron 需要传递什么参数给处理器,而且当您查看 m.Get 方法的声明时会发现,Macaron 实际上将所有的处理器(macaron.Handler)都当作类型 interface{} 来处理。那么,Macaron 又是怎么知道需要传递什么参数来调用处理器并执行逻辑的呢?

这就涉及到 服务注入 的概念了, *macaron.Context 就是默认注入的服务之一,所以您可以直接使用它作为参数。如果您不明白怎么注入您自己的服务,没关系,反正还不是时候知道这些。

和之前的例子一样,我们需要让服务器监听在某个地址上。这一次,我们使用 Go 标准库的函数 http.ListenAndServe 来完成这项操作。如此一来,您便可以发现,任一 Macaron 实例 都是和标准库完全兼容的。