APIs - Controllers

优质

小牛编辑

132浏览

2023-12-01

Vanilla 的 controller

vanilla 的 controller 是业务处理的关键，基本的用法请参考快速开始。

关于 Controller

Vanilla 的 Controller 可以是任何普通的 LUA 包，只不过导入的方法被用作处理请求的 Action。如下示例：

local IndexController = {}
-- curl http://localhost:9110
function IndexController:index()
    local view = self:getView()
    local p = {}
    p['vanilla'] = 'Welcome To Vanilla...' .. user_service:get()
    p['zhoujing'] = 'Power by Openresty'
    -- view:assign(p)
    do return view:render('index/index.html', p) end
    return view:display()
end
-- curl http://localhost:9110/index/action_b
function IndexController:action_b()
    return 'index->action_b'
end
return IndexController

更面向对象的 Controller

Vanilla 支持使用 Class 方法来声明一个 Controller，实例如下：

local IndexController = Class('controllers.index')
-- curl http://localhost:9110/index/action_b
function IndexController:action_b()
    return 'index->action_b'
end
return IndexController

这种情况下，可以定义 Controller 的构造器来对其进行初始化。示例如下：

local IndexController = Class('controllers.index')
function IndexController:__construct()
    self.aa = aa({info='ppppp'})
end
-- curl http://localhost:9110/index/action_b
function IndexController:action_b()
    return 'index->action_b'
end
return IndexController

甚至还可以声明一个 Controller 基类，处理某些通用的逻辑，相关的详细用法参见 Vanilla面向对象相关章节。

关于 Action 的返回值

Vanilla 底层会将 Action 执行的结果，完全使用 ngx.print 进行输出，所以 Action 的返回值必须不能为空。而由于 Vanilla 的 Response 中，提供了给响应添加头尾的 Response:appendBody 和 Response:prependBody 方法，最终的结果会将这些部分合起来一起返回，所以 Action 的返回值要求如下：

Action 返回值必须非空
Action 返回值可以为一维索引数组（不可以是多维 Hash 数组）或者字符串