Mybatis 入门 -- 最简单的引入和使用

我会带着你远行 2022-07-16 07:39 158阅读 0赞

参考：http://www.mybatis.org/mybatis-3/zh/getting-started.html

从今天开始学习官方文档。

# 1.项目搭建 #

项目结构：

![686418-20160627225908531-1939432340.png][]

首先，搭建一个maven项目。为了方便以后的测试，这里每次测试都是以子项目的形式。所以，创建一个parent：

在idea中，File->new->project->选择maven->groupt：com.test,artifact:l4mybatis.

创建好parent后，填充pom：

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

1 <?xml version="1.0" encoding="UTF-8"?>
     2 <project xmlns="http://maven.apache.org/POM/4.0.0"
     3          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     4          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     5     <modelVersion>4.0.0</modelVersion>
     6 
     7     <groupId>com.test</groupId>
     8     <artifactId>l4mybatis</artifactId>
     9     <packaging>pom</packaging>
    10     <version>1.0-SNAPSHOT</version>
    11 
    12 
    13     <dependencyManagement>
    14         <dependencies>
    15             <dependency>
    16                 <groupId>org.mybatis</groupId>
    17                 <artifactId>mybatis</artifactId>
    18                 <version>3.4.1</version>
    19             </dependency>
    20             <dependency>
    21                 <groupId>mysql</groupId>
    22                 <artifactId>mysql-connector-java</artifactId>
    23                 <version>6.0.2</version>
    24             </dependency>
    25             <dependency>
    26                 <groupId>junit</groupId>
    27                 <artifactId>junit</artifactId>
    28                 <version>4.12</version>
    29             </dependency>
    30         </dependencies>
    31     </dependencyManagement>
    32 
    33 
    34 </project>

在项目名称l4mybatis上右键，new -> module->选择maven->artifact:mybatis-base.

创建好子项目mybatis-base后，编写pom:

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

1 <?xml version="1.0" encoding="UTF-8"?>
     2 <project xmlns="http://maven.apache.org/POM/4.0.0"
     3          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     4          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     5     <parent>
     6         <artifactId>l4mybatis</artifactId>
     7         <groupId>com.test</groupId>
     8         <version>1.0-SNAPSHOT</version>
     9     </parent>
    10     <modelVersion>4.0.0</modelVersion>
    11 
    12     <artifactId>mybatis-base</artifactId>
    13 
    14     <dependencies>
    15         <dependency>
    16             <groupId>org.mybatis</groupId>
    17             <artifactId>mybatis</artifactId>
    18         </dependency>
    19         <dependency>
    20             <groupId>mysql</groupId>
    21             <artifactId>mysql-connector-java</artifactId>
    22         </dependency>
    23         <dependency>
    24             <groupId>junit</groupId>
    25             <artifactId>junit</artifactId>
    26         </dependency>
    27     </dependencies>
    28 
    29     <build>
    30         <resources>
    31             <resource>
    32                 <directory>src/main/resources</directory>
    33                 <includes>
    34                     <include>**/*.properties</include>
    35                     <include>**/*.xml</include>
    36                 </includes>
    37                 <filtering>true</filtering>
    38             </resource>
    39             <resource>
    40                 <directory>src/main/java</directory>
    41                 <includes>
    42                     <include>**/*.properties</include>
    43                     <include>**/*.xml</include>
    44                 </includes>
    45                 <filtering>true</filtering>
    46             </resource>
    47         </resources>
    48     </build>
    49 
    50 
    51 </project>

在helloword测试中，我们依赖有：

<dependencies>
                <dependency>
                    <groupId>org.mybatis</groupId>
                    <artifactId>mybatis</artifactId>
                    <version>3.4.1</version>
                </dependency>
                <dependency>
                    <groupId>mysql</groupId>
                    <artifactId>mysql-connector-java</artifactId>
                    <version>6.0.2</version>
                </dependency>
                <dependency>
                    <groupId>junit</groupId>
                    <artifactId>junit</artifactId>
                    <version>4.12</version>
                </dependency>
            </dependencies>

# 2. 准备测试数据库 #

新建mysql 数据库mybatis，创建一个表blog:

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

