Springboot-集成Mybatis完成數據庫操作

        上一篇介紹了Springboot集成JPA實現數據庫的操作，但是目前，大多數主流公司基本採用Mybatis完成數據庫的操作。Mybatis是一種持久層框架，也屬於ORM映射，是一種半自動化語言，需要自己編寫Sql語句，簡單易學，Sql寫在xml裏，便於統一管理和優化。通過sql基本上可以實現我們不使用數據訪問框架可以實現的所有功能，將業務邏輯與數據訪問分離解耦。下面開始編寫項目：

     首先同樣，將相關包進行導入，如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.tdw.mybatis</groupId>
  <artifactId>mybatis-demo</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>jar</packaging>
  
  	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>2.0.3.RELEASE</version>
		<relativePath/> <!-- lookup parent from repository -->
	</parent>

	<properties>
		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
		<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
		<java.version>1.8</java.version>
	</properties>
	
	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>

		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
		
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-devtools</artifactId>
		</dependency>
		
		<dependency>
			<groupId>org.mybatis.spring.boot</groupId>
			<artifactId>mybatis-spring-boot-starter</artifactId>
			<version>1.3.2</version>
		</dependency>
		
		<dependency>
			<groupId>mysql</groupId>
			<artifactId>mysql-connector-java</artifactId>
		</dependency>
	</dependencies>
  
  	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
			</plugin>
		</plugins>
	</build>
</project>

接下來編寫application.properties，如下：

#mybatis config
mybatis.config-location = classpath:mapper/config/sqlMapConfig.xml
mybatis.mapper-locations = classpath:mapper/*.xml

#datasource config
spring.datasource.url=jdbc:mysql://localhost:3306/springboot
spring.datasource.username = root
spring.datasource.password = 123
spring.datasource.driverClassName = com.mysql.jdbc.Driver
spring.datasource.max-active=20
spring.datasource.max-idle=8
spring.datasource.min-idle=8
spring.datasource.initial-size=10

server.port = 8083

很簡單，包含了數據庫的相關配置以及和mybatis的。server.port設置訪問端口。

可以看到在mybatis配置中，maper-location定義爲(你自己可以進行選擇放置位置)，mapper/*.xml如下目錄：

配置好，接下來開發相關的代碼：

給出實體類代碼：

public class UserVO implements Serializable{

	private static final long serialVersionUID = 1L;
	/**
	 * id
	 */
	private Integer id;
	/**
	 * 名稱
	 */
	private String name;
	/**
	 * 密碼
	 */
	private String password;
	/**
	 * 用戶名
	 */
	private String username;
	public Integer getId() {
		return id;
	}
	public void setId(Integer id) {
		this.id = id;
	}
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public String getPassword() {
		return password;
	}
	public void setPassword(String password) {
		this.password = password;
	}
	public String getUsername() {
		return username;
	}
	public void setUsername(String username) {
		this.username = username;
	}
}

首先開發業務層，定義一個接口findAllUser，找出所有用戶：

public interface IUserService {

	public List<UserVO> findAllUser();
}

接下來完成與數據庫交互的Dao層接口：

@Mapper
public interface IUserDao {

	/**
	 * 找出所有的用戶
	 * @return
	 */
	public List<UserVO> findAllUser();
}

接下來，在上面配置的mapper目錄下新建同樣名稱的文件IUserDao.xml：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="com.tdw.mybatis.user.dao.IUserDao">
	<select id="findAllUser" resultType="com.tdw.mybatis.user.vo.UserVO">
		select * from user
	</select>
</mapper>

DAO層開發好後，接下來實現該接口的功能，

@Service
public class UserServiceImpl implements IUserService{

	@Autowired
	private IUserDao userDao;
	
	public List<UserVO> findAllUser() {
		System.out.print("-findAllUser--");
		return userDao.findAllUser();
	}
}

完成業務層開發，接下來實現controller層的代碼開發，這裏是提供給外部進行訪問的：

@RestController
public class UserController {

	@Autowired
	private IUserService userService;
	
	@RequestMapping("/list/findUsers")
	public List<UserVO> findUsers()
	{
		System.out.println("coming...");
		return userService.findAllUser();
	} 
}

最後，定義Springboot的啓動類，如下：

package com.tdw.mybatis;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class MybatisApplication {

	public static void main(String[] args) {
		SpringApplication.run(MybatisApplication.class, args);
	}
}

使用postman進行測試，如下結果：

至此，代碼開發完成。

延伸：

在IUserDao接口上面去掉@Mapper註解，然後在Springboot的啓動類添加@MapperScan註解，如下：

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@MapperScan("com.tdw.mybatis.*")
@SpringBootApplication
public class MybatisApplication {

	public static void main(String[] args) {
		SpringApplication.run(MybatisApplication.class, args);
	}
}

啓動會報錯，原因在controller層通過註解引入IUserService接口無法識別到特定的服務，添加註解@Qualifier("userServiceImpl")即可，同時在UserServiceImpl中的註解改爲@Service("userServiceImpl")。

@Qualifier註解了，qualifier的意思是合格者，通過這個標示，表明了哪個實現類纔是我們所需要的，我們修改調用代碼，添加@Qualifier註解，需要注意的是@Qualifier的參數名稱必須爲我們之前定義@Service註解的名稱之一。

再次啓動成功。這是另一種方式掃描配置。

接下來更深層次學習下@Mapper和@MapperScan的區別，同時閱讀源碼看下原理如何。