详解GolangIris框架的基本使⽤
⽬录
1. Iris框架
1.1 Golang框架
1.2 安装Iris
2. 使⽤Iris构建服务端
2.1 简单例⼦1——直接返回消息
2.2 简单例⼦2——使⽤HTML模板
2.3 路由处理
2.4 使⽤中间件
2.5 使⽤⽂件记录⽇志
Iris介绍
编写⼀次并在任何地⽅以最⼩的机器功率运⾏,如Android、ios、Linux和Windows等。它⽀持Google Go,只需⼀个可执⾏的服务即可在所有平台。 Iris以简单⽽强⼤的api⽽闻名。除了Iris为您提供的低级访问权限。 Iris同样擅长MVC。它是唯⼀⼀个拥有MVC架构模式丰富⽀持的Go Web框架,性能成本接近于零。 Iris为您提供构建⾯向服务的应⽤程序的结构。⽤Iris构建微服务很容易。
1. Iris框架
1.1 Golang框架
  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.
1.2 安装Iris
# go get -u -v 获取包
go get github/kataras/iris/v12@latest
# 可能提⽰@latest是错误,如果版本⼤于11,可以使⽤下⾯打开GO111MODULE选项
# 使⽤完最好关闭,否则编译可能出错
go env -w GO111MODULE=on
# go get失败可以更改代理
go env -w GOPROXY=goproxy,direct
2. 使⽤Iris构建服务端
2.1 简单例⼦1——直接返回消息
package main
import (
"github/kataras/iris/v12"
"github/kataras/iris/v12/middleware/logger"
"github/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("<h1>Hello Iris!</h1>")
})
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
}
2.2 简单例⼦2——使⽤HTML模板
package main
import "github/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")
validation框架
})
app.Run(iris.Addr("localhost:8080"))
}
上述例⼦使⽤的hello.html模板
<html>
<head>
<title>Hello Page</title>
</head>
<body>
<h1>{{ .message }}</h1>
</body>
</html>
2.3 路由处理
上述例⼦中路由处理,可以使⽤下⾯简单替换,分别针对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")
})
2.4 使⽤中间件
app.Use(myMiddleware)
func myMiddleware(ctx iris.Context) {
ctx.Application().Logger().Infof("Runs before %s", ctx.Path())
ctx.Next()
}
2.5 使⽤⽂件记录⽇志
整个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
:int8int8-128 to 127Params().GetInt8 :int16int16-32768 to 32767Params().GetInt16 :int32int32-2147483648 to 2147483647Params().GetInt32 :int64int64-9223372036854775808 to 92233720368?4775807Params().GetInt64 :uint uint0 to 18446744073709551615 (x64) or 0 to 4294967295 (x32), depends on the host arch Params().GetUint :uint8uint80 to 255Params().GetUint8 :uint16uint160 to 65535Params().GetUint16 :uint32uint320 to 4294967295Params().GetUint32
:uint64uint640 to 18446744073709551615Params().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
Param Type Go Type Validation
Retrieve Helper 在路径中使⽤参数
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,  }) })
以上就是Iris 的基本⼊门使⽤,当然还有更多其他操作:中间件使⽤、正则表达式路由路径的使⽤、Cache 、Cookie 、Session 、File Server 、依赖注⼊、MVC 等的⽤法,可以参照官⽅教程使⽤,后期有时间会写⽂章总结。
到此这篇关于详解Golang Iris 框架的基本使⽤的⽂章就介绍到这了,更多相关Golang Iris 框架使⽤内容请搜索以前的⽂章或继续浏览下⾯的相关⽂章希望⼤家以后多多⽀持!

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。