1 SET FOREIGN_KEY_CHECKS=0;
     2 
     3 -- ----------------------------
     4 -- Table structure for blog
     5 -- ----------------------------
     6 DROP TABLE IF EXISTS `blog`;
     7 CREATE TABLE `blog` (
     8   `id` int(11) NOT NULL AUTO_INCREMENT,
     9   `name` varchar(255) DEFAULT NULL,
    10   PRIMARY KEY (`id`)
    11 ) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8;
    12 
    13 -- ----------------------------
    14 -- Records of blog
    15 -- ----------------------------
    16 INSERT INTO `blog` VALUES ('1', 'test');

# 3.创建mapper和model #

在src\\main\\java下：

创建com.test.start.mapper.BlogMapper。这个相当于dao。

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

1 package com.test.start.mapper;
     2 
     3 import com.test.start.model.Blog;
     4 
     5 /**
     6  * Created by miaorf on 2016/6/27.
     7  */
     8 public interface BlogMapper {
     9 
    10     Blog selectBlog(int id);
    11 }

创建com/test/start/mapper/BlogMapper.xml。这个要和mapper一一映射，名字完全相同，命名空间一致。

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

1 <?xml version="1.0" encoding="UTF-8" ?>
    2 <!DOCTYPE mapper
    3         PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
    4         "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
    5 <mapper namespace="com.test.start.mapper.BlogMapper">
    6     <select id="selectBlog" resultType="Blog">
    7         select * from Blog where id = #{id}
    8     </select>
    9 </mapper>

创建com.test.start.model.Blog。这个是实体，就是查询结果所映射的类。

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

1 package com.test.start.model;
     2 
     3 /**
     4  * Created by miaorf on 2016/6/27.
     5  */
     6 public class Blog {
     7     int id;
     8     String name;
     9 
    10     @Override
    11     public String toString() {
    12         return "Blog{" +
    13                 "id=" + id +
    14                 ", name='" + name + '\'' +
    15                 '}';
    16     }
    17 }

# 4.创建配置文件 #

在src\\main\\resources下：

创建mybatis-config.xml:

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

1 <?xml version="1.0" encoding="UTF-8" ?>
     2 <!DOCTYPE configuration
     3         PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
     4         "http://mybatis.org/dtd/mybatis-3-config.dtd">
     5 <configuration>
     6     <properties resource="db.properties"/>
     7 
     8     <typeAliases>
     9         
    10         <package name="com.test.start.model"/>
    11     </typeAliases>
    12 
    13     <environments default="development">
    14         <environment id="development">
    15             <transactionManager type="JDBC"/>
    16             <dataSource type="POOLED">
    17                 <property name="driver" value="${jdbc.driver}"/>
    18                 <property name="url" value="${jdbc.url}"/>
    19                 <property name="username" value="${jdbc.username}"/>
    20                 <property name="password" value="${jdbc.password}"/>
    21             </dataSource>
    22         </environment>
    23     </environments>
    24     <mappers>
    25         <mapper resource="com/test/start/mapper/BlogMapper.xml"/>
    26     </mappers>
    27 </configuration>

创建db.properties:

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

1 #jdbc.driver=com.mysql.jdbc.Driver
    2 jdbc.driver=com.mysql.cj.jdbc.Driver
    3 jdbc.url=jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull&serverTimezone=Asia/Shanghai&useSSL=false
    4 jdbc.username=root
    5 jdbc.password=

# 5.创建测试类 #

在src\\main\\java下

创建com.test.start.MybatisStarter：

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

