前序步骤
创建Spring Boot项目并配置完成MyBatis,已经可以正常使用。下面在Spring Boot项目中整合JSP页面进行使用。
Maven中引入JSP依赖
在项目的pom文件中加入如下两个JSP需要的依赖:
<!-- 配置JSP依赖 -->
<dependency>
<groupId>org.apache.tomcat.embed</groupId>
<artifactId>tomcat-embed-jasper</artifactId>
<!-- <scope>provided</scope> -->
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jstl</artifactId>
</dependency>
配置JSP相关目录
1. 创建JSP页面目录
在默认创建的Spring Boot项目中需要创建如下的JSP需要的目录,用于存放项目的JSP页面:
其中,src/main/webapp/WEB-INF/目录为必须要手动创建的,否则JSP页面将找不到。
2. 配置Spring Boot项目的配置文件
在applicatio.properties配置文件中进行如下设置:
# JSP配置
spring.mvc.view.prefix=/WEB-INF/jsp/
spring.mvc.view.suffix=.jsp
相对应的,prefix指向上面创建的JSP页面的存放目录,suffix指向页面文件的后缀扩展名为.jsp。
创建Controller和JSP页面进行测试
在项目中创建如下的controller进行测试:
@RestController
@RequestMapping("/web")
public class IndexController {
@Autowired
private UserService userService;
@RequestMapping("/index")
public ModelAndView index() {
User user = userService.getUserById(1L);
ModelAndView result = new ModelAndView();
result.setViewName("index");
result.addObject("user", user);
return result;
}
}
在/WEB-INF/jsp/目录下创建index.jsp页面文件,将查询得到的Id为1的用户名输入到页面中显示:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
User: ${user.userName}
</body>
</html>
启动Spring Boot项目后,在浏览器中输入对应的请求URL进行测试:
到此整合完成。
常见问题
在进行上述过程中,在最后输入URL进行测试过程中,出现了如下的异常:
该问题为找不到对应的请求路径。问题原因:为在上述配置JSP的依赖时将如下依赖的scope设置为了provided,这样会导致编译后Tomcat找不到相应的JSP文件。
<dependency>
<groupId>org.apache.tomcat.embed</groupId>
<artifactId>tomcat-embed-jasper</artifactId>
<scope>provided</scope> # 这里的问题
</dependency>
所以,解决方法为:将上述的scope配置项注释掉即可(在上述过程中已经正确配置)。
此外,该问题的也可能包含如下其他原因:
- 启动类application放置的位置不对。解决方法:将该类放置到其他所有包的最外层(spring-boot会自动加载启动类所在包下及其子包下的所有组件),使Spring Boot默认的扫描机制可以生效,或者在启动类中配置scanBasePackages。
- Controller中RequestMapping和输入的URL不匹配。解决方法:仔细核对,并将修改为一致。