文档章节

使用你喜欢的模版引擎渲染页面

哈库纳
 哈库纳
发布于 2016/10/06 15:59
字数 876
阅读 562
收藏 5

    目前 Web 网站的开发 基本都用到了模版引擎,使用 Hasor 开发 web 可以使用你喜欢的任何模版解析引擎。在开始本文之前,先推荐您三篇相关文章:

    https://my.oschina.net/u/1166271/blog/753001《用 Hasor 谈一谈MVC设计模式》
    https://my.oschina.net/u/1166271/blog/550176《Web项目,工程目录应该怎样规划?》
    https://my.oschina.net/u/1166271/blog/753718《接受 Request 请求并获取请求参数》

用模版渲染页面

    Hasor 的页面渲染引擎和请求资源的扩展名有一定的关联性,我们以一个例子来说明。首先我们有一个页面 “index.html”这个页面打算使用 Freemarker 来进行渲染。

    那么我们第一步需要编写一个渲染器,并将这个渲染器和 “html”类型资源请求绑定到一起。

@Render("html")
public class FreemarkerRender implements RenderEngine {
    public void initEngine(WebAppContext appContext) throws Throwable {
        ...
    }
    public void process(RenderData renderData, Writer writer) throws Throwable {
        ...
    }
    public boolean exist(String template) throws IOException {
        ...
    }
}

    不光如此,您还可以同时将同一个渲染器绑定到不同类型的资源上。例如:

@Render({"html", "htm"})

    这样一来,凡是 “htm” 或 “html” 结尾的请求都会走这个渲染器。

    接下来我们做 Freemarker 和 Hasor 的整合:

@Render({"html", "htm"})
public class FreemarkerRender implements RenderEngine {
    protected Configuration configuration;
    public void initEngine(WebAppContext appContext) throws Throwable {
        String realPath = appContext.getEnvironment().getServletContext().getRealPath("/");
        TemplateLoader templateLoader = new FileTemplateLoader(new File(realPath), true);
        this.configuration = new Configuration(Configuration.VERSION_2_3_22);
        this.configuration.setTemplateLoader(templateLoader);
        this.configuration.setDefaultEncoding("utf-8");//默认页面编码UTF-8
        this.configuration.setOutputEncoding("utf-8");//输出编码格式UTF-8
        this.configuration.setLocalizedLookup(false);//是否开启国际化false
        this.configuration.setClassicCompatible(true);//null值测处理配置
        //
        // - 各种工具
        this.configuration.setSharedVariable("escapeHtml", new StringEscapeUtils());//HTML 转译,防止XSS使用。
        this.configuration.setSharedVariable("stringUtils", new StringUtils());
        //
        // - 环境变量
        this.configuration.setSharedVariable("ctx_path", appContext.getServletContext().getContextPath());
    }
    public void process(RenderData renderData, Writer writer) throws Throwable {
        Template temp = this.configuration.getTemplate(renderData.renderTo());
        //
        HashMap<String, Object> data = new HashMap<String, Object>();
        for (String key : renderData.keySet()) {
            data.put(key, renderData.get(key));
        }
        //
        temp.process(data, writer);
    }
    public boolean exist(String template) throws IOException {
        return this.configuration.getTemplateLoader().findTemplateSource(template) != null;
    }
}

    在最后我们需要在应用启动的时候将这个渲染器注册到 Hasor 中,下面是注册渲染器的一种方式。

public class StartModule extends WebModule {
    public void loadModule(WebApiBinder apiBinder) throws Throwable {
        apiBinder.bindType(RenderEngine.class).uniqueName().toInstance(new FreemarkerRender());
    }
}

可以同时使用多个渲染器吗?

    答案是可以的。

    前面我们已经知道渲染器是需要和资源类型绑定到一起的,因此多个渲染器同时工作也不是什么难事。

没有指定“*.do”的渲染器,我可以使用已存在的渲染器渲染它么?

    答案是可以的,我们看一个例子:

@MappingTo("/scene/login.do")
public class Login4Scene {
    public void execute(@Valid("login") @Params LoginForm4Scene loginForm, RenderData data) {
        if (data.isValid()) {
            data.renderTo("htm", "/userInfo.htm");
        } else {
            data.put("loginForm", loginForm);
            data.renderTo("htm", "/scene.htm");//使用 htm 引擎渲染页面。
        }
    }
}

    在上面例子代码中:renderTo 方法的第一个参数指定了当前请求结果在渲染页面是通过 htm 的渲染器进行渲染。

