SpringBoot - mapper，mapperscan；ORM操作数据库；自动生成代码；事务

╰半夏微凉° 2023-09-29 13:27 18阅读 0赞

**ORM**（**Object-Relational Mapping**，对象关系映射）是一种为了解决程序的面向对象模型与数据库的关系模型互不匹配问题的技术；简单的说，ORM是通过使用描述对象和数据库之间映射的元数据（在Java中可以用XML或者是注解），将程序中的对象自动持久化到关系数据库中或者将关系数据库表中的行转换成Java对象，其本质上就是将数据从一种形式转换到另外一种形式

首先我们使用MySQL创建好一个数据库，以及表student

### 一、@Mapper ###

![68eac036b2804084bcbb96f4de9922fd.png][]

1、pom.xml中导入 mybatis和mysql 的依赖，以及插件

<dependencies>
            
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
            
            <dependency>
                <groupId>org.mybatis.spring.boot</groupId>
                <artifactId>mybatis-spring-boot-starter</artifactId>
                <version>2.2.2</version>
            </dependency>
    
            
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <scope>runtime</scope>
            </dependency>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-test</artifactId>
                <scope>test</scope>
            </dependency>
        </dependencies>

pom.xml中指定 把resources目录中的文件 ， 编译到目标目录中

2、application.yml配置中加载mysql驱动

3、创建student实体类

public class Student {
    
        private Integer id;
        private String name;
        private Integer age;
    
        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 Integer getAge() {
            return age;
        }
    
        public void setAge(Integer age) {
            this.age = age;
        }
    
        @Override
        public String toString() {
            return "Student{" +
                    "id=" + id +
                    ", name='" + name + '\'' +
                    ", age=" + age +
                    '}';
        }
    }

4、创建 dao 以及 mapper.xml文件

**@Mapper**：放在dao接口的上面， 每个接口都需要使用这个注解

/**
     * @Mapper：告诉MyBatis这是dao接口，创建此接口的代理对象。
     *     位置：在类的上面
     */
    @Mapper
    public interface StudentDao {
    
        Student selectById(@Param("stuId") Integer id);
    }

<mapper namespace="com.company.dao.StudentDao">
        
        
        <select id="selectById" resultType="com.company.model.Student">
            select id,name,age from student where id=#{stuId}
        </select>
    
    </mapper>

5、创建service接口以及实现类

@Service
    public class StudentServiceImpl implements StudentService {
    
        @Autowired
        private StudentDao studentDao;
    
        @Override
        public Student queryStudent(Integer id) {
            Student student = studentDao.selectById(id);
            return student;
        }
    }

6、创建controller运行项目测试

@Controller
    public class StudentController {
    
        @Resource
        private StudentService studentService;
    
        @RequestMapping("/student/query")
        @ResponseBody
        public String queryStudent(Integer id){
            Student student = studentService.queryStudent(id);
            return student.toString();
        }
    }

### 二、@MapperScan ###

我们使用@Mapper注解 ，需要在每个Dao 接口都加入注解。

这时可以在主类上添加注解包扫描：@MapperScan("com.xx.dao")

![b12e5b7490a74c3bb6c5c162dc189105.png][]

在pom.xml文件中添加插件

<resources>
                <resource>
                    <directory>src/main/java</directory>
                    <includes>
                        <include>**/*.xml</include>
                    </includes>
                </resource>
            </resources>

启动类上添加注解 @MapperScan

/**
     * @MapperScan: 找到Dao接口和Mapper文件
     *     basePackages：Dao接口所在的包名
     */
    @MapperScan(basePackages = {"com.company.dao","com.company.mapper"})
    @SpringBootApplication
    public class Springboot13MapperscanApplication {
    
        public static void main(String[] args) {
            SpringApplication.run(Springboot13MapperscanApplication.class, args);
        }
    
    }

### 三、Mapper文件和Dao接口分离 ###

把Mapper文件放在resources目录下

![100b4a595dea402e9edb8eb827af8e36.png][]

（1）在resources目录中创建子目录 ，如 mapper

（2）把mapper文件放到 mapper目录中

（3）在application.yml文件中，指定mapper文件的目录

server:
      port: 8081
      servlet:
        context-path: /orm
    
    spring:
      datasource:
        url: jdbc:mysql://localhost:3306/springbootdb?useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT%2B8
        username: root
        password: admin123
    
    # MyBatis配置
    #指定mapper文件的位置
    mybatis:
    # 配置mapper的扫描，找到所有的mapper.xml映射文件
      mapperLocations: classpath*:mapper/*.xml
      #指定mybatis的日志
      configuration:
        log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

（4）在pom.xml中指定 把resources目录中的文件 ， 编译到目标目录中

<resources>
                <resource>
                    <directory>src/main/resources</directory>
                    <includes>
                        <include>**/*.*</include>
                    </includes>
                </resource>
            </resources>

