Freemarker

Freemarker

网页静态化技术和缓存技术的共同点都是为了减轻数据库的访问压力，但是具体的应用场景不同，缓存比较适合小规模的数据，而网页静态化比较适合大规模且相对变化不太频繁的数据。另外网页静态化还有利于SEO。

FreeMarker 是一个用 Java 语言编写的模板引擎，它基于模板来生成文本输出。FreeMarker与 Web 容器无关，即在 Web 运行时，它并不知道 Servlet 或 HTTP。它不仅可以用作表现层的实现技术，而且还可以用于生成 XML，JSP 或 Java 等。

FTL freemarker template language

freemarker 模板+数据

1.模板文件

模板文件中四种元素

1. 文本，直接输出的部分
2. 注释，即<#–…-->格式不会输出
3. 插值（Interpolation）：即${…}部分,将使用数据模型中的部分替代输出
4. FTL指令：FreeMarker指令，和HTML标记类似，名字前加#予以区分，不会输出。

FTL指令

<#-- assign 定义变量 -->
<#assign linkman="周先生">
联系人：${linkman}
<#assign info={"mobile":"13301231212",'address':'北京市昌平区王府街'} >
电话：${info.mobile}  地址：${info.address}
  
<#-- include 引入其他ftl模板文件 -->    
<#include "head.ftl">
    
<#-- if判断布尔值 在freemarker的判断中，可以使用=, 也可以使用==. --> 
<#if success=true>
  你已通过实名认证
<#else>  
  你未通过实名认证
</#if>  
    
    
<#-- list 循环遍历集合  goods_index 得到索引-->    
<#list goodsList as goods>
  ${goods_index+1} 商品名称： ${goods.name} 价格：${goods.price}<br>
</#list>

内建函数

<#-- 内建函数语法格式： 变量+?+函数名称   -->
    
<#-- 获取集合长度   -->
${goodsList?size}
    
<#-- json字符串转json对象 -->
<#assign jsonText="{'bank':'工商银行','account':'10101920201920212'}" />
<#assign jsonObject=jsonText?eval />
开户行：${jsonObject.bank}  账号：${jsonObject.account}    
    
<#-- 日期对象  数据today为new Date()时可以转换-->
当前日期：${today?date} <br>
当前时间：${today?time} <br>   
当前日期+时间：${today?datetime} <br>        
日期格式化：  ${today?string("yyyy年MM月")}    
    
<#-- 数字转字符串 数字在输出时默认是100,000,000 形式-->
${point?c}
    
<#-- 空值处理 判断变量是否存在-->
<#if aaa??>
  aaa变量存在
<#else>
  aaa变量不存在
</#if>
   
<#-- 空值处理 缺失变量默认值 当变量为null时 给他赋值 值为!后的内容-->
 ${aaa!'-'}

2.生成文件main函数

第一步：创建一个 Configuration 对象，直接 new 一个对象。构造方法的参数就是freemarker的版本号。

第二步：设置模板文件所在的路径。

第三步：设置模板文件使用的字符集。一般就是 utf-8.

第四步：加载一个模板，创建一个模板对象。

第五步：创建一个模板使用的数据集，可以是 pojo 也可以是 map。一般是 Map。

第六步：创建一个 Writer 对象，一般创建一 FileWriter 对象，指定生成的文件名。

第七步：调用模板对象的 process 方法输出文件。

第八步：关闭流

<dependency>
    <groupId>org.freemarker</groupId>
    <artifactId>freemarker</artifactId>
    <version>2.3.23</version>
</dependency>  

//1.创建配置类
Configuration configuration=new Configuration(Configuration.getVersion());
//2.设置模板所在的目录 
configuration.setDirectoryForTemplateLoading(new File("D:/freemarkerDemo/src/main/resources/"));
//3.设置字符集
configuration.setDefaultEncoding("utf-8");
//4.加载模板
Template template = configuration.getTemplate("test.ftl");
//5.创建数据模型
Map map=new HashMap();
map.put("name", "张三 ");
map.put("message", "欢迎登录鸭！");
//6.创建Writer对象
Writer out =new FileWriter(new File("d:\\test.html"));
//7.输出
template.process(map, out);
//8.关闭Writer对象
out.close();

3.集成spring

<dependency>
    <groupId>org.freemarker</groupId>
    <artifactId>freemarker</artifactId>
</dependency>  

<bean id="freemarkerConfig" class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
    <property name="templateLoaderPath" value="/WEB-INF/ftl/" />
    <property name="defaultEncoding" value="UTF-8" /> 
</bean>

@Service
public class ItemPageServiceImpl implements ItemPageService {

    @Value("${pagedir}")
    private String pagedir;

    @Autowired
    private FreeMarkerConfig freeMarkerConfig;

    @Autowired
    private TbGoodsMapper goodsMapper;

    @Autowired
    private TbGoodsDescMapper goodsDescMapper;

    @Override
    public boolean genItemHtml(Long goodsId){				
        try {
            Configuration configuration = freeMarkerConfig.getConfiguration();
            Template template = configuration.getTemplate("item.ftl");
            Map dataModel=new HashMap<>();			
            //1.加载商品表数据
            TbGoods goods = goodsMapper.selectByPrimaryKey(goodsId);
            dataModel.put("goods", goods);			
            //2.加载商品扩展表数据			
            TbGoodsDesc goodsDesc = goodsDescMapper.selectByPrimaryKey(goodsId);
            dataModel.put("goodsDesc", goodsDesc);						
            Writer out=new FileWriter(pagedir+goodsId+".html");
            template.process(dataModel, out);
            out.close();
            return true;			
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
    }
}