如何解决freemarker静态化生成html页面乱码的问题

目录

• freemarker静态化生成html页面乱码的问题
• 下面是springmvc的核心代码
• 在网上也查了下大致给了以下几种解决方案
• freemarker页面静态化步骤以及相关注意事项
• Freemarker
• 例子
• 模板
• 模板
• 配置文件
• 总结

freemarker静态化生成html页面乱码的问题

今天在整理之前所学的知识,在复习freemarker生成html页面的时候出现了中文乱码的问题,

在费了一番时间后终于找到问题的原因,觉得挺有意思,就把这段记录下来。

下面是springmvc的核心代码

 
    
            
            
            
            
            
            
          
                10
                zh_CN
                yyyy-MM-dd HH:mm:ss
                yyyy-MM-dd
                HH:mm:ss
                
                #.##
            
           
     
     
     
     
         
           
           
           
           
     

然后是controller的核心代码

@RequestMapping("/getHtml")
    public String getHtml(HttpServletRequest request,HttpServletResponse response) throws Exception{
        //第一步 freemarkerConfigurer得到一个Configure对象
        Configuration configuration = freeMarkerConfigurer.getConfiguration();
        //第二步 得到一个模版文件
        Template template = configuration.getTemplate("index.ftl");
        //第三步 构建数据模型
        Map map = new HashMap();
        map.put("uname", "zhangsan");
        map.put("bookList", BookDaoImpl.getBookList());
        System.out.println(BookDaoImpl.getBookList().get(0).getAuthor());
        //第四步 指定一个文件夹 构建一个输出流
        String dir = request.getSession().getServletContext().getRealPath("/WEB-INF/");
        //PrintWriter printWriter = new PrintWriter(new FileWriter(new File(dir,"index.html")));
        System.out.println(dir);
        //第五步 数据模型+模版文件 = 输出(控制台输出,html文件)
        template.process(map, printWriter);
        printWriter.flush();
        return "success";
    }

最后页面提示成功生成html页面

但在进入生成的html页面时发生了乱码

在网上也查了下大致给了以下几种解决方案

首先是说ftl文件的head上加上

因为我在springmvc的视图解析器配置了

所以这个选择首先pass掉，然后说是在controller里加上

configuration.setDefaultEncoding("UTF-8");

不过因为我在freemarker的环境配置我也配置了默认的编码

所以应该也不是这个原因，后来我找到生成的html文件，发现用浏览器查看源代码虽然会乱码，但用记事本打开的时候所显示并没有乱码，然后判断是输出流的问题，通过网上查找发现FileWriter和FileReader使用的是系统默认的编码方式，因为fileWriter本身不具有用户指定编码的方式，这里选择使用filewriter 的父类OutputStreamWriter来读写操作，把代码

String dir = request.getSession().getServletContext().getRealPath("/WEB-INF/");
//PrintWriter printWriter = new PrintWriter(new FileWriter(new File(dir,"index.html")));

替换成

String dir = request.getSession().getServletContext().getRealPath("/WEB-INF/index.html");
        OutputStreamWriter writer = new OutputStreamWriter(new FileOutputStream(dir), "UTF-8");
        PrintWriter printWriter = new PrintWriter(writer);

后启动程序

乱码解决了，很开心！

freemarker页面静态化步骤以及相关注意事项

Freemarker

导入坐标

org.freemarker
freemarker
2.3.23

创建模板文件

<#--我只是一个注释，我不会有任何输出 -->
${name}你好，${message}

生成文件

public static void main(String[] args) throws Exception{
//1.创建配置类
Configuration configuration=new Configuration(Configuration.getVersion());
//2.设置模板所在的目录
configuration.setDirectoryForTemplateLoading(new File("D:\\ftl"));
//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对象
//   // 指定输出编码格式 utf-8
        Writer writer = new BufferedWriter(new OutputStreamWriter(new FileOutputStream ("d:\\ftl\\test.html"),"UTF-8"));
//Writer out =new FileWriter(new File("d:\\test.flt"));
//7.输出
template.process(map, out);
//8.关闭Writer对象
out.close();
}

例子

分析

前面我们已经学习了Freemarker的基本使用方法，下面我们就可以将Freemarker应用到项目中，帮我们生成移动端套餐列表静态页面和套餐详情静态页面。

接下来我们需要思考几个问题：

（0）那些页面应该静态化? 数据不经常发生变化,访问量大的

（1）什么时候生成静态页面比较合适呢？

（2）将静态页面生成到什么位置呢？

（3）应该生成几个静态页面呢？

• 对于第一个问题，应该是当套餐数据发生改变时，需要生成静态页面，即我们通过后台系统修改套餐数据（包括新增、删除、编辑）时。
• 对于第二个问题，如果是在开发阶段可以将文件生成到项目工程中，如果上线后可以将文件生成到移动端系统运行的tomcat中。
• 对于第三个问题，套餐列表只需要一个页面就可以了，在这个页面中展示所有的套餐列表数据即可。套餐详情页面需要有多个，即一个套餐应该对应一个静态页面。

模板

mobile_setmeal.ftl

    
    
    
    
    
    
    
    
    



    
    

        
        大鹅健康
        
    
    
    

        

            

                <#list setmealList as setmeal>
                    

                        
                            
                            

                                
${setmeal.name}
                                
${setmeal.remark}
                                

                                    
                                        <#if setmeal.sex == '0'>
                                            性别不限
                                        <#else>
                                            <#if setmeal.sex == '1'>
                                                男
                                            <#else>
                                                女
                                            
                                        
                                    
                                    ${setmeal.age}
                                
                            
                        
                    
                
            
        
    

