第五章 常用Lua开发库3-模板渲染
动态web网页开发是Web开发中一个常见的场景,比如像京东商品详情页,其页面逻辑是非常复杂的,需要使用模板技术来实现。而Lua中也有许多模板引擎,如目前我在使用的lua-resty-template,可以渲染很复杂的页面,借助LuaJIT其性能也是可以接受的。
如果学习过JavaEE中的servlet和JSP的话,应该知道JSP模板最终会被翻译成Servlet来执行;而lua-resty-template模板引擎可以认为是JSP,其最终会被翻译成Lua代码,然后通过ngx.print输出。
而lua-resty-template和大多数模板引擎是类似的,大体内容有:
模板位置:从哪里查找模板;
变量输出/转义:变量值输出;
代码片段:执行代码片段,完成如if/else、for等复杂逻辑,调用对象函数/方法;
注释:解释代码片段含义;
include:包含另一个模板片段;
其他:lua-resty-template还提供了不需要解析片段、简单布局、可复用的代码块、宏指令等支持。
首先需要下载lua-resty-template
- cd /usr/example/lualib/resty/
- wget https://raw.githubusercontent.com/bungle/lua-resty-template/master/lib/resty/template.lua
- mkdir /usr/example/lualib/resty/html
- cd /usr/example/lualib/resty/html
- wget https://raw.githubusercontent.com/bungle/lua-resty-template/master/lib/resty/template/html.lua
接下来就可以通过如下代码片段引用了
- local template = require("resty.template")
模板位置
我们需要告诉lua-resty-template去哪儿加载我们的模块,此处可以通过set指令定义template_location、
template_root或者从root指令定义的位置加载。
如我们可以在example.conf配置文件的server部分定义
- #first match ngx location
- set $template_location "/templates";
- #then match root read file
- set $template_root "/usr/example/templates";
也可以通过在server部分定义root指令
- root /usr/example/templates;
其顺序是
- local function load_ngx(path)
- local file, location = path, ngx_var.template_location
- if file:sub(1) == "/" then file = file:sub(2) end
- if location and location ~= "" then
- if location:sub(-1) == "/" then location = location:sub(1, -2) end
- local res = ngx_capture(location .. '/' .. file)
- if res.status == 200 then return res.body end
- end
- local root = ngx_var.template_root or ngx_var.document_root
- if root:sub(-1) == "/" then root = root:sub(1, -2) end
- return read_file(root .. "/" .. file) or path
- end
1、通过ngx.location.capture从template_location查找,如果找到(状态为为200)则使用该内容作为模板;此种方式是一种动态获取模板方式;
2、如果定义了template_root,则从该位置通过读取文件的方式加载模板;
3、如果没有定义template_root,则默认从root指令定义的document_root处加载模板。
此处建议首先template_root,如果实在有问题再使用template_location,尽量不要通过root指令定义的document_root加载,因为其本身的含义不是给本模板引擎使用的。
接下来定义模板位置
- mkdir /usr/example/templates
- mkdir /usr/example/templates2
example.conf配置server部分
- #first match ngx location
- set $template_location "/templates";
- #then match root read file
- set $template_root "/usr/example/templates";
- location /templates {
- internal;
- alias /usr/example/templates2;
- }
首先查找/usr/example/template2,找不到会查找/usr/example/templates。
然后创建两个模板文件
- vim /usr/example/templates2/t1.html
内容为
- template2
- vim /usr/example/templates/t1.html
内容为
- template1
test_temlate_1.lua
- local template = require("resty.template")
- template.render("t1.html")
example.conf配置文件
- location /lua_template_1 {
- default_type 'text/html';
- lua_code_cache on;
- content_by_lua_file /usr/example/lua/test_template_1.lua;
- }
访问如http://192.168.1.2/lua_template_1将看到template2输出。然后rm /usr/example/templates2/t1.html,reload nginx将看到template1输出。
接下来的测试我们会把模板文件都放到/usr/example/templates下。
API
使用模板引擎目的就是输出响应内容;主要用法两种:直接通过ngx.print输出或者得到模板渲染之后的内容按照想要的规则输出。
1、test_template_2.lua
- local template = require("resty.template")
- --是否缓存解析后的模板,默认true
- template.caching(true)
- --渲染模板需要的上下文(数据)
- local context = {title = "title"}
- --渲染模板
- template.render("t1.html", context)
- ngx.say("<br/>")
- --编译得到一个lua函数
- local func = template.compile("t1.html")
- --执行函数,得到渲染之后的内容
- local content = func(context)
- --通过ngx API输出
- ngx.say(content)
常见用法即如下两种方式:要么直接将模板内容直接作为响应输出,要么得到渲染后的内容然后按照想要的规则输出。
2、examle.conf配置文件
- location /lua_template_2 {
- default_type 'text/html';
- lua_code_cache on;
- content_by_lua_file /usr/example/lua/test_template_2.lua;
- }
使用示例
1、test_template_3.lua
- local template = require("resty.template")
- local context = {
- title = "测试",
- name = "张三",
- description = "<script>alert(1);</script>",
- age = 20,
- hobby = {"电影", "音乐", "阅读"},
- score = {语文 = 90, 数学 = 80, 英语 = 70},
- score2 = {
- {name = "语文", score = 90},
- {name = "数学", score = 80},
- {name = "英语", score = 70},
- }
- }
- template.render("t3.html", context)
请确认文件编码为UTF-8;context即我们渲染模板使用的数据。
2、模板文件/usr/example/templates/t3.html
- {(header.html)}
- <body>
- {# 不转义变量输出 #}
- 姓名:{* string.upper(name) *}<br/>
- {# 转义变量输出 #}
- 简介:{{description}}<br/>
- {# 可以做一些运算 #}
- 年龄: {* age + 1 *}<br/>
- {# 循环输出 #}
- 爱好:
- {% for i, v in ipairs(hobby) do %}
- {% if i > 1 then %},{% end %}
- {* v *}
- {% end %}<br/>
- 成绩:
- {% local i = 1; %}
- {% for k, v in pairs(score) do %}
- {% if i > 1 then %},{% end %}
- {* k *} = {* v *}
- {% i = i + 1 %}
- {% end %}<br/>
- 成绩2:
- {% for i = 1, #score2 do local t = score2[i] %}
- {% if i > 1 then %},{% end %}
- {* t.name *} = {* t.score *}
- {% end %}<br/>
- {# 中间内容不解析 #}
- {-raw-}{(file)}{-raw-}
- {(footer.html)}
{(include_file)}:包含另一个模板文件;
{* var *}:变量输出;
{{ var }}:变量转义输出;
{% code %}:代码片段;
{# comment #}:注释;
{-raw-}:中间的内容不会解析,作为纯文本输出;
模板最终被转换为Lua代码进行执行,所以模板中可以执行任意Lua代码。
3、example.conf配置文件
- location /lua_template_3 {
- default_type 'text/html';
- lua_code_cache on;
- content_by_lua_file /usr/example/lua/test_template_3.lua;
- }
访问如http://192.168.1.2/lua_template_3进行测试。
基本的模板引擎使用到此就介绍完了。
来源:http://jinnianshilongnian.iteye.com/blog/2187775
第五章 常用Lua开发库3-模板渲染相关推荐
- 第五章 常用Lua开发库2-JSON库、编码转换、字符串处理
JSON库 在进行数据传输时JSON格式目前应用广泛,因此从Lua对象与JSON字符串之间相互转换是一个非常常见的功能:目前Lua也有几个JSON库,本人用过cjson.dkjson.其中cjson的 ...
- 第五章 常用Lua开发库1-redis、mysql、http客户端
对于开发来说需要有好的生态开发库来辅助我们快速开发,而Lua中也有大多数我们需要的第三方开发库如Redis.Memcached.Mysql.Http客户端.JSON.模板引擎等. 一些常见的Lua库可 ...
- [单刷APUE系列]第五章——标准I/O库
目录 [单刷APUE系列]第一章--Unix基础知识[1] [单刷APUE系列]第一章--Unix基础知识[2] [单刷APUE系列]第二章--Unix标准及实现 [单刷APUE系列]第三章--文件I ...
- 【Python】推荐五个常用的图像处理库
1. 引言 Python目前是世界上使用最多的编程语言之一.它能够以更少的工作量和更少的代码行数来完成许多事情.它还可以使用很少的代码行来方便地编辑和创建图像. 本文重点介绍,在图像处理领域,我们最常 ...
- 19年8月 字母哥 第四章 常用web开发数据库框架 不要用公司网络加载不出来 用热点!!!
第四章 常用web开发数据库框架 4.1.整合Spring JDBC操作数据 4.2 Spring JDBC多数据源的实现 4.3.Spring JDBC JTA实现分布式事务 4.4.ORM主流框架 ...
- 概率论||期末考试复习手写笔记-第五六七章(知识点+例题)第五章 常用统计分布 第六章 参数估计 第七章 假设检验
第五章 常用统计分布 考点一:常用统计量 考点二:三大统计分布 考点三:抽样分布(单正态总体+双正态总体) 第六章 参数估计 考点一: 估计量的评价标准(无偏性+有效性+相合性) 考点二:点估计的常 ...
- 《NodeJS开发指南》第五章微博实例开发总结
所有文章搬运自我的个人主页:sheilasun.me <NodeJS开发指南>这本书用来NodeJS入门真是太好了,而且书的附录部分还讲到了闭包.this等JavaScript常用特性.第 ...
- APUE学习笔记:第五章 标准I/O库
5.1 引言 标准I/O库处理很多细节,例如缓冲区分配,以优化长度执行I/O等.这些处理不必担心如何使用正确的块长度.这使得它便于用户使用,但是如果不较深入地了解I/O库函数的操作,也会带来一些问题 ...
- UNIX 环境高级编程总结——第五章 标准I/O 库
5.1 流和 FILE 对象 对于标准 I/O 库,它们的操作则是围绕流(stream)进行的. 当打开一个流时,标准 I/O 函数 fopen 返回一个指向 FILE 对象的指针. 为了引用一个流, ...
最新文章
- 用json来组织数据,用IGame导出模型
- 在JavaScript中使用“原型”还是“ this”?
- MFC CString转换为字符数组
- Java迭代器ListIterator
- c++批量重命名_文件批量重命名?这个方法百试百灵
- 图像的亮度和对比度区别
- 最全面的 MySQL 索引详解
- 启动hiveserver2时报错Unable to instantiate org.apache.hadoop.hive.ql.metadata.SessionHiveMetaStoreClient
- mysql order by
- android4.0蓝牙使能的详细解析 (转载)
- lightslider-支持移动触摸的轻量级jQuery幻灯片插件
- ORACLE DELETE数据慢的案例
- python2.7使用教程_使用模块 - 廖雪峰 Python 2.7 中文教程
- java的打印语句_java打印输出语句是什么?
- 冒泡排序(java)——3种方法
- Activision解散《吉他英雄》,取消《真实犯罪》
- supervisor安装使用
- 佛祖保佑注释代码(内含神兽与美女)
- 电子计算机4个发展阶段的划分,计算机以什么划分发展阶段
- AD软件出现“Your license is already used on computer “LAPTOP-F99R6OR1“ using product “AltiumDesigner“
热门文章
- 2020-12-23
- 图文了解 Kafka 的副本复制机制
- 01_初识Matplotlib、Figure的组成、绘图函数的输入类型、第一个例子(学习笔记)
- 【C语言】switch…case无break情况(2)
- android adb 联系人,使用adb命令向Android模拟器中导入通讯录联系人的方法
- pythonpip安装与使用_Python pip 安装使用与问题
- oracle 删除补全日志组_浅谈Oracle 20c ASM文件组模板技术
- 计算机旁边快速访问没有桌面图标了怎么办,桌面找不到我的电脑(计算机)图标的解决办法-win10桌面显示我的电脑...
- verilog 移位运算符 说明_FPGA、数字IC系列(2)——电子科大与北航部分Verilog题目与解析...
- 图像锐化算法(Image sharpening):拉普拉斯增强和Unsharp Masking(附代码)