Vanilla 的 controller

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

最简单的 Controller

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

  1. local IndexController = {}
  2. -- curl http://localhost:9110
  3. function IndexController:index()
  4.     local view = self:getView()
  5.     local p = {}
  6.     p['vanilla'] = 'Welcome To Vanilla...' .. userservice:get()
  7.     p['zhoujing'] = 'Power by Openresty'
  8.     -- view:assign(p)
  9.     do return view:render('index/index.html', p) end
  10.     return view:display()
  11. end
  12. -- curl http://localhost:9110/index/actionb
  13. function IndexController:actionb()
  14.     return 'index->actionb'
  15. end
  16. 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/actionb

注：目前 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