（5）启动类中扫描包

/**
     * @MapperScan: 找到Dao接口和Mapper文件
     *     basePackages：Dao接口所在的包名
     */
    @MapperScan(basePackages = {"com.company.dao","com.company.mapper"})
    @SpringBootApplication
    public class Springboot14MapperResourcesApplication {
    
        public static void main(String[] args) {
            SpringApplication.run(Springboot14MapperResourcesApplication.class, args);
        }
    
    }

### 四、自动生成代码 ###

将GeneratorMapper.xml文件放在pom.xml同级目录下

![0662b47c2e264527b24c45e2291ff285.png][]

修改 GeneratorMapper.xml文件

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE generatorConfiguration
            PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
            "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
    
    <generatorConfiguration>
    
        
        <classPathEntry location="D:\JDK\mysql-connector-java-8.0.28.jar"/>
    
        
        <context id="tables" targetRuntime="MyBatis3">
    
            
            <commentGenerator>
                <property name="suppressAllComments" value="true" />
            </commentGenerator>
    
            
            <jdbcConnection driverClass="com.mysql.cj.jdbc.Driver"
                            connectionURL="jdbc:mysql://localhost:3306/springboot?useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT%2B8"
                            userId="root"
                            password="admin123456">
            </jdbcConnection>
    
            
            <javaModelGenerator targetPackage="com.company.model"
                                targetProject="D:\Java\JavaProject\springboot-demo\springboot-15-gen-transactional\src\main\java">
                <property name="enableSubPackages" value="false" />
                <property name="trimStrings" value="false" />
            </javaModelGenerator>
    
            
            <sqlMapGenerator targetPackage="mapper" targetProject="src/main/resources">
                <property name="enableSubPackages" value="false" />
            </sqlMapGenerator>
    
            
            <javaClientGenerator type="XMLMAPPER" targetPackage="com.company.dao" targetProject="src/main/java">
                <property name="enableSubPackages" value="false" />
            </javaClientGenerator>
    
            
            <table tableName="student" domainObjectName="Student"
                   enableCountByExample="false"
                   enableUpdateByExample="false"
                   enableDeleteByExample="false"
                   enableSelectByExample="false"
                   selectByExampleQueryId="false"/>
    
    
        </context>
    
    </generatorConfiguration>

在pom.xml文件中加入插件

<build>
            
            <resources>
                <resource>
                    <directory>src/main/resources</directory>
                    <includes>
                        <include>**/*.*</include>
                    </includes>
                </resource>
            </resources>
    
            <plugins>
                
                <plugin>
                    <groupId>org.mybatis.generator</groupId>
                    <artifactId>mybatis-generator-maven-plugin</artifactId>
                    <version>1.3.6</version>
                    <configuration>
                        
                        <configurationFile>GeneratorMapper.xml</configurationFile>
                        <verbose>true</verbose>
                        <overwrite>true</overwrite>
                    </configuration>
                </plugin>
    
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                </plugin>
            </plugins>
        </build>

双击右边 Maven中的Plugins 中的自动生成代码插件即可

![ab71759187974eb0a5392854c095f609.png][]

### 五、事务 ###

Spring Boot 使用事务非常简单，底层依然采用的是 Spring 本身提供的事务管理

1、在入口类中使用注解 @EnableTransactionManagement 开启事务支持

2、在访问数据库的 Service 方法上添加注解 @Transactional 即可

@Service
    public class StudentServiceImpl implements StudentService {
    
        @Autowired
        private StudentMapper studentDao;
    
        /**
         * @Transactional: 表示方法的有事务支持
         *       默认：使用库的隔离级别， REQUIRED 传播行为； 超时时间  -1
         *       抛出运行时异常，回滚事务
         */
        @Transactional
        @Override
        public int addStudent(Student student) {
            System.out.println("业务方法addStudent");
            int rows  =  studentDao.insert(student);
            System.out.println("执行sql语句");
    
            //抛出一个运行时异常， 目的是回滚事务
            //int m   = 10 / 0 ;
    
            return rows;
        }
    }

[68eac036b2804084bcbb96f4de9922fd.png]: https://img-blog.csdnimg.cn/68eac036b2804084bcbb96f4de9922fd.png
[b12e5b7490a74c3bb6c5c162dc189105.png]: https://img-blog.csdnimg.cn/b12e5b7490a74c3bb6c5c162dc189105.png
[100b4a595dea402e9edb8eb827af8e36.png]: https://img-blog.csdnimg.cn/100b4a595dea402e9edb8eb827af8e36.png
[0662b47c2e264527b24c45e2291ff285.png]: https://img-blog.csdnimg.cn/0662b47c2e264527b24c45e2291ff285.png
[ab71759187974eb0a5392854c095f609.png]: https://img-blog.csdnimg.cn/ab71759187974eb0a5392854c095f609.png