springboot使用Mybatis(xml和注解)过程全解析

刚毕业的第一份工作是 java 开发，项目中需要用到 mybatis，特此记录学习过程，这只是一个简单 demo，mybatis 用法很多不可能全部写出来，有更复杂的需求建议查看 mybatis 的官方中文文档，点击跳转。下面时项目环境/版本。

创新互联成立以来不断整合自身及行业资源、不断突破观念以使企业策略得到完善和成熟，建立了一套“以技术为基点，以客户需求中心、市场为导向”的快速反应体系。对公司的主营项目，如中高端企业网站企划 / 设计、行业 / 企业门户设计推广、行业门户平台运营、app软件开发、移动网站建设、微信网站制作、软件开发、成都服务器托管等实行标准化操作，让客户可以直观的预知到从创新互联可以获得的服务效果。

•开发工具：IDEA
•jdk 版本：1.8
•springboot 版本：2.03

其他依赖版本见下面 pom.xml:

 <?xml version="1.0" encoding="UTF-8"?>

 4.0.0
 com.example
 mybatis-test
 0.0.1-SNAPSHOT
 jar
 mybatis-test
 Demo project for Spring Boot
 
  org.springframework.boot
  spring-boot-starter-parent
  2.0.3.RELEASE
   
 
 
  UTF-8
  UTF-8
  1.8
 
 
  
   org.springframework.boot
   spring-boot-starter-web
  
  
   MySQL
   mysql-connector-java
   runtime
  
  
  
   org.mybatis.spring.boot
   mybatis-spring-boot-starter
   1.3.2
  
  
  
   com.alibaba
   druid-spring-boot-starter
   1.1.9
  
  
  
   com.github.pagehelper
   pagehelper-spring-boot-starter
   1.2.5
  
  
   org.springframework.boot
   spring-boot-starter-test
   test
  
 
 
  
   
    org.springframework.boot
    spring-boot-maven-plugin

1.创建项目

使用 idea 中的 spring initializr 生成 maven 项目，项目命令为 mybatis-test，选择 web，mysql，mybatis 依赖，即可成功。（详细过程不赘述，如有需要学习 springboot 创建过程，可参考这篇文章。

然后依照上面的 pom 文件，补齐缺少的依赖。接着创建包 entity，service 和 mybatis 映射文件夹 mapper，创建。为了方便配置将 application.properties 改成 application.yml。由于我们时 REST 接口，故不需要 static 和 templates 目录。修改完毕后的项目结构如下：

springboot使用Mybatis(xml和注解)过程全解析

项目结构

修改启动类，增加@MapperScan("com.example.mybatistest.dao"),以自动扫描 dao 目录，避免每个 dao 都手动加@Mapper注解。代码如下：

@SpringBootApplication
@MapperScan("com.example.mybatistest.dao")
public class MybatisTestApplication {
 public static void main(String[] args) {
  SpringApplication.run(MybatisTestApplication.class, args);
 }
}

修改 application.yml,配置项目，代码如下：

