SpringBoot入门系列：mybatis

 这一篇，代码折腾的时间较长，完成之后都是一些小细节，主要有三：

1、引入的依赖错误；

2、启动配置错误；

3、xml文件的mapper命名空间错误。

一、完整的pom.xml

[html]  view plain  copy

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
3.     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">  
4.     <modelVersion>4.0.0</modelVersion>  
5.   
6.     <groupId>com.example</groupId>  
7.     <artifactId>spring-boot-sample-mybatis</artifactId>  
8.     <version>0.0.1-SNAPSHOT</version>  
9.     <packaging>jar</packaging>  
10.   
11.     <name>spring-boot-sample-mybatis</name>  
12.     <description>Demo project for Spring Boot</description>  
13.   
14.     <parent>  
15.         <groupId>org.springframework.boot</groupId>  
16.         <artifactId>spring-boot-starter-parent</artifactId>  
17.         <version>1.3.5.RELEASE</version>  
18.         <relativePath/> <!-- lookup parent from repository -->  
19.     </parent>  
20.   
21.     <properties>  
22.         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>  
23.         <java.version>1.8</java.version>  
24.     </properties>  
25.   
26.     <dependencies>  
27.         <dependency>  
28.             <groupId>org.springframework.boot</groupId>  
29.             <artifactId>spring-boot-starter-web</artifactId>  
30.         </dependency>  
31.           
32.         <dependency>  
33.             <groupId>org.springframework.boot</groupId>  
34.             <artifactId>spring-boot-starter-test</artifactId>  
35.             <scope>test</scope>  
36.         </dependency>  
37.         <!-- mysql连接 -->  
38.         <dependency>  
39.             <groupId>mysql</groupId>  
40.             <artifactId>mysql-connector-java</artifactId>  
41.             <scope>runtime</scope>  
42.         </dependency>  
43.         <!-- mybatis -->  
44.         <dependency>  
45.             <groupId>org.mybatis.spring.boot</groupId>  
46.             <artifactId>mybatis-spring-boot-starter</artifactId>  
47.             <version>1.1.1</version>  
48.         </dependency>  
49.     </dependencies>  
50.       
51.     <build>  
52.         <plugins>  
53.             <plugin>  
54.                 <groupId>org.springframework.boot</groupId>  
55.                 <artifactId>spring-boot-maven-plugin</artifactId>  
56.             </plugin>  
57.         </plugins>  
58.     </build>  
59.   
60. </project>  

比较关键的是：mysql-connector-java、mybatis-spring-boot-starter，其它的根据使用引用。

二、启动文件 Application.java

[java]  view plain  copy

1. package com.example;  
2.   
3. import org.apache.ibatis.session.SqlSessionFactory;  
4. import org.apache.tomcat.jdbc.pool.DataSource;  
5. import org.mybatis.spring.SqlSessionFactoryBean;  
6. import org.mybatis.spring.annotation.MapperScan;  
7. import org.slf4j.Logger;  
8. import org.slf4j.LoggerFactory;  
9. import org.springframework.boot.SpringApplication;  
10. import org.springframework.boot.autoconfigure.SpringBootApplication;  
11. import org.springframework.boot.context.properties.ConfigurationProperties;  
12. import org.springframework.context.annotation.Bean;  
13. import org.springframework.core.io.support.PathMatchingResourcePatternResolver;  
14. import org.springframework.jdbc.datasource.DataSourceTransactionManager;  
15. import org.springframework.transaction.PlatformTransactionManager;  
16.   
17.   
18. @SpringBootApplication  
19. @MapperScan("com.example.mapper")  
20. public class Application {  
21.       
22.     protected static Logger logger=LoggerFactory.getLogger(Application.class);  
23.   
24.     @Bean  
25.     @ConfigurationProperties(prefix="spring.datasource")  
26.     public DataSource dataSource() {  
27.         return new org.apache.tomcat.jdbc.pool.DataSource();  
28.     }  
29.   
30.     @Bean  
31.     public SqlSessionFactory sqlSessionFactoryBean() throws Exception {  
32.   
33.         SqlSessionFactoryBean sqlSessionFactoryBean = new SqlSessionFactoryBean();  
34.         sqlSessionFactoryBean.setDataSource(dataSource());  
35.   
36.         PathMatchingResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();  
37.   
38.         sqlSessionFactoryBean.setMapperLocations(resolver.getResources("classpath:/mybatis/*.xml"));  
39.   
40.         return sqlSessionFactoryBean.getObject();  
41.     }  
42.   
43.     @Bean  
44.     public PlatformTransactionManager transactionManager() {  
45.         return new DataSourceTransactionManager(dataSource());  
46.     }  
47.   
48.       
49.     public static void main(String[] args) {  
50.         SpringApplication.run(Application.class, args);  
51.         logger.info("SpringBoot Start Success");  
52.     }  
53. }  

