体检管理系统——页面静态化( Freemarker)

1. 页面静态化介绍
   页面静态化其实就是将原来的动态网页(例如通过ajax请求动态获取数据库中的数据并展示的网页)改为 通过静态化技术生成的静态网页，这样用户在访问网页时，服务器直接给用户响应静态html页面，没有 了动态查询数据库的过程。
   那么这些静态HTML页面还需要我们自己去编写吗？其实并不需要，我们可以通过专门的页面静态化技 术帮我们生成所需的静态HTML页面，例如：Freemarker、thymeleaf等。

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

3. Freemarker入门案例
   3.1 环境搭建
   创建maven工程并导入Freemarker的maven坐标
   
   
   org.freemarker
   freemarker
   2.3.28
   
   

3.2 创建模板文件
模板文件中有四种元素：
1、文本，直接输出的部分
2、注释，即<#–…-->格式不会输出
3、插值（Interpolation）：即${…}部分, 将使用数据模型中的部分替代输出
4、FTL指令：FreeMarker指令，和HTML标记类似，名字前加#予以 区分，不会输出
Freemarker的模板文件后缀可以任意，一般建议为ftl

3.3 生成文件
使用步骤：
第一步：创建一个 Configuration 对象，直接 new 一个对象。构造方法的参数就是 freemarker的版本 号。
第二步：设置模板文件所在的路径。
第三步：设置模板文件使用的字符集。一般就是 utf-8。
第四步：加载一个模板，创建一个模板对象。
第五步：创建一个模板使用的数据集，可以是 pojo 也可以是 map。一般是 Map。 第六步：创建一个 Writer 对象，一般创建 FileWriter 对象，指定生成的文件名。
第七步：调用模板对象的 process 方法输出文件。
第八步：关闭流。

public class FreeMarkerDemo {
public static void main(String[] args) throws IOException, TemplateException {
// 3.3 生成文件
// 使用步骤：
// 第一步：创建一个 Configuration 对象，直接 new 一个对象。构造方法的参数就是 freemarker的版本 号。
Configuration configuration = new Configuration(Configuration.getVersion());
// 第二步：设置模板文件所在的路径。
configuration.setDirectoryForTemplateLoading(new File(“E:\freemaker”));
// 第三步：设置模板文件使用的字符集。一般就是 utf-8。
configuration.setDefaultEncoding(“utf-8”);
// 第四步：加载一个模板，创建一个模板对象。
Template template = configuration.getTemplate(“demo.ftl”);
// 第五步：创建一个模板使用的数据集，可以是 pojo 也可以是 map。一般是 Map。
Map<String,String> map = new HashMap<String, String>(16);
map.put(“name”,“流年”);
map.put(“message”,“hello freemarker”);
// 第六步：创建一个 Writer 对象，一般创建 FileWriter 对象，指定生成的文件名。
Writer writer = new FileWriter(new File(“E:\freemaker\test.html”));
// 第七步：调用模板对象的 process 方法输出文件。
template.process(map,writer);
// 第八步：关闭流。
writer.close();
}
}

4.1 assign指令
assign指令用于在页面上定义一个变量
（1）定义简单类型
<#assign username=“高先生”>
联系人：KaTeX parse error: Expected 'EOF', got '#' at position 31: …r> （2）定义对象类型 <#̲assign info={"n…{info.name} 年龄: ${info.age}
4.2 include指令
include指令用于模板文件的嵌套
（1）创建模板文件head.ftl
（2）修改入门案例中的test.ftl，在test.ftl模板文件中使用include指令引入上面的模板文件

4.3 if指令
if指令用于判断
（1）在模板文件中使用if指令进行判断
<#if flag==true>
登录成功
<#else>
登录失败
</#if>

（2）在java代码中为success变量赋值
map.put(“flag”,true);
在freemarker的判断中，可以使用= 也可以使用==

4.4 list指令
list指令用于遍历
（1）在模板文件中使用list指令进行遍历
<#list goodsList as goods>
姓名 ${goods.name} 年龄 ${goods.age}