1 package com.test.start;
     2 
     3 import com.test.start.mapper.BlogMapper;
     4 import com.test.start.model.Blog;
     5 import org.apache.ibatis.io.Resources;
     6 import org.apache.ibatis.mapping.Environment;
     7 import org.apache.ibatis.session.Configuration;
     8 import org.apache.ibatis.session.SqlSession;
     9 import org.apache.ibatis.session.SqlSessionFactory;
    10 import org.apache.ibatis.session.SqlSessionFactoryBuilder;
    11 import org.apache.ibatis.transaction.TransactionFactory;
    12 import org.apache.ibatis.transaction.jdbc.JdbcTransactionFactory;
    13 import org.junit.Test;
    14 
    15 import javax.sql.DataSource;
    16 import java.io.IOException;
    17 import java.io.InputStream;
    18 
    19 /**
    20  * Created by miaorf on 2016/6/27.
    21  */
    22 public class MybatisStarter {
    23 
    24     public static void main(String[] args) throws IOException {
    25         String resource = "mybatis-config.xml";
    26         InputStream inputStream = Resources.getResourceAsStream(resource);
    27         SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    28 
    29         SqlSession session = sqlSessionFactory.openSession();
    30         try {
    31             BlogMapper mapper = session.getMapper(BlogMapper.class);
    32             Blog blog = mapper.selectBlog(1);
    33             System.out.println(blog);
    34         } finally {
    35             session.close();
    36         }
    37     }
    38 
    39     @Test
    40     public void sqlSessionByJava(){
    41 //        DataSource dataSource = BlogDataSourceFactory.getBlogDataSource();
    42 //        TransactionFactory transactionFactory = new JdbcTransactionFactory();
    43 //        Environment environment = new Environment("development", transactionFactory, dataSource);
    44 //        Configuration configuration = new Configuration(environment);
    45 //        configuration.addMapper(BlogMapper.class);
    46 //        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(configuration);
    47     }
    48 }

# 6.运行 #

Blog\{id=1, name='test'\}

Process finished with exit code 0

# 7.备份官方文档 #

### 范围（Scope）和生命周期 ###

理解我们目前已经讨论过的不同范围和生命周期类是至关重要的，因为错误的使用会导致非常严重的并发问题。

--------------------

提示 **对象生命周期和依赖注入框架**

依赖注入框架可以创建线程安全的、基于事务的 SqlSession 和映射器（mapper）并将它们直接注入到你的 bean 中，因此可以直接忽略它们的生命周期。如果对如何通过依赖注入框架来使用 MyBatis 感兴趣可以研究一下 MyBatis-Spring 或 MyBatis-Guice 两个子项目。

--------------------

### ###

#### SqlSessionFactoryBuilder ####

这个类可以被实例化、使用和丢弃，一旦创建了 SqlSessionFactory，就不再需要它了。因此 **SqlSessionFactoryBuilder 实例的最佳范围是方法范围（也就是局部方法变量**）。你可以重用 SqlSessionFactoryBuilder 来创建多个 SqlSessionFactory 实例，但是最好还是不要让其一直存在以保证所有的 XML 解析资源开放给更重要的事情。

#### SqlSessionFactory ####

SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由对它进行清除或重建。使用 SqlSessionFactory 的最佳实践是在应用运行期间不要重复创建多次，多次重建 SqlSessionFactory 被视为一种代码“坏味道（bad smell）”。因此 SqlSessionFactory 的最佳范围是应用范围。有很多方法可以做到，最简单的就是使用**单例模式或者静态单例模式**。

#### SqlSession ####

**每个线程都应该有它自己的 SqlSession 实例**。SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的范围是请求或方法范围。绝对不能将 SqlSession 实例的引用放在一个类的静态域，甚至一个类的实例变量也不行。也绝不能将 SqlSession 实例的引用放在任何类型的管理范围中，比如 Serlvet 架构中的 HttpSession。如果你现在正在使用一种 Web 框架，要考虑 SqlSession 放在一个和 HTTP 请求对象相似的范围中。换句话说，每次收到的 HTTP 请求，就可以打开一个 SqlSession，返回一个响应，就关闭它。这个关闭操作是很重要的，你应该把这个关闭操作放到 finally 块中以确保每次都能执行关闭。下面的示例就是一个确保 SqlSession 关闭的标准模式：

