openresty前端開發輕量級MVC框架封裝一（控制器篇）

通過前面幾章，我們已經掌握了一些基本的開發知識，但是程式碼結構比較簡單，缺乏統一的標準，模組化，也缺乏統一的異常處理，這一章我們主要來學習如何封裝一個輕量級的MVC框架，規範以及簡化開發，並且提供類似php所見即所得的能力

統一入口

通常來說一個mvc框架會有一個統一的入口點，類似於spring mvc的DispatcherServlet，會攔截所有的請求，也就是/，於是我們可以得出我們的入口點

conf/nginx.conf

worker_processes  1;

error_log logs/error.log notice;

events {
    worker_connections 1024;
}

http {
    lua_package_path "/Users/john/opensource/openresty-web-dev/demo8/lua/?.lua;/Users/john/opensource/openresty-web-dev/demo8/lualib/?.lua;/usr/local/openresty/lualib/?.lua";
    server {
        listen 80;
        server_name localhost;
        lua_code_cache off;

        location / {
            content_by_lua_file lua/mvc.lua;
        }

        location ~ ^/js/|^/css/|.html {
            root html;
        }
    }
}

除了靜態檔案js/css/html檔案，其他的請求都會被我們的mvc.lua處理。

預設頁面

當請求uri為空時，預設返回index.html頁面，當然也可以自己定義，實現這個效果很簡單

local uri = ngx.var.uri
-- 預設首頁
if uri == "" or uri == "/" then
    local res = ngx.location.capture("/index.html", {})
    ngx.say(res.body)
    return
end

url解析

這裡簡單的把url解析成模組名模組方法，根據/分割，如果只有模組名，沒有方法名，則預設為index方法

local m, err = ngx.re.match(uri, "([a-zA-Z0-9-]+)/*([a-zA-Z0-9-]+)*")

local moduleName = m[1]     -- 模組名
local method = m[2]         -- 方法名

if not method then
    method = "index"        -- 預設訪問index方法
else
    method = ngx.re.gsub(method, "-", "_")    
end

動態Controller模組

得到模組名之後，需要動態引入模組，通過pcall，然後再呼叫模組的方法

-- 控制器預設在web包下面
local prefix = "web."       
local path = prefix .. moduleName

-- 嘗試引入模組，不存在則報錯
local ret, ctrl, err = pcall(require, path)

local is_debug = true       -- 除錯階段，會輸出錯誤資訊到頁面上

if ret == false then
    if is_debug then
        ngx.status = 404
        ngx.say("<p style=`font-size: 50px`>Error: <span style=`color:red`>" .. ctrl .. "</span> module not found !</p>")
    end
    ngx.exit(404)
end

-- 嘗試獲取模組方法，不存在則報錯
local req_method = ctrl[method]

if req_method == nil then
    if is_debug then
        ngx.status = 404
        ngx.say("<p style=`font-size: 50px`>Error: <span style=`color:red`>" .. method .. "()</span> method not found in <span style=`color:red`>" .. moduleName .. "</span> lua module !</p>")
    end
    ngx.exit(404)
end

-- 執行模組方法，報錯則顯示錯誤資訊，所見即所得，可以追蹤lua報錯行數
ret, err = pcall(req_method)

if ret == false then
    if is_debug then
        ngx.status = 404
        ngx.say("<p style=`font-size: 50px`>Error: <span style=`color:red`>" .. err .. "</span></p>")
    else
        ngx.exit(500)
    end
end

異常處理

可以看到，從引入模組，到獲取模組方法，已經執行方法，都有可能報錯，這裡通過pcall來進行呼叫，這種方式可以安全的呼叫lua程式碼，不會導致異常中斷，然後通過定義一個變數，來區分是否為開發除錯階段，如果是則把錯誤資訊輸出到瀏覽器端，否則直接報404或者500，避免把錯誤資訊輸出到客戶端，導致程式碼洩漏。

至此，一個簡單的mvc框架已經可以使用了，但是現在還只能做前端渲染，下一章，我講介紹如果進行服務端渲染。

示例程式碼 參見demo8部分