注意3点：

1、在类上声明MapperScan，这是mybatis-spring-boot-starter在1.1.1引入的类Mapper，从而在mapper接口上不需要任何声明

2、配置dataSource、SqlSessionFactory、PlatformTransactionManager，其实默认的都已经配好，这里主要是为了标明Mapper的xml文件存在位置

3、src/main/resources下的文件，在打包之后，都在工程的根目录。

这个只需要更改两个地方：

1、MapperScan之后的"com.example.mapper"，改成Mapper接口文件所在的包名

2、sqlSessionFactoryBean方法中"classpath:/mybatis/*.xml"，改成Mapper的xml文件存在位置

三、启动配置文件 application.properties

[html]  view plain  copy

1. spring.datasource.url=jdbc:mysql://192.168.56.201:3306/bootsample?useUnicode=true&characterEncoding=UTF-8  
2. spring.datasource.username=root  
3. spring.datasource.password=123456  
4. spring.datasource.driver-class-name=com.mysql.jdbc.Driver  
5. spring.datasource.max-active=10  
6. spring.datasource.max-idle=5  
7. spring.datasource.min-idle=0  

这个根据数据库情况配置

四、Mapper的XML文件

[html]  view plain  copy

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">  
3. <!-- namespace必须指向Dao接口 -->  
4. <mapper namespace="com.example.mapper.HotelDtoMapper">  
5.     <resultMap id="ListHotelDto" type="com.example.dto.HotelDto" >  
6.         <result column="cityName" property="cityName" />  
7.         <result column="hotelName" property="hotelName" />  
8.         <result column="address" property="address" />  
9.         <result column="zip" property="zip" />  
10.         <result column="state" property="state" />  
11.         <result column="country" property="country" />  
12.     </resultMap>  
13.   
14.     <!-- 根据ID查询数据 -->  
15.     <select id="findByCountry" parameterType="String" resultMap="ListHotelDto">  
16.         select   
17.             c.name as cityName,  
18.             h.name as hotelName,  
19.             h.address,  
20.             h.zip,  
21.             c.state,  
22.             c.country   
23.         from city c   
24.         join hotel h on c.id=h.city   
25.         where c.country = #{country}  
26.     </select>  
27. </mapper>  

与普通的mybatis配置一样，只是小心：

1、mapper的命名空间（namespace），一定是所对应的接口的包名+类名

2、parameterType和resultMap，与实际匹配

五、接口文件

[java]  view plain  copy

1. package com.example.mapper;  
2.   
3. import java.util.List;  
4.   
5. import com.example.dto.HotelDto;  
6.   
7. public interface HotelDtoMapper {  
8.       
9.     public List<HotelDto> findByCountry(String country);  
10. }  

注意：

1、类上没有任何的声明

2、方法的名称、输入参数书，与xml定义的一直

六、文件结构

七、其它说明

      使用mybatis的主要目的，就是解决复杂sql。在数据库工具中拼写好sql,拷贝进xml文件；验证sql，仅需要把sql拷贝到数据库工具进行分析即可，简单高效。

源代码：http://download.csdn.net/detail/lxhjh/9560276