SqlSession session = sqlSessionFactory.openSession(); try { // do work } finally { session.close(); }

在你的所有的代码中一致性地使用这种模式来保证所有数据库资源都能被正确地关闭。

#### 映射器实例（Mapper Instances） ####

映射器是创建用来绑定映射语句的接口。映射器接口的实例是从 SqlSession 中获得的。因此从技术层面讲，映射器实例的最大范围是和 SqlSession 相同的，因为它们都是从 SqlSession 里被请求的。尽管如此，映射器实例的最佳范围是方法范围。也就是说，映射器实例应该在调用它们的方法中被请求，用过之后即可废弃。并不需要显式地关闭映射器实例，尽管在整个请求范围（request scope）保持映射器实例也不会有什么问题，但是很快你会发现，像 SqlSession 一样，在这个范围上管理太多的资源的话会难于控制。所以要保持简单，最好把**映射器放在方法范围（method scope）**内。下面的示例就展示了这个实践：

SqlSession session = sqlSessionFactory.openSession(); try { BlogMapper mapper = session.getMapper(BlogMapper.class); // do work } finally { session.close(); }

项目：https://github.com/chenxing12/l4mybatis

[686418-20160627225908531-1939432340.png]: /images/20220716/69327c22f5f24b1f9ccdbbe22b10fe88.png
[ContractedBlock.gif]: http://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif
[ExpandedBlockStart.gif]: /images/20220716/df752a7d15a14f4e97cff4ad2117d883.png

发表评论取消回复

表情：

评论列表（有 0 条评论，158人围观）

还没有评论，来说两句吧...

相关阅读

相关二、【MyBatis】 MyBatis入门与简单使用

二、【MyBatis】 MyBatis入门与简单使用二、【MyBatis】 MyBatis入门与简单使用一、什么是ORM二、为什么mybatis是半自动的ORM框架2.

蔚落/ 2024年02月21日 10:36/ 0 赞/ 67 阅读

相关 mybatis-generator，最简单的配置使用

最近在整springboot和mybatis的整合，相比较spring data jpa，mybatis所有的sql都得自己写，在做一些基本的增删改查SQL时，会比较重复和繁琐

水深无声/ 2023年07月13日 10:40/ 0 赞/ 16 阅读

相关 swagger的简单入门和使用

一、什么是swagger？ Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 restful 风格的 Web 服务。总体目标是使客户端和文件系统

今天药忘吃喽~/ 2023年02月19日 04:28/ 0 赞/ 14 阅读

相关 mybatis最简单的二级缓存入门案例

1 全局配置需要在mybatis的核心配置文件开启二级缓存 <settings>  <s

╰半夏微凉°/ 2022年11月25日 10:11/ 0 赞/ 229 阅读

相关 Mybatis简单入门

一、创建项目导入相应的jar包（数据库驱动包和mybatis jar包）二、在src目录下，建立conf.xml配置文件 <?xml version="

超、凢脫俗/ 2022年08月22日 06:23/ 0 赞/ 247 阅读

相关 Mybatis 入门 -- 最简单的引入和使用

参考：http://www.mybatis.org/mybatis-3/zh/getting-started.html 从今天开始学习官方文档。 1.项目搭建

我会带着你远行/ 2022年07月16日 07:39/ 0 赞/ 159 阅读

相关 mybatis简单入门实例

最近刚接触到mybatis这个orm框架，之前接触过hibernate，不过想吐槽的是hibernate真的比较重量级，开发比较麻烦，所以再来看看mybatis怎么样。以

ゝ一纸荒年。/ 2022年06月05日 04:55/ 0 赞/ 272 阅读

相关 MyBatis简单入门（一）

1、作用： Mybatis可以实现数据库到对象的映射。 2、特点：通过参数加SQL语句的方式实现实体。 3、如何使用： SQL写在哪里？xml文件（推荐）

野性酷女/ 2022年04月05日 05:41/ 0 赞/ 278 阅读

相关 mybatis简单入门实例

mybatis是一个数据持久层框架，他与hibernate相比，也有自己的优点，当我们进行多表关联查询的时候，很容易实现，因为他天生就是用来写sql实现功能的，而hiberna

╰半橙微兮°/ 2022年03月01日 12:46/ 0 赞/ 317 阅读

相关 mybaties的简单使用

需要下载的jar包：链接：[https://pan.baidu.com/s/1FUtXK\_v-oTiV6paTaVcr0A][https_pan.baidu.com_s

红太狼/ 2022年01月22日 06:17/ 0 赞/ 243 阅读