iris MVC hello world示例

目录结构

主目录helloWorld

  1.     —— main.go
  2.     —— main_test.go

代码示例

文件名称 main.go

  1. package main
  3. import (
  4.     "github.com/kataras/iris"
  5.     "github.com/kataras/iris/mvc"
  6.     "github.com/kataras/iris/middleware/logger"
  7.     "github.com/kataras/iris/middleware/recover"
  8. )
  10. //这个例子相当于
  11. // /hello-world/main.go
  13. //似乎是你的附加代码,必须写不值得但请记住，这个例子
  14. //没有使用像iris mvc这样的功能
  15. //Model，Persistence或View引擎,也不是Session，
  16. //这对于学习目的来说非常简单,可能你永远不会用到这样的,作为应用程序中任何位置的简单控制器
  18. //我们在这个示例中使用MVC
  19. //在提供JSON的“/ hello”路径上
  20. //在我的个人笔记本电脑上每20MB吞吐量大约2MB，
  21. //它可以接受大多数应用程序，但你可以选择
  22. //最适合你的是Iris，低级处理程序：性能
  23. //或高级控制器：在大型应用程序上更易于维护和更小的代码库。
  25. //当然你可以将所有这些都放到主函数中，它只是一个单独的函数
  26. //用于main_test.go。
  27. func newApp() *iris.Application {
  28.     app := iris.New()
  29.     //（可选）添加两个内置处理程序
  30.     //可以从任何与http相关的panics中恢复
  31.     //并将请求记录到终端。
  32.     app.Use(recover.New())
  33.     app.Use(logger.New())
  34.     //控制器根路由路径"/"
  35.     mvc.New(app).Handle(new(ExampleController))
  36.     return app
  37. }
  39. func main() {
  40.     app := newApp()
  41.     // http://localhost:8080
  42.     // http://localhost:8080/ping
  43.     // http://localhost:8080/hello
  44.     // http://localhost:8080/custom_path
  45.     app.Run(iris.Addr(":8080"))
  46. }
  48. // ExampleController提供 ”/”，“/ping”和 “/hello”路由选项
  49. type ExampleController struct{}
  51. // Get 服务
  52. // 请求方法:   GET
  53. // 请求资源路径: http://localhost:8080
  54. func (c *ExampleController) Get() mvc.Result {
  55.     return mvc.Response{
  56.         ContentType: "text/html",
  57.         Text:        "<h1>Welcome</h1>",
  58.     }
  59. }
  61. // GetPing 服务
  62. // 请求方法:   GET
  63. // 请求资源路径: http://localhost:8080/ping
  64. func (c *ExampleController) GetPing() string {
  65.     return "pong"
  66. }
  68. // GetHello 服务
  69. // 请求方法:   GET
  70. // 请求资源路径: http://localhost:8080/hello
  71. func (c *ExampleController) GetHello() interface{} {
  72.     return map[string]string{"message": "Hello Iris!"}
  73. }
  75. //在main函数调用controller之前调用一次BeforeActivation
  76. //在版本9之后，您还可以为特定控制器的方法添加自定义路由
  77. //在这里您可以注册自定义方法的处理程序
  78. //使用带有`ca.Router`的标准路由器做一些你可以做的事情即使不是mvc
  79. //并添加将绑定到控制器的字段或方法函数的输入参数的依赖项
  80. func (c *ExampleController) BeforeActivation(b mvc.BeforeActivation) {
  81.     anyMiddlewareHere := func(ctx iris.Context) {
  82.         ctx.Application().Logger().Warnf("Inside /custom_path")
  83.         ctx.Next()
  84.     }
  85.     b.Handle("GET", "/custom_path", "CustomHandlerWithoutFollowingTheNamingGuide", anyMiddlewareHere)
  86.     //甚至添加基于此控制器路由的全局中间件，
  87.     //在这个例子中是根“/”：
  88.     // b.Router().Use(myMiddleware)
  89. }
  91. // CustomHandlerWithoutFollowingTheNamingGuide 服务
  92. // 请求方法:   GET
  93. // 请求资源路径: http://localhost:8080/custom_path
  94. func (c *ExampleController) CustomHandlerWithoutFollowingTheNamingGuide() string {
  95.     return "hello from the custom handler without following the naming guide"
  96. }
  98. // GetUserBy 服务
  99. // 请求方法:   GET
  100. // 请求资源路径: http://localhost:8080/user/{username:string}
  101. //是一个保留的关键字来告诉框架你要在函数的输入参数中绑定路径参数，
  102. //在同一控制器中使用“Get”和“GetBy”可以实现
  103. //
  104. //func (c *ExampleController) GetUserBy(username string) mvc.Result {
  105. //     return mvc.View{
  106. //         Name: "user/username.html",
  107. //         Data: username,
  108. //     }
  109. // }
  111. /*
  112. func (c *ExampleController) Post() {}
  113. func (c *ExampleController) Put() {}
  114. func (c *ExampleController) Delete() {}
  115. func (c *ExampleController) Connect() {}
  116. func (c *ExampleController) Head() {}
  117. func (c *ExampleController) Patch() {}
  118. func (c *ExampleController) Options() {}
  119. func (c *ExampleController) Trace() {}
  120. */
  122. /*
  123. func (c *ExampleController) All() {}
  124. //  或者
  125. func (c *ExampleController) Any() {}
  127. func (c *ExampleController) BeforeActivation(b mvc.BeforeActivation) {
  128.     // 1 -> http 请求方法
  129.     // 2 -> 请求路由
  130.     // 3 -> 此控制器的方法名称应该是该路由的处理程序
  131.     b.Handle("GET", "/mypath/{param}", "DoIt", optionalMiddlewareHere...)
  132. }
  134. //AfterActivation，所有依赖项都被设置,因此访问它们是只读
  135. ，但仍可以添加自定义控制器或简单的标准处理程序。
  136. func (c *ExampleController) AfterActivation(a mvc.AfterActivation) {}
  137. */

main_test.go

  1. package main
  3. import (
  4.     "testing"
  5.     "github.com/kataras/iris/httptest"
  6. )
  8. func TestMVCHelloWorld(t *testing.T) {
  9.     e := httptest.New(t, newApp())
  10.     e.GET("/").Expect().Status(httptest.StatusOK).
  11.         ContentType("text/html", "utf-8").Body().Equal("<h1>Welcome</h1>")
  12.     e.GET("/ping").Expect().Status(httptest.StatusOK).
  13.         Body().Equal("pong")
  14.     e.GET("/hello").Expect().Status(httptest.StatusOK).
  15.         JSON().Object().Value("message").Equal("Hello Iris!")
  16.     e.GET("/custom_path").Expect().Status(httptest.StatusOK).
  17.         Body().Equal("hello from the custom handler without following the naming guide")
  18. }