mybatis:
 #对应实体类路径
 type-aliases-package: com.example.mybatistest.entity
 #对应mapper映射文件路径
 mapper-locations: classpath:mapper/*.xml
#pagehelper物理分页配置
pagehelper:
 helper-dialect: mysql
 reasonable: true
 support-methods-arguments: true
 params: count=countSql
 returnPageInfo: check
server:
 port: 8081
spring:
 datasource:
 name: mysqlTest
 type: com.alibaba.druid.pool.DruidDataSource
 #druid连接池相关配置
 druid:
  #监控拦截统计的filters
  filters: stat
  driver-class-name: com.mysql.jdbc.Driver
  url: jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=utf-8&useSSL=true
  username: root
  password: 123456
  #配置初始化大小，最小，最大
  initial-size: 1
  min-idle: 1
  max-active: 20
  #获取连接等待超时时间
  max-wait: 6000
  #间隔多久检测一次需要关闭的空闲连接
  time-between-eviction-runs-millis: 60000
  #一个连接在池中的最小生存时间
  min-evictable-idle-time-millis: 300000
  #打开PSCache，并指定每个连接上PSCache的大小。oracle设置为true，mysql设置为false。分库分表设置较多推荐设置
  pool-prepared-statements: false
  max-pool-prepared-statement-per-connection-size: 20
 http:
 encoding:
  charset: utf-8
  enabled: true

2.编写代码

首先创建数据表，sql 语句如下：

CREATE TABLE `user` (
 `id` int(11) NOT NULL AUTO_INCREMENT,
 `name` varchar(255) NOT NULL,
 `age` tinyint(4) NOT NULL DEFAULT '0',
 `password` varchar(255) NOT NULL DEFAULT '123456',
 PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=0 DEFAULT CHARSET=utf8;

然后在 entity 包中创建实体类 User.java

public class User {
 private int id;
 private String name;
 private int age;
 private String password;
 public User(int id, String name, int age, String password) {
  this.id = id;
  this.name = name;
  this.age = age;
  this.password = password;
 }
 public User(){}
 //getter setter自行添加
}

在 dao 包下创建 UserDao.java

public interface UserDao {
 //插入用户
 int insert(User user);
 //根据id查询
 User selectById(String id);
 //查询所有
 List selectAll();
}

在 mapper 文件夹下创建 UserMapper.xml,具体的 xml 编写方法查看文首的官方文档。

<?xml version="1.0" encoding="utf-8" ?>


 
  user
 
 
  id,name,age,password
 
 
  INSERT INTO 
  
   name,password,
   
    age
   
  
  
   #{name,jdbcType=VARCHAR},#{password},
   
    #{age}

至此使用 mybatis 的代码编写完了，之后要用时调用 dao 接口中的方法即可。

3.测试

我们通过编写 service，controller 然后使用 postman 进行测试。

首先编写 UserService.java,代码如下：

@Component
public class UserService {
 @Autowired
 private UserDao userDao;
 public User getByUserId(String id){
  return userDao.selectById(id);
 }
 //获取全部用户
 public List getAll(){
  return userDao.selectAll();
 }
 //测试分页
 public PageInfo getAll(int pageNum,int pageSize){
  PageHelper.startPage(pageNum,pageSize);
  List users = userDao.selectAll();
  System.out.println(users.size());
  PageInfo result = new PageInfo<>(users);
  return result;
 }
 public int insert(User user){
  return userDao.insert(user);
 }
}

编写 UserController.java

@RestController
public class UserController {
 @Autowired
 private UserService userService;
 @GetMapping("/user/{userId}")
 public User getUser(@PathVariable String userId){
  return userService.getByUserId(userId);
 }
 @GetMapping("/user")
 public List getAll(){
  return userService.getAll();
 }
 @GetMapping("/user/page/{pageNum}")
 public Object getPage(@PathVariable int pageNum,
       @RequestParam(name = "pageSize",required = false,defaultValue = "10") int pageSize){
  return userService.getAll(pageNum,pageSize);
 }
 @PostMapping("/user")
 public Object addOne(User user){
  userService.insert(user);
  return user;
 }
}

启动项目，通过 postman 进行请求测试，测试结果如下：

•插入数据：

springboot使用Mybatis(xml和注解)过程全解析

•查询数据

springboot使用Mybatis(xml和注解)过程全解析

•分页查询

springboot使用Mybatis(xml和注解)过程全解析

4.注解编写 sql

上面使用的是 xml 方式编写 sql 代码，其实 mybatis 也支持在注解中编写 sql，这样可以避免编写复杂的 xml 查询文件，但同时也将 sql 语句耦合到了代码中，也不易实现复杂查询，因此多用于简单 sql 语句的编写。

要使用注解首先将 applicaton.yml 配置文件中的mapper-locations: classpath:mapper/*.xml注释掉。然后在 UserDao.java 中加入 sql 注解，代码如下：

public interface UserDao {
 //插入用户
 @Insert("insert into user(name,age,password) value(#{name},#{age},#{password})")
 @Options(useGeneratedKeys=true,keyColumn="id",keyProperty="id")
 int insert(User user);
 //根据id查询
 @Select("select * from user where id=#{id}")
 User selectById(String id);
 //查询所有
 @Select("select * from user")
 List selectAll();
}

然后重新启动项目测试，测试结果跟上面完全一样。

本文原创发布于：https://www.tapme.top/blog/detail/2018-09-01-10-38

源码地址：https://github.com/FleyX/demo-project/tree/master/mybatis-test.

新闻标题：springboot使用Mybatis(xml和注解)过程全解析
网址分享：http://kswjz.com/article/piccdp.html

扫二维码与项目经理沟通

我们在微信上24小时期待你的声音

解答本文疑问/技术咨询/运营咨询/技术建议/互联网交流

springboot使用Mybatis(xml和注解)过程全解析

扫二维码与项目经理沟通

其他资讯

行业动态

企业网站建设的重要性！

服务项目

网站建设

移动端/APP

微信/小程序

技术支持

其它服务

更多服务项目

联系吧在百度地图上找到我们

电话：13518219792

springboot使用Mybatis(xml和注解)过程全解析

扫二维码与项目经理沟通

其他资讯

行业动态

企业网站建设的重要性！

服务项目

网站建设

移动端/APP

微信/小程序

技术支持

其它服务

更多服务项目

联系吧 在百度地图上找到我们

电话：13518219792

联系吧在百度地图上找到我们