Android freemarker模板引擎应用
什么是freemarker?
在说这个之前我们都知道web和原生控件之争就那么点事。性能，加载速度，流量，数据交互….
如果我用webView加载一个url页面，要先通过网络解析css，解析html代码，然后渲染生成页面
什么是freemarker?简单点就是，事先把上面这个html文件，放到应用中，用的时候只要传入数据就行
freemarker优点和应用
节约流量，加快网页加载速度
比如某些图表功能，用js库实现比较方便，只要事先放入html模板，传入数据就行。大大节省了流量及加载速度
或者事先已经有网页功能的页面，就不需要在制作Android界面了
此功能在IOS上通用，所以只要一个模板，就可以用在IOS和Android上，大大节约开发时间
实现原理
webView加载本地模板引擎流程
main.tpl ——–> main.ftl+数据 ———> main.html ———> webView.load(main.html)
1、导入freemarker库
- compile 'org.freemarker:freemarker-gae:2.3.25-incubating'
2、将main.tpl文件放入assets目录下
- <!--main.tpl文件-->
- <html>
- <head>
- <title>Welcome!</title>
- </head>
- <body>
- <h1>Welcome ${user}!</h1>
- <p>Our latest product:
- </body>
- </html>
3、根据main.tpl转成main.ftl
- private void prepareTemplate() throws IOException {
- //获取app目录 data/data/package/file/
- String destPath = getFilesDir().getAbsolutePath();
- File dir = new File(destPath);
- //判断文件夹是否存在并创建
- if (!dir.exists()) {
- dir.mkdir();
- }
- //需要生成的.ftl模板文件名及路径
- String tempFile = destPath + "/" + "main.ftl";
- if (!(new File(tempFile).exists())) {
- //获取assets中.tpl模板文件
- InputStream is = getResources().getAssets().open("main.tpl");
- //生成.ftl模板文件
- FileOutputStream fos = new FileOutputStream(tempFile);
- byte[] buffer = new byte[7168];
- int count = 0;
- while ((count = is.read(buffer)) > 0) {
- fos.write(buffer, 0, count);
- }
- fos.flush();
- fos.close();
- is.close();
- }
- }
4、将 main.ftl和数据 生成main.html文件
- private void genHTML(Product object) {
- String destPath = getFilesDir().getAbsolutePath();
- FileWriter out = null;
- //数据源
- Map root = new HashMap();
- root.put("user", "user"); //传入字符串
- //root.put("product", object.url()); //传入对象(会报错)
- try {
- Configuration cfg = new Configuration(new Version(2,3,0));
- cfg.setDefaultEncoding("UTF-8");
- //设置报错提示
- cfg.setTemplateExceptionHandler(TemplateExceptionHandler.RETHROW_HANDLER);
- //设置报错提示
- cfg.setLogTemplateExceptions(true);
- out = new FileWriter(new File(destPath + "main.html"));
- //设置.ftl模板文件路径
- cfg.setDirectoryForTemplateLoading(new File(destPath));
- //设置template加载的.ftl模板文件名称
- Template temp = cfg.getTemplate("main.ftl");
- //讲数据源和模板生成.html文件
- temp.process(root, out);
- out.flush();
- } catch (MalformedTemplateNameException e) {
- } catch (IOException e) {
- } catch (Exception e){
- }finally {
- try {
- if (out != null)
- out.close();
- } catch (IOException e) {
- e.printStackTrace();
- }
- }
- }
5、webView加载main.html
- webview.post(new Runnable() {
- @Override
- public void run() {
- String templateDirRoot = getFilesDir().getAbsolutePath();
- String url = "file://" + templateDirRoot + "main.html";
- webview.loadUrl(url);
- }
- });
问题注意点
1、为什么要先把mian.tpl转成main.ftl文件，而不直接把mian.ftl文件放到assets中，然后template直接加载main.ftl文件
因为assets中的文件无法直接读取，所以要先把文件放到data/data/package/….再操作
2、突然发现2016年版的freemarker无法传递对象。
比如在main.ftl文件中${model.name}就无法再继续转成main.html，提示如下错误
- Unresolved exception class when finding catch block: java.beans.IntrospectionException
官方说可以，但个人测试了无数遍，就是无法编译对象传值
如下方式可以获取到name
- //activity.java
- User user = new User();
- user.setName="张三"
- Map map = HashMap();
- map.put("name", user.getName());
- //main.tpl
- <html>
- <body>
- ${name}
- <body>
- <html>
如下方式无法获取到name
- //activity.java
- User user = new User();
- user.setName="张三"
- Map map = HashMap();
- map.put("user", user);
- //main.tpl
- <html>
- <body>
- ${user.name}
- <body>
- <html>
总结
最后没发现webView页面加载快多少，可能数据量少。毕竟要对SD卡操作。流量确实省了，也少了java和html直接的数据交互代码。
