(三)SpringBoot2.0整合Freemarker，jsp及全局捕获异常
SpringBoot2.0整合Freemarker，jsp及全局捕获异常
- 一. 静态资源访问
- 二. 渲染Web页面
- 三. 使用Freemarker模板引擎渲染web视图
- 3.1 pom文件引入
- 3.2 后台代码
- 3.3 前台代码
- 3.4 application.yml配置Freemarker
- 四. 使用JSP渲染Web视图
- 4.1 pom依赖
- 4.2 application.yml配置jsp
- 4.3 后台代码
- 4.4 前台代码
- 五. 全局捕获异常
一. 静态资源访问
在我们开发Web应用的时候，需要引用大量的js、css、图片等静态资源。
默认配置
Spring Boot默认提供静态资源目录位置需置于classpath下，目录名需符合如下规则：
/static
/public
/resources
/META-INF/resources
举例：我们可以在src/main/resources/目录下创建static，在该位置放置一个图片文件。启动程序后，尝试访问http://localhost:8080/test.jpg。如能显示图片，配置成功。
二. 渲染Web页面
渲染Web页面
在之前的示例中，我们都是通过@RestController来处理请求，所以返回的内容为json对象。那么如果需要渲染html页面的时候，要如何实现呢？
模板引擎
在动态HTML实现上Spring Boot依然可以完美胜任，并且提供了多种模板引擎的默认配置支持，所以在推荐的模板引擎下，我们可以很快的上手开发动态网站。
Spring Boot提供了默认配置的模板引擎主要有以下几种：
• Thymeleaf
• FreeMarker
• Velocity
• Groovy
• Mustache
Spring Boot建议使用这些模板引擎，避免使用JSP，若一定要使用JSP将无法实现Spring Boot的多种特性，具体可见后文：支持JSP的配置
当你使用上述模板引擎中的任何一个，它们默认的模板配置路径为：src/main/resources/templates。当然也可以修改这个路径，具体如何修改，可在后续各模板引擎的配置属性中查询并修改。
三. 使用Freemarker模板引擎渲染web视图
3.1 pom文件引入
<!-- 引入freeMarker的依赖包. -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
3.2 后台代码
注意：由于是要返回到页面，所以不能再用@RestController，要用@Controller
@Controller
@Slf4j
public class IndexController {
/**
* Freemarker请求入口
* @param map
* @return
*/
@RequestMapping("/ftlIndex")
public String fltIndex(Map<String, Object> map) {
map.put("userName", "何金荣");
map.put("sex", "1");
List<String> listResult = Lists.newArrayList();
listResult.add("张三");
listResult.add("李四");
listResult.add("五老五");
map.put("listResult", listResult);
return "ftlIndex";
}
}
3.3 前台代码
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8"/>
<title>首页</title>
</head>
<body>
您好，${userName}，这是我的第一个Freemarker页面<br>
<#if sex=="1">
男
<#elseif sex=="2">
女
<#else>
其他
</#if>
<br>
用户列表：<br>
<#list listResult as user>
<span>${user}</span>
</#list>
</body>
</html>
3.4 application.yml配置Freemarker
# Freemarker相关配置
spring:
freemarker:
allow-request-override: false
cache: true
check-template-location: true
charset: UTF-8
content-type: text/html
expose-request-attributes: false
expose-session-attributes: false
expose-spring-macro-helpers: false
suffix: .ftl
template-loader-path: classpath:/templates/
四. 使用JSP渲染Web视图
4.1 pom依赖
由于是jsp页面，所以web依赖必须引入
<!-- SpringBoot web 核心组件 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
</dependency>
<!-- SpringBoot 外部tomcat支持 -->
<dependency>
<groupId>org.apache.tomcat.embed</groupId>
<artifactId>tomcat-embed-jasper</artifactId>
</dependency>
4.2 application.yml配置jsp
# Jsp页面配置
spring:
mvc:
view:
prefix: /WEB-INF/jsp/
suffix: .jsp
4.3 后台代码
注意:
SpringBoot2.0之前：
创建SpringBoot整合JSP，一定要为war类型，否则会找不到页面.
不要把JSP页面存放在resources// jsp 不能被访问到
SpringBoot2.0之后：
设置为jar也是OK的，但是打包部署到服务器上就要设置为war
/**
* Jsp请求入口
* @param map
* @return
*/
@RequestMapping("/jspIndex")
public String jspIndex(Map<String, Object> map) {
map.put("currentUserName", "何金荣");
List<UserEntity> listResult = Lists.newArrayList(
new UserEntity("111", "古天乐"),
new UserEntity("222", "胡歌"),
new UserEntity("333", "黄功利")
);
map.put("userList", listResult);
return "jspIndex";
}
4.4 前台代码
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ taglib uri="http://java.sun.com/jsp/jstl/functions" prefix="fn" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="viewport" content="width=device-width,minimum-scale=1.0,maximum-scale=1.0"/>
<title>JSP页面</title>
</head>
<body>
当前用户：${currentUserName}<br>
用户列表：<br>
<c:forEach items="${userList}" var="item">
<div class="plateItem">${item.userName}</div>
</c:forEach>
</body>
</html>
五. 全局捕获异常
@ExceptionHandler 表示拦截异常
1. @ControllerAdvice 是 controller 的一个辅助类，最常用的就是作为全局异常处理的切面类
2. @ControllerAdvice 可以指定扫描范围
3. @ControllerAdvice 约定了几种可行的返回值，如果是直接返回 model 类的话，需要使用
@ResponseBody 进行 json 转换
o 返回 String，表示跳到某个 view
o 返回 modelAndView
o 返回 model + @ResponseBody
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(RuntimeException.class)
@ResponseBody
public Map<String, Object> exceptionHandler() {
Map<String, Object> map = new HashMap<String, Object>();
map.put("errorCode", "101");
map.put("errorMsg", "系統错误!");
return map;
}
}
下一篇：(四)SpringBoot2.0-Access denied for user ‘’@‘localhost’ to database