Vanilla 的 controller

vanilla 的 controller 是业务处理的关键，vanilla 通过对 URI 的路由，找到本次请求对应的 controller 和 action。

最简单的 Controller

自动生成的 demo 中默认生成了 IndexController 和 index action（function IndexController:index()），默认使用简单路由协议（vanilla.v.routes.simple）对 URI 进行路由

  1. local IndexController = {}
  3. -- curl http://localhost:9110
  4. function IndexController:index()
  5.     local view = self:getView()
  6.     local p = {}
  7.     p['vanilla'] = 'Welcome To Vanilla...' .. user_service:get()
  8.     p['zhoujing'] = 'Power by Openresty'
  9.     -- view:assign(p)
  10.     do return view:render('index/index.html', p) end
  11.     return view:display()
  12. end
  14. -- curl http://localhost:9110/index/action_b
  15. function IndexController:action_b()
  16.     return 'index->action_b'
  17. end
  19. return IndexController
以上代码解释

关于上面的 controller 实例代码，我们只需关注下面几点

  • IndexController:index （index Controller 中的 index Action），通过 self:getView() 方法获取视图实例
  • 可以通过先调用 view:assign(p) 将所需要的参数传入视图，再调用 view:display() 进行模板渲染，或者可以直接调用 view:render('index/index.html', p) 方法，指定需要渲染的模板，并同时传入相应的参数
  • 模板参数都是与 LUA 数组的形式进行传递
  • 每个 action 的返回值都必须是字符串，所以可以知道 view:display() 和 view:render() 方法都是返回字符串
  • IndexController:action_b （index Controller 中的 action_b Action，这里注意，action 的方法名必须小写），使用默认的简单路由协议，访问 URI 为 curl http://localhost:9110/index/action_b

注：目前 vanilla 所默认使用的模板引擎是 appo 老师开发的 resty-template，模板详细的使用文档请移步 appo 老师处参阅。

新添加一个 Controller

给 Vanilla 添加一个新的 Controller 非常简单，只需要在项目的 controllers 目录，实现一个 LUA 包，包导入的函数即为各个 action， 文件名与 controller 同名。例如添加一个名为 idevz 的 controller， 且实现一个名为 dohello 的 action（）。

  1. local IdevzController = {}
  2. -- curl http://localhost:9110/idevz/dohello
  3. function IdevzController:dohello()
  4.     return 'do-hello-action.'
  5. end
  6. return IdevzController