在 Spring Boot 中使用 MyBatis
我们用一个获取排行榜的小应用作为例子。
依赖与配置
- 引入所依赖的类库，在 MyBatis 的官网可以找到。接着引入 h2 数据库所需的类库。
org.mybatis.spring.boot
mybatis-spring-boot-starter
2.1.3
com.h2database
h2
1.4.200
- 配置 datasource
对于 Spring Boot 来说，需要进行一些配置，将 application.properties 放在 src/main/resources 下。在官方文档中可以找到。
spring.datasource.url=jdbc:h2:file:./target/test
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=org.h2.Driver
- 配置 flyway 自动化迁移插件以及 sql 初始化语句
在 src/main/resources/db/migration 下创建 V1__CreateTables.sql 用于初始化数据库（一定注意这里是两个下划线，踩过坑）。运行 mvn flyway:migrate 初始化数据库。这里不赘述细节。
create table user
(
id bigint primary key auto_increment,
name varchar(100)
)
create table match
(
id bigint primary ket auto_increment,
user_id bigint,
score int
)
insert into user (id, name) values (1, 'AAA');
insert into user (id, name) values (2, 'BBB');
insert into user (id, name) values (3, 'CCC');
insert into match (id, user_id, score) values (1, 1, 1000);
insert into match (id, user_id, score) values (2, 1, 2000);
insert into match (id, user_id, score) values (3, 2, 500);
insert into match (id, user_id, score) values (4, 3, 300);
org.flywaydb
flyway-maven-plugin
7.4.0
jdbc:h2:file:./target/test
root
root
- 配置 MyBatis
在 application.properties 中加入
mybatis.config-location = classpath:db/mybatis/config.xml
在 db/mybatis/config.xml 中写入 mybatis 配置，同样我们在官网抄。值得注意的是我们在Spring datasource中已经配置好了环境，所以mybatis中的
两种方式使用 MyBatis
- 注解
注意这里是接口不是类
@Mapper
public interface UserMapper {
@Select("select * from user where id = #{id}")
User getUserById(@Param("id") Integer id);
}
在config.xml 中加入mapper
@RestController
public class HelloController {
@Autowired
private UserMapper userMapper;
@RequestMapping("/")
@ResponseBody
public Object index() {
return userMapper.getUserById(1);
}
}
- xml
我们使用 xml 写好 mapper。
如何让 Spring 容器知道一个类是一个Bean（可以被注入，需要被注入等），一种简单的方法就是在 class 上使用注解 @Service 或者 @Component。换一句话说只有声明了 @Service，Bean才能被识别或是自动 Autowired。还有一种较为复杂的声明 Bean 的方式，这里先不展开。现在问题来了，我们知道在使用MyBatis时，我们需要一个 SqlSessionFactory 和一个 SqlSession 才能完成一系列 select 操作。但是在 Spring Boot 中这些东西从哪来呢？既然我们在使用 Spring，那么所有的依赖都需要 Spring 自动帮我们完成，这个时候非常简单。我们只需要自动注入一个 SqlSession 就好了，Spring 会自动帮你完成依赖的装配和注入，然后就直接用它吧。
@Service
public class RankDao {
@Autowired
private SqlSession sqlSession;
public List getRank() {
return sqlSession.selectList("MyMapper.selectRank");
}
}
@Service
public class RankService {
@Autowired
private RankDao rankDao;
public List getRank() {
return rankDao.getRank();
}
}
@RestController
public class HelloController {
@Autowired
private RankService rankService;
@RequestMapping("/")
@ResponseBody
public Object index() {
return rankService.getRank();
}
}
页面渲染
后端渲染
我们考虑使用模板引擎，模板引擎有 freemaker、jsp、velocity 。目前最流行的模板引擎是 Freemaker。与 MyBatis 相似，Freemaker 也有一个 spring-boot-starter-freemaker 的依赖类库。我们需要在 resources/templates 目录下创建 .ftlh 格式的模板文件，还需要排行榜的数据。我们称这种响应 HTTP 的方式叫做 Model And View。有如下的写法：
// html.ftlh
排行榜
排名
名字
分数
${index}
${name}
${score}
@RestController
public class HelloController {
@RequestMapping("/")
public ModelAndView index() {
Map model = new HashMap<>();
model.put("index", 1);
model.put("name", "Zhang San");
model.put("score", 1000);
return new ModelAndView("index", model);
}
}
根据 Freemaker 的语法，把所有数据填上去就可以了。
排行榜
排名
名字
分数
<#list items as item>
${item?index+1}
${item.user.name}
${item.score}
@RestController
public class HelloController {
@Autowired
private RankService rankService;
@RequestMapping("/")
public ModelAndView index() {
List items = rankService.getRank();
Map> model = new HashMap<>();
model.put("items", items);
return new ModelAndView("index", model);
}
}
前段渲染
使用 JS 和 JSON 异步请求进行前端渲染。在 resources/static 下创建 index.html。Spring 规定在resource/static 目录下的文件可以直接访问。前端只需要用 ajax 访问某个接口获取数据，前端使用 js 动态的把数据加载到 html 上。