这篇文章给大家介绍如何正确的使用Golang中的Iris框架,内容非常详细,感兴趣的小伙伴们可以参考借鉴,希望对大家能有所帮助。
1. Iris框架
Golang常用框架有:Gin、Iris、Beego、Buffalo、Echo、Revel,其中Gin、Beego和Iris较为流行。Iris是目前流行Golang框架中唯一提供MVC支持(实际上Iris使用MVC性能会略有下降)的框架,并且支持依赖注入,使用入门简单,能够快速构建Web后端,也是目前几个框架中发展最快的,从2016年截止至目前总共有17.4k stars(Gin 35K stars)。
Iris is a fast, simple yet fully featured and very efficient web framework for Go. It provides a beautifully expressive and easy to use foundation for your next website or API.
Iris官网:https://iris-go.com/
Iris Github:https://github.com/kataras/iris
# go get -u -v 获取包 go get github.com/kataras/iris/v12@latest # 可能提示@latest是错误,如果版本大于11,可以使用下面打开GO111MODULE选项 # 使用完最好关闭,否则编译可能出错 go env -w GO111MODULE=on # go get失败可以更改代理 go env -w GOPROXY=https://goproxy.cn,direct
package main import ( "github.com/kataras/iris/v12" "github.com/kataras/iris/v12/middleware/logger" "github.com/kataras/iris/v12/middleware/recover" ) func main() { app := iris.New() app.Logger().SetLevel("debug") // 设置recover从panics恢复,设置log记录 app.Use(recover.New()) app.Use(logger.New()) app.Handle("GET", "/", func(ctx iris.Context) { ctx.HTML("<h2>Hello Iris!</h2>") }) app.Handle("GET", "/getjson", func(ctx iris.Context) { ctx.JSON(iris.Map{"message": "your msg"}) }) app.Run(iris.Addr("localhost:8080")) }
其他便捷设置方法:
// 默认设置日志和panic处理 app := iris.Default()
我们可以看到iris.Default()的源码:
// 注:默认设置"./view"为html view engine目录 func Default() *Application { app := New() app.Use(recover.New()) app.Use(requestLogger.New()) app.defaultMode = true return app }
package main import "github.com/kataras/iris/v12" func main() { app := iris.New() // 注册模板在work目录的views文件夹 app.RegisterView(iris.HTML("./views", ".html")) app.Get("/", func(ctx iris.Context) { // 设置模板中"message"的参数值 ctx.ViewData("message", "Hello world!") // 加载模板 ctx.View("hello.html") }) app.Run(iris.Addr("localhost:8080")) }
上述例子使用的hello.html模板
<html> <head> <title>Hello Page</title> </head> <body> <h2>{{ .message }}</h2> </body> </html>
上述例子中路由处理,可以使用下面简单替换,分别针对HTTP中的各种方法
app.Get("/someGet", getting) app.Post("/somePost", posting) app.Put("/somePut", putting) app.Delete("/someDelete", deleting) app.Patch("/somePatch", patching) app.Head("/someHead", head) app.Options("/someOptions", options)
例如,使用路由“/hello”的Get路径
app.Get("/hello", handlerHello) func handlerHello(ctx iris.Context) { ctx.WriteString("Hello") } // 等价于下面 app.Get("/hello", func(ctx iris.Context) { ctx.WriteString("Hello") })
app.Use(myMiddleware) func myMiddleware(ctx iris.Context) { ctx.Application().Logger().Infof("Runs before %s", ctx.Path()) ctx.Next() }
整个Application使用文件记录
上述记录日志
// 获取当前时间 now := time.Now().Format("20060102") + ".log" // 打开文件,如果不存在创建,如果存在追加文件尾,权限为:拥有者可读可写 file, err := os.OpenFile(now, os.O_CREATE | os.O_APPEND, 0600) defer file.Close() if err != nil { app.Logger().Errorf("Log file not found") } // 设置日志输出为文件 app.Logger().SetOutput(file)
到文件可以和中间件结合,以控制不必要的调试信息记录到文件
func myMiddleware(ctx iris.Context) { now := time.Now().Format("20060102") + ".log" file, err := os.OpenFile(now, os.O_CREATE | os.O_APPEND, 0600) defer file.Close() if err != nil { ctx.Application().Logger().SetOutput(file).Errorf("Log file not found") os.Exit(-1) } ctx.Application().Logger().SetOutput(file).Infof("Runs before %s", ctx.Path()) ctx.Next() }
上述方法只能打印Statuscode为200的路由请求,如果想要打印其他状态码请求,需要另使用
app.OnErrorCode(iris.StatusNotFound, func(ctx iris.Context) { now := time.Now().Format("20060102") + ".log" file, err := os.OpenFile(now, os.O_CREATE | os.O_APPEND, 0600) defer file.Close() if err != nil { ctx.Application().Logger().SetOutput(file).Errorf("Log file not found") os.Exit(-1) } ctx.Application().Logger().SetOutput(file).Infof("404") ctx.WriteString("404 not found") })
Iris有十分强大的路由处理程序,你能够按照十分灵活的语法设置路由路径,并且如果没有涉及正则表达式,Iris会计算其需求预先编译索引,用十分小的性能消耗来完成路由处理。
注:ctx.Params()和ctx.Values()是不同的,下面是官网给出的解释:
Path parameter's values can be retrieved from ctx.Params()Context's local storage that can be used to communicate between handlers and middleware(s) can be stored to ctx.Values() .
Iris可以使用的参数类型
Param Type | Go Type | Validation | Retrieve Helper |
---|---|---|---|
:string | string | anything (single path segment) | Params().Get |
:int | int | -9223372036854775808 to 9223372036854775807 (x64) or -2147483648 to 2147483647 (x32), depends on the host arch | Params().GetInt |
:int8 | int8 | -128 to 127 | Params().GetInt8 |
:int16 | int16 | -32768 to 32767 | Params().GetInt16 |
:int32 | int32 | -2147483648 to 2147483647 | Params().GetInt32 |
:int64 | int64 | -9223372036854775808 to 92233720368?4775807 | Params().GetInt64 |
:uint | uint | 0 to 18446744073709551615 (x64) or 0 to 4294967295 (x32), depends on the host arch | Params().GetUint |
:uint8 | uint8 | 0 to 255 | Params().GetUint8 |
:uint16 | uint16 | 0 to 65535 | Params().GetUint16 |
:uint32 | uint32 | 0 to 4294967295 | Params().GetUint32 |
:uint64 | uint64 | 0 to 18446744073709551615 | Params().GetUint64 |
:bool | bool | “1” or “t” or “T” or “TRUE” or “true” or “True” or “0” or “f” or “F” or “FALSE” or “false” or “False” | Params().GetBool |
:alphabetical | string | lowercase or uppercase letters | Params().Get |
:file | string | lowercase or uppercase letters, numbers, underscore (_), dash (-), point (.) and no spaces or other special characters that are not valid for filenames | Params().Get |
:path | string | anything, can be separated by slashes (path segments) but should be the last part of the route path | Params().Get |
在路径中使用参数
app.Get("/users/{id:uint64}", func(ctx iris.Context){ id := ctx.Params().GetUint64Default("id", 0) })
使用post传递参数
app.Post("/login", func(ctx iris.Context) { username := ctx.FormValue("username") password := ctx.FormValue("password") ctx.JSON(iris.Map{ "Username": username, "Password": password, }) })
关于如何正确的使用Golang中的Iris框架就分享到这里了,希望以上内容可以对大家有一定的帮助,可以学到更多知识。如果觉得文章不错,可以把它分享出去让更多的人看到。
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。