lua 服务器

这是为方便使用脚本语言LUA进行web应用开发准备的。

来看代码：

  2. #include <mongols/lua_server.hpp>
  4. int main(int, char**) {
  5.     int port = 9090;
  6.     const char* host = "127.0.0.1";
  7.     mongols::lua_server
  8.     server(host, port, 5000, 8096, 0/*2*/);
  9.     server.set_root_path("html/lua");
  10.     server.set_enable_bootstrap(true);
  11.     server.run("html/lua/package/?.lua;", "html/lua/package/?.so;");
  12. }
  2. local echo =  {}
  4. function echo.concat(...)
  5.     local text=''
  6.     for i,v in ipairs({...}) do
  7.         text=text..tostring(v)
  8.     end
  9.    return text
  10. end
  12. return echo 
  14. `
  2. local echo=require('echo')
  3. mongols_res:header('Content-Type','text/plain;charset=UTF-8')
  4. mongols_res:content(echo.concat('hello,','world'))
  5. mongols_res:status(200)

API

mongols_req

  • uri
  • method
  • client
  • param
  • user_agent
  • has_header
  • get_header
  • has_form
  • get_form
  • has_session
  • get_session
  • has_cookie
  • get_cookie
  • has_cache
  • get_cache

mongols_res

  • status
  • content
  • header
  • session
  • cache

其他

为了方便，我还在lua引擎中嵌入了一个可用于正则计算的表：mongols_regex，内含三个函数:

  • full_match
  • partial_match
  • match
    其具体用法可参考以下代码:
  2. mongols_res:header('Content-Type','text/plain;charset=UTF-8')
  4. if mongols_req:has_form('test') then
  5.     local test=mongols_req:get_form('test')
  6.     if mongols_regex.partial_match('^[0-9]+$',test) then
  7.         mongols_res:content('int type: '..test)
  8.     elseif mongols_regex.partial_match('^[a-zA-Z]+$',test) then
  9.         mongols_res:content('string type: '..test)
  10.     else
  11.         local match=mongols_regex.match('(\\w+)[_:+-](\\w+)',test)
  12.         if #match > 0 then
  13.             local content=''
  14.             for key,value in ipairs(match) do 
  15.                 content =content .. 'part '..key ..' = '.. value..'\n'
  16.             end
  17.             mongols_res:content('match: \n'..content)
  18.         else
  19.             mongols_res:content('not match: '.. test)
  20.         end
  21.     end
  22. else 
  23.     mongols_res:content('not found test variable')
  24. end
  27. mongols_res:status(200)

为了方便json处理，我内置了一个基于jsoncpp的类mongols_json，API列表如下：

  • set
  • get
  • append
  • parse_string
  • parse_file
  • as_xxx
    • string
    • bool
    • double
    • long
  • is_xxx
    • string
    • bool
    • double
    • long
    • object
    • array
  • size
  • to_string
    具体用法参考下例：
  1. local cjson=require('cjson')
  2. local j = mongols_json.new()
  3. local json_str=[[
  4. {
  5. "employees": [
  6. { "firstName":"John" , "lastName":"Doe" },
  7. { "firstName":"Anna" , "lastName":"Smith" },
  8. { "firstName":"Peter" , "lastName":"Jones" }
  9. ]
  10. }
  11. ]]
  13. j:parse_string(json_str)
  14. print(j:to_string())
  16. local employees=j:get('employees')
  17. local item=mongols_json.new()
  18. item:set('firstName','Hello')
  19. item:set('lastName','World')
  20. employees:append(item)
  22. if employees:is_array() then 
  23.     local size=employees:size()
  24.     for i= 0,size-1 do
  25.         local iter=employees:get(i)
  26.         print(iter:get('firstName'):as_string()..' : ' ..iter:get('lastName'):as_string())
  27.     end
  28. end
  30. j:set('employees',employees)
  31. j:set('node1','test')
  32. j:set('node2',true)
  33. j:set('node3',3.1415926)
  34. j:set('node4',100)
  35. print(j:to_string())
  38. local value = { true, { foo = "bar" } ,{1,2,3,'test',3.2}}
  39. local json_text = cjson.encode(value)
  40. print(json_text)
  42. local mj=mongols_json.new()
  43. mj:parse_string(json_text)
  44. print(mj:to_string())

mongols_json不认识Lua的表类型，但lua-cjson认识。所以我内置了lua-cjson。以后，还会内置一些好用常用的第三方插件。

单文件入口

单文件入口模式是web编程中常见的模式。默认情况下，lua_server没有开启对该模式的支持。欲开启此一支持，使用方法set_enable_bootstrap。

example下有例子代码，可参考：

  1. --index.lua
  3. local echo=require('echo')
  4. local route=require('route'):get_instance()
  7. route:add({'GET'},'^/hello/([0-9a-zA-Z]+)/?$'
  8. ,function(req,res,param)
  9.     res:content('hello,'..param[2])
  10.     res:header('Content-Type','text/plain;charset=UTF-8')
  11.     res:status(200)
  12. end)
  14. route:add({'GET'},'^/([0-9]+)/?$'
  15. ,function(req,res,param)
  16.     res:content(param[2]) 
  17.     res:header('Content-Type','text/plain;charset=UTF-8')
  18.     res:status(200)
  19. end)
  22. route:add({'GET','POST','PUT'},'^/(\\w+)/?$'
  23. ,function(req,res,param) 
  24.     local text= echo.concat('uri: ',req:uri(),'\n','method: ',req:method(),'\n',param[2])
  25.     res:content(text) 
  26.     res:header('Content-Type','text/plain;charset=UTF-8')
  27.     res:status(200)
  28. end)
  30. route:run(mongols_req,mongols_res)

c/c++ 模块

lua_server支持直接向服务器注册c/c++函数和类。例子:

  2. class person {
  3. public:
  5.     person() : name("Tom"), age(0) {
  6.     }
  7.     virtual~person() = default;
  9.     person* set_name(const std::string& name) {
  10.         this->name = name;
  11.         return this;
  12.     }
  14.     person* set_age(unsigned int age) {
  15.         this->age = age;
  16.         return this;
  17.     }
  19.     const std::string& get_name() const{
  20.         return this->name;
  21.     }
  23.     unsigned int get_age() {
  24.         return this->age;
  25.     }
  26. private:
  27.     std::string name;
  28.     unsigned int age;
  29. };
  31. class studest : public person {
  32. public:
  34.     studest() : person() {
  35.     }
  36.     virtual~studest() = default;
  38.     double get_score() {
  39.         return this->score;
  40.     }
  42.     studest* set_score(double score) {
  43.         this->score = score;
  44.         return this;
  45.     }
  46. private:
  47.     double score;
  48. };
  50. //some code
  52. server.set_function(&mongols::sha1, "sha1");
  53. server.set_function(&mongols::md5, "md5");
  55. server.set_class(
  56.             kaguya::UserdataMetatable<person>()
  57.             .setConstructors < person()>()
  58.             .addFunction("get_age", &person::get_age)
  59.             .addFunction("get_name", &person::get_name)
  60.             .addFunction("set_age", &person::set_age)
  61.             .addFunction("set_name", &person::set_name)
  62.             , "person");
  64. server.set_class(
  65.             kaguya::UserdataMetatable<studest, person>()
  66.             .setConstructors < studest()>()
  67.             .addFunction("get_score", &studest::get_score)
  68.             .addFunction("set_score", &studest::set_score)
  69.             , "studest");
  3. local template = require "resty.template"
  4. local view=template.new('name: {{name}}\
  5. age: {{age}}\
  6. score: {{score}}\
  7. text:{{text}}\
  8. text_md5: {{md5}}\
  9. text_sha1: {{sha1}}')
  11. local text='hello,world'
  13. local s=studest.new()
  14. s:set_score(74.6):set_name("Jerry"):set_age(14)
  16. view.name=s:get_name()
  17. view.age=s:get_age()
  18. view.score=s:get_score()
  19. view.text=text
  20. view.md5=md5(text)
  21. view.sha1=sha1(text)
  23. mongols_res:header('Content-Type','text/plain;charset=UTF-8')
  24. mongols_res:content(tostring(view))
  25. mongols_res:status(200)

所以，无需写动态库扩展了。是不是太方便？

原文: https://mongols.hi-nginx.com/doc/lua.html