beego

最近项目用到beego,花了半天结合官方文档写了几个demo看懂了套路，对于我这个没有什么web开发经验的也很容易上手。

1 路由

1 restful 风格

beego.Post("/test",controllers.Test)
beego.Get("/home",func(ctx* context.Context){
		ctx.Output.Body([]byte("hello beego "))
})

这种类似于c里面注册一个回调函数，http get/post method时就执行相应注册函数。

beego.Router("/main", &controllers.MainController{})

这种类似于c++里面注册一个子类，子类实现Get 、Post 、Put、Delete 接口。但是这里get请求对应Get方法，post请求对应Post方法,为了更加灵活，于是有自定义路由函数

	beego.Router("/main", &controllers.MainController{},"get:Main")

beego.Router通过第三个参数指定http method执行 控制器中相关方法。

2 任意路由

	beego.Any("/handler",controllers.Handler)

接口：func Any(rootpath string, f FilterFunc) ,只要匹配到rootpath,不管http 什么method，都匹配 f 注册函数,更加灵活通用。

3 自动匹配路由

//router.go 中路由控制器注册 
	beego.AutoRouter(&controllers.UserController{})

// 控制器UserController 中方法
func (c *UserController) Login() {
	c.Ctx.Output.Body([]byte("login success"))
}

func (c *UserController) Logout() {
	c.Ctx.Output.Body([]byte("logout success"))
}

对于类似 /user/login /user/logout 请求就能执行控制器中相关方法。相比restful 控制器中Get Post风格，这种路由中的url直接对应控制器中的方法更直接明了。

4 命名空间

	ns:=beego.NewNamespace("/api",
		beego.NSNamespace("/user",
			beego.NSRouter("/login",&controllers.UserController{},"*:Login"),
			beego.NSRouter("/logout",&controllers.UserController{},"*:Logout"),
		),
		 beego.NSNamespace("/topic",
		 	beego.NSBefore(controllers.Auth),
            beego.NSRouter("/create", &controllers.TopicController{}),
            beego.NSRouter("/delete", &controllers.TopicController{}),
               
        ),
	)
	beego.AddNamespace(ns)

命名空间可以将同一类路由置于相同空间下,比如这里第一级namespaec是api ,第二级是user和topic,
beego.NSBefore 在访问api其他namespaec时都会先执行这里的注册函数，比如在访问其他接口前可以做一些登录认证校验。

5 注解路由
这种路由书写起来有些复杂，前面路由完全够用，不过是一种语法糖。

//router.go 中包含控制器
beego.Include(&controllers.NoteController{})

//控制器
type NoteController struct{
	beego.Controller
}
func (c *NoteController) URLMapping() {
	c.Mapping("Note", c.Note)
}

// @router /note  [get]
func (c* NoteController)Note(){
	c.Ctx.WriteString("note")
}

看这里注解方式 @routet + 路由（/note）+method(get) 等同
beego.Router("/note ", &controllers.NoteController {}, “get:Note”),明显这种方式更简单。

2 session控制

在使用session 前 配置文件中需要设置sessionon = true，在登录接口保存session

func (c *UserController) Login() {
	id:=c.GetString(":id")
	v := c.GetSession("userId")
	if v == nil {
		logs.Info("nil")
		c.SetSession("userId", id)
		c.TplName = "index.tpl"
	} else {
		c.Ctx.WriteString("login success")
	}
}

于是结合前面路由beego.NSBefore(controllers.Auth),每次访问topic时都可以检测用户session是否存在,如果不存在，可以要求用户登录。

	func Auth(ctx* context.Context){
	val, ok := ctx.Input.Session("userId").(string)
	logs.Info(ok,val)
	if !ok && ctx.Request.RequestURI != "/api/user/login" {
		logs.Info("redirect")
		ctx.Redirect(302, "/api/user/login")
	}
}

session默认是保存在内存中，可以配置保存到file redis mysql等。
在配置文件中加上
SessionProvider=file
SessionProviderConfig =./tmp
保存到文件，服务器重启后浏览器访问还是用之前session。

3 表单校验

type User struct {
	Id     int    `valid:"Required"`
	Name   string `valid:"Required;Match(/^Bee.*/)"` // Name 不能为空并且以 Bee 开头
	Age    int    `valid:"Range(1, 140)"` // 1 <= Age <= 140，超出此范围即为不合法
	Email  string `valid:"Email; MaxSize(100)"` // Email 字段需要符合邮箱格式，并且最大长度不能大于 100 个字符
	Mobile string `valid:"Mobile"` // Mobile 必须为正确的手机号
	IP     string `valid:"IP"` // IP 必须为一个正确的 IPv4 地址
}

// 如果你的 struct 实现了接口 validation.ValidFormer
// 当 StructTag 中的测试都成功时，将会执行 Valid 函数进行自定义验证
func (u *User) Valid(v *validation.Validation) {
	if strings.Index(u.Name, "admin") != -1 {
		// 通过 SetError 设置 Name 的错误信息，HasErrors 将会返回 true
		v.SetError("Name", "名称里不能含有 admin")
	}
}

func (c *UserController) Register(){
	var user User
	if err:=json.Unmarshal(c.Ctx.Input.RequestBody, &user);err!=nil{
		logs.Error(" Unmarshal fail:",err)
		return
	}
	valid := validation.Validation{}
	b, err := valid.Valid(&user)
	if err != nil {
		logs.Error(err)
		c.Ctx.WriteString(err.Error())
		return
		// handle error
	}
	if !b {
		// validation does not pass
		// blabla...
		var msg string
		for _, err := range valid.Errors {
			msg+=fmt.Sprintf("%s %s %s\n",err.Key,err.Message)
		}
		c.Ctx.WriteString(msg)
	}else{
		c.Ctx.WriteString("register success")
	}
}

这里有个注册函数，服务端需要校验数据合法性，比如是否为空，是否合邮件规则等。beego/validation模块相当方便。

4 数据库

自带orm不太好用，直接用go-sql-driver/mysql,原生sql写起来更得心应手。

beego虽然模块多，掌握这几个模块就可以开始写代码了，这种web框架学习起来还是挺容易的。

参考：

• beego 官网