JSON渲染器

    json 渲染器是 Hasor 内置的一个渲染器,使用起来比较简单方便。我们看一个例子:

@MappingTo("/getUserInfo.json")
public class GetUserInfo {
    public UserInfo execute(RenderData data) {
        return new UserInfo();
    }
}

    当用户请求 “/getUserInfo.json” 的时候,首先会调用这个类的方法。方法返回了一个 UserInfo 对象。接着我们会把执行返回值保存到 RenderData 的 RESULT_DATA 数据中。然后在 JSON 渲染器中渲染这个数据。下面是整个 JSON 渲染器的源代码:

public class JsonRenderEngine implements RenderEngine {
    @Override
    public void initEngine(WebAppContext appContext) throws IOException {
    }
    @Override
    public void process(RenderData data, Writer writer) throws Throwable {
        String json = JSON.DEFAULT.toJSON(data.get(RenderData.RETURN_DATA_KEY));
        writer.write(json);
    }
    @Override
    public boolean exist(String template) throws IOException {
        return true;
    }
}

 

© 著作权归作者所有

共有 人打赏支持
哈库纳

哈库纳

粉丝 963
博文 84
码字总数 151810
作品 4
杭州
后端工程师
私信 提问
VUE.js 掺杂 各种模版引擎 时候的使用场景

本人不是干前端的 , 最近看了下 Vue.js 的 . 有一些疑问 . 因为之前都是使用 jsp的el表达式取值.或者使用freemarker模版取值,又或者使用jfinal的TemplateEng取值 一般都是这样 *** url地址请...

丶Lion
2017/04/01
1K
5
前后端分离的思考与实践(二)

原文出处:淘宝UED - Herman 基于前后端分离的模版探索 前言 在做前后端分离时,第一个关注到的问题就是 渲染,也就是 View 这个层面的工作。 在传统的开发模式中,浏览器端与服务器端是由不...

淘宝UED - Herman
2014/04/18
0
0
iOS 模版引擎--MGTemplateEngine

如果你用过php的Smarty,你一定知道模板引擎说的是什么。Matt Gemmell开发了一个基于Cocoa的类似的模板引擎,叫做MGTemplateEngine。 MGTemplateEngine是一套Cocoa的模板系统,基于模板和数据...

匿名
2013/05/04
2.9K
1
完全依赖前端javascript渲染生成页面的优缺点?

完全依赖前端javascript渲染,是否会好过后台模版语言生成HTML的方式?不是像Extjs那样庞大的前端库,只使用基本javascript模版引擎。我所知道的:前端生成的好处,后台只需要吐出很少的jso...

hell0cat
2012/06/30
1K
2
极简的代码生成器--Agen

一个极简的代码生成器,可以嵌进你自己的项目中。 自由软件: MIT license English Documentation: https://agen.readthedocs.com/en/ 特性 简化到不能再简化的API 支持自定义 Jinja Env 可以...

李宇飞
2016/03/21
1K
1

没有更多内容

加载失败,请刷新页面

加载更多

重磅!亚洲诚信实力斩获:“2018 DigiCert/Symantec 年度最佳创新合作伙伴”大奖

2018年11月13日-16日,全球顶级数字证书厂商,DigiCert/Symantec亚太区圆桌会议(Asia Partner Roundtable 2018)在日本大阪隆重召开。 亚洲诚信作为DigiCert/Symantec亚太区白金战略合作伙伴和...

亚洲诚信
21分钟前
2
0
始于阿里,回归社区:阿里8个项目进入CNCF云原生全景图

摘要: 一群技术理想主义者,与太平洋另一边的技术高手们正面PK,在这场躲不开的战役中,一起认真一把。 破土而出的生命力,源自理想主义者心底对技术的信念。 云原生技术正席卷全球,云原生...

阿里云官方博客
28分钟前
3
0
修改this指向(bind、call 和 apply)

一、bind bind 的其中一个用法就是:绑定函数,使其无论怎么样调用都用相同的 this 示例: var obj = { getThis: function() { console.log(this); }};obj.getThis()...

文文1
今天
1
0
WSL安装JDK8

下载地址 JDK_URL https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html UNLIMITED_STRENGTH_URL https://www.oracle.com/technetwork/java/javase/down......

terwergreen
今天
4
0
sparkStreaming基本概念

概述 Spark Streaming 是 Spark Core API 的扩展, 它支持弹性的, 高吞吐的, 容错的实时数据流的处理. 数据可以通过多种数据源获取, 例如 Kafka, Flume, Kinesis 以及 TCP sockets, 也可以通过...

freeli
今天
7
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部