模板

    
    
    
    
    
    
    
    
    
    
    
    



    
    

        
        大鹅健康
        
    
    
    

        

            

                
            
            

                
${setmeal.name}
                
${setmeal.remark}
                

                    
                        <#if setmeal.sex == '0'>
                            性别不限
                        <#else>
                            <#if setmeal.sex == '1'>
                                男
                            <#else>
                                女
                            
                        
                    
                    ${setmeal.age}
                
            
        
        

            

                
                套餐详情
            
            

                

                    
项目名称
                    
项目内容
                    
项目解读
                
                

                    

                        <#list setmeal.checkGroups as checkgroup>
                            

                                
${checkgroup.name}
                                

                                    <#list checkgroup.checkItems as checkitem>
                                        
                                            ${checkitem.name}
                                        
                                    
                                
                                
${checkgroup.remark}
                            
                        
                    
                
                

                    立即预约
                
            
        
    

配置文件

（1）在health_service_provider工程中创建属性文件freemarker.properties 通过上面的配置可以指定将静态HTML页面生成的目录位置

out_put_path=静态页面生成的位置

在spring的中进行配置

13 java 代码

   @Autowired
    private SetmealDao setmealDao;
    @Autowired
    private JedisPool jedisPool;
    @Autowired
    private CheckGroupDao checkGroupDao;
    @Autowired
    private CheckItemDao checkItemDao;
    @Autowired
    private FreeMarkerConfigurer freeMarkerConfigurer;
    @Value("${out_put_path}")
    private String outPutPath;//从属性文件中读取要生成的html对应的目录
//新增套餐，同时关联检查组
    public void add(Setmeal setmeal, Integer[] checkgroupIds) {
        setmealDao.add(setmeal);
        Integer setmealId = setmeal.getId();//获取套餐id
        this.setSetmealAndCheckGroup(setmealId,checkgroupIds);
        //完成数据库操作后需要将图片名称保存到redis
        jedisPool.getResource().sadd(RedisConstant.SETMEAL_PIC_DB_RESOURCES,setmeal.getImg());

        //当添加套餐后需要重新生成静态页面（套餐列表页面、套餐详情页面）
        generateMobileStaticHtml();
    }

    //生成当前方法所需的静态页面
    public void generateMobileStaticHtml(){
        //在生成静态页面之前需要查询数据
        List list = setmealDao.findAll();

        //需要生成套餐列表静态页面
        generateMobileSetmealListHtml(list);

        //需要生成套餐详情静态页面
        generateMobileSetmealDetailHtml(list);
    }

    //生成套餐列表静态页面
    public void generateMobileSetmealListHtml(List list){
        Map map = new HashMap();
        //为模板提供数据，用于生成静态页面
        map.put("setmealList",list);
        generteHtml("mobile_setmeal.ftl","m_setmeal.html",map);
    }

    //生成套餐详情静态页面（可能有多个）
    public void generateMobileSetmealDetailHtml(List list){
        for (Setmeal setmeal : list) {
            Map map = new HashMap();
            map.put("setmeal",setmealDao.findById4Detail(setmeal.getId()));
            generteHtml("mobile_setmeal_detail.ftl","setmeal_detail_" + setmeal.getId() + ".html",map);
        }
    }

    //通用的方法，用于生成静态页面
    public void generteHtml(String templateName,String htmlPageName,Map map){
        Configuration configuration = freeMarkerConfigurer.getConfiguration();//获得配置对象
        Writer out = null;
        try {
            Template template = configuration.getTemplate(templateName);
            //构造输出流
            // 中文乱码  
            //out = new BufferedWriter (new OutputStreamWriter (new FileOutputStream (outPutPath + "/" + htmlPageName),"UTF-8"));            //构造输出流
            out = new FileWriter(new File(outPutPath + "/" + htmlPageName));
            //输出文件
            template.process(map,out);
            out.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

生成静态页面的通用方法

    //通用的方法，用于生成静态页面(参数:templateName:模板,htmlPageName:生成的文件名称,Map:数据)
    public void generteHtml(String templateName,String htmlPageName,Map map){
        Configuration configuration = freeMarkerConfigurer.getConfiguration();//获得配置对象
        Writer out = null;
        try {
            Template template = configuration.getTemplate(templateName);
            //构造输出流
            // 中文乱码  
            //out = new BufferedWriter (new OutputStreamWriter (new FileOutputStream (outPutPath + "/" + htmlPageName),"UTF-8"));            //构造输出流
            out = new FileWriter(new File(outPutPath + "/" + htmlPageName));
            //输出文件
            template.process(map,out);
            out.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

14 -测试

  public void genById(Integer setmealId){
        Map map = new HashMap();
        map.put("setmeal",setmealDao.findById4Detail(setmealId));
        generteHtml("mobile_setmeal_detail.ftl","setmeal_detail_" + setmealId + ".html",map);
    }

总结

1导入写好的模板文件(放置到服务的提供方的WEB-INF下创建的ftl文件夹中)

2配置freemarker的静态页面生成的地方,在spring的配置文件中配置freemarker的相关bean的配置.

3判断在什么情况下生成静态页面比较合适,一般为数据改变的是时候生成(例如:信息的增加,修改,删除)并修改相关的实现方法.

4.运行程序,增加,修改,删除信息,调用静态化方法进行页面生成.(基本流程:增加,修改,删除信息–>查询数据库获取到相应的数据–>调用生成静态页面的通用方法进行页面的生成).

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。