</#list>
(2）在java代码中为goodsList赋值
/使用list集合装载每一个对象/
List<Map<String,String>> goodsList = new ArrayList<Map<String, String>>();
/使用map集合封装对象的属性/
Map<String,String> goods1 = new HashMap<String,String> ();
goods1.put(“name”,“张三”);
goods1.put(“age”,“18”);
Map<String,String> goods2 = new HashMap<String,String> ();
goods2.put(“name”,“李四”);
goods2.put(“age”,“20”);
Map<String,String> goods3 = new HashMap<String,String> ();
goods3.put(“name”,“王五”);
goods3.put(“age”,“30”);
goodsList.add(goods1);
goodsList.add(goods2);
goodsList.add(goods3);
/将集合放入到模板中/
map.put(“goodsList”,goodsList);

Freemarker使用小结
1.什么是网页静态化技术
随着用户访问量以及数据量的增大，网页静态化技术方案如今越来越流行。
什么是网页静态化技术呢？简单来说就是将网页以纯静态方式的形式展现。
2.网页静态化技术与缓存技术的比较
共同点：都可以减小数据库的访问压力。
区别：
(1)缓存技术适用于小规模的数据。以及一些经常变动的数据。
(2)网页静态化技术适用于大规模但是变化不太频繁的数据。
3.网页静态化技术的应用场景
(1)新闻门户网站的文章类型频道一般都用到了网页静态化技术。点击新闻直接会跳到静态化的页面。
(2)电商网站的商品详情页也十分常用，我们在存储商品的时候会生成静态化页面，点击商品详情，会直接跳到生成的商品详情的静态化页面。
(3)网页静态化技术可以结合Nginx这种高性能web服务器来提高并发访问量。
4.什么是FreeMarker
FreeMarker是一款用Java语言编写的模板引擎，用它可以通过模板和要改变的数据来生成输出文本(例如HTML网页，配置文件，源代码等)，作为用来实现网页静态化技术的一种手段。FreeMarker的使用率大大超过其他一些技术。对于系统中频繁使用数据库进行查询但是内容更新很小的应用，都可以用FreeMarker将网页静态化，这样就避免了大量的数据库访问请求，从而提高网站的性能。

当套餐发生了修改，可以使用定时任务定时删除没有关联的页面

freemarker应用：
1 环境搭键
1.在health_common工程的pom文件中导入Freemarker的maven坐标

org.freemarker
freemarker
2.3.28

2 创建模板文件
在health_service_provider工程的WEB-INF目录中创建ftl目录，在ftl目录中创建模板文件 mobile_setmeal.ftl和mobile_setmeal_detail.ftl文件，前者是用于生成套餐列表页面的模板文件，后者 是生成套餐详情页面的模板文件

3 配置文件
（1）在health_service_provider工程中创建属性文件freemarker.properties

通过上面的配置可以指定将静态HTML页面生成的目录位置

4 生成静态页
修改health_service_provider工程中的SetmealServiceImpl类的add方法，加入生成静态页面的逻辑

@Autowired
private JedisPool jedisPool;
@Autowired
private SetmealDao setmealDao;
@Autowired
private FreeMarkerConfigurer freeMarkerConfigurer;

@Value("${out_put_path}")
private String outPutPath;

/**

• 添加一条套餐数据

• @param setmeal 套餐基本数据

• @param checkgroupIds 套餐和检查组关联关系数据
  */
  @Override
  public void add(Setmeal setmeal, int[] checkgroupIds) {
  // 调用dao添加一条套餐数据
  setmealDao.addSetMeal(setmeal);
  // 添加套餐和检查组关系
  this.addSetMealAndCheckGroup(setmeal, checkgroupIds);

  // 套餐添加成功后，将图片的名称在redis进行保留一份
  jedisPool.getResource().sadd(RedisConstant.SETMEAL_PIC_DB_RESOURCES, setmeal.getImg());

  // 当套餐新增时，调用生成静态页面的方法
  generateMobileStaticHtml();
  }

/**

• 生成当前方法所需的静态页面
  */
  public void generateMobileStaticHtml(){
  // 查询出所有的套餐数据
  List setmealList = setmealDao.findAll();
  // 调用生成套餐列表的方法
  generateMobileSetmealListHtml(setmealList);
  // 调用生成套餐详情页面的方法
  generateMobileSetmealDetailHtml(setmealList);
  }

/**

• 生成套餐列表页面静态方法
• @param setmealList 传递生成套餐列表查询出的数据
  */
  public void generateMobileSetmealListHtml(List setmealList) {
  // 为模板提供数据
  Map<String, Object> map = new HashMap<String, Object>(16);
  map.put(“setmealList”, setmealList);
  // 调用生成页面的方法，生成页面
  generateHtml(“mobile_setmeal.ftl”, “m_setmeal.html”, map);
  }

/**

• 生成套餐详情页面静态方法(多个)
  */
  public void generateMobileSetmealDetailHtml(List setmealList) {
  // 遍历得到每一个套餐
  for (Setmeal setmeal : setmealList) {
  // 为模板提供数据
  Map<String, Object> map = new HashMap<String, Object>(16);
  // 根据id 查询详细的套餐信息 存储到map 中
  map.put(“setmeal”, findById(setmeal.getId()));
  // 动态生成套餐的页面名称
  generateHtml(“mobile_setmeal_detail.ftl”, “setmeal_detail_” + setmeal.getId() + “.html”, map);
  }
  }

/**

• 用来生成静态页面的通用方法
• @param templateName 模板类的名称
• @param htmlPageName 生成的页面的名称
• @param map 传递过来的封装了数据的map集合
  */
  public void generateHtml(String templateName, String htmlPageName, Map<String, Object> map) {
  // 通过freeMarkerConfigurer 获取configuration对象
  Configuration configuration = freeMarkerConfigurer.getConfiguration();
  // 定义一个输出流
  Writer out = null;
  try {
  // 通过configuration 获取模板类的对象 加载模板文件
  Template template = configuration.getTemplate(templateName);
  // 定义生成的文件的名称
  File file = new File(outPutPath + “/” + htmlPageName);
  // 生成数据
  out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(file)));
  // 输出文件
  template.process(map, out);
  } catch (Exception e) {
  e.printStackTrace();
  } finally {
  try {
  if (out != null) {
  out.flush();
  out.close();
  }
  } catch (IOException e) {
  e.printStackTrace();
  }
  }
  }