首页 > 其他分享> 文章详细

Mybatis入门与配置

2022-06-24 20:36:50 阅读：194 来源： 互联网

标签：xml 入门配置 UserMapper id mybatis sqlSession Mybatis public

Mybatis概述

What框架? Why框架

1、框架即framework。

其实就是某种应用的半成品，就是一组组件，供你选用完成你自己的系统。

简单理解就是一套资源，包含jar包、源码、帮助文档、示例等。

2、为什么要用框架开发？

使用别人成熟的框架，就相当于让别人帮你完成一些基础工作，你只需要集中精力完成系统的业务逻辑设计。这样可以节省开发时间，提高代码重用性，让开发变得更简单。

Mybatis简介

MyBatis 是支持定制化 SQL以及高级映射(ORM)的优秀的持久层框架。

MyBatis 发展历史

Mybatis的前身是 Apache的一个开源项目 iBatis， 2010年迁移到了google code 改名为 MyBatis，最后又迁移到了Github。

http://www.mybatis.org/mybatis-3/zh/index.html

MyBatis的优点

基于SQL语法，简单易学，能了解底层组装过程，SQL语句封装在配置文件中，便于统一管理与维护，降低了程序的耦合度，程序调试方便。

Mybatis配置

创建Mybatis工程

选择maven 输入组织名称、项目名称、版本号和工程名、保存位置

核对信息并点击Finish按钮

引入依赖

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

mybatis.xml配置文件

mybatis配置顺序如下，不能颠倒，也就是如果有properties属性配置，一定放到最前面，settings放到第二个位置，以此类推

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <settings>
        <!--指定 MyBatis 所用日志的具体实现,STDOUT_LOGGING表示控制台输出日志信息-->
        <setting name="logImpl" value="STDOUT_LOGGING"/>
    </settings>
    <!--配置环境（可以配置多个环境）-->
    <environments default="dev">
        <!--开发环境-->
        <environment id="dev">
            <!--使用JDBC事务管理-->
            <transactionManager type="JDBC"></transactionManager>
            <!--使用连接池技术-->
            <dataSource type="POOLED">
                <!--数据库驱动-->
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <!--连接字符串-->
                <property name="url"
                          value="jdbc:mysql://localhost:3306/test?useUnicode=true&amp;characterEncoding=utf8&amp;useSSL=false&amp;serverTimezone=Asia/Shanghai"/>
                <!--数据库用户名-->
                <property name="username" value="root"/>
                <!--数据库密码-->
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <!--映射文件-->
    <!--使用相对于类路径的资源引用-->
    <mappers>
        <mapper resource="mapper/UserMapper.xml"></mapper>
    </mappers>
</configuration>

写跟数据库表对应的java实体类

*如果要自定义有参的构造方法，原则上要定义一个无参构造方法，因为mybatis 使用反射创建对象时，优先调用无参构造方法
如果不定义无参构造方法，mybatis就会反射调用有参构造方法，有可能会造成参数对应错误或者类型对应不上，会造成结果错误或者出现异常
实体类至少要有set方法，这样才能把数据库查询的数据设置到实体类定义的成员变量中

package com.tjetc.entity;
public class User {
    private Long id;
    private String username;
    private String password;
    public User() {}
    public User(Long id, String username, String password) {
        this.id = id;this.username = username;this.password = password;
    }
    public Long getId() {return id;}
    public void setId(Long id) {this.id = id;}
    public String getUsername() {return username;}
    public void setUsername(String username) { this.username = username;}
    public String getPassword() {return password;}
    public void setPassword(String password) {this.password = password;}
    @Override
    public String toString() {
        return "User{" + "id=" + id +", username='" + username + '\'' + ", password='" + password + '\'' + '}'; }
}

映射文件UserMapper.xml

映射文件位置为：src/main/resources/mapper/UserMapper.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" >
<!--namespace 暂时命名为test-->
<mapper namespace="test">
    <select id="queryList" resultType="com.tjetc.entity.User">
        select * from user
    </select>
    <select id="queryById" parameterType="long" resultType="com.tjetc.entity.User">
        select * from user where id=#{id}
    </select>
</mapper>

测试程序

public class TestUser {
    @Test
    public void testQueryList() throws IOException {
        //实例化SqlSessionFactoryBuilder对象
        SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
        //创建SqlSessionFactory对象
        SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(Resources.getResourceAsReader("mybatis.xml"));
        //创建SqlSession对象
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //调用sqlSession.selectList()查询集合，参数为UserMapper.xml的namespace的值 点 select标签对应 id值
        List<User> users = sqlSession.selectList("test.queryList");
        //打印结果
        System.out.println(users);
        //关闭session
        sqlSession.close();
    }

    @Test
    public void testQueryById() throws IOException {
        //实例化SqlSessionFactoryBuilder对象
        SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
        //创建SqlSessionFactory对象
        SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(Resources.getResourceAsReader("mybatis.xml"));
        //创建SqlSession对象
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //调用sqlSession.selectOne()查询一条数据，第一个 参数为UserMapper.xml的namespace的值 点 select标签对应 id值 第二个参数为参数值
        User user = sqlSession.selectOne("test.queryById",1L);
        //打印结果
        System.out.println(user);
        //关闭session
        sqlSession.close();
    }
}

使用别名

在mybatis.xml文件中配置别名

    <typeAliases>
        <!--使用别名-->
        <typeAlias type="com.tjetc.entity.User" alias="User"></typeAlias>
    </typeAliases>

UserMapper.xml resultType="user"
这里的user大小没有影响
<?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" >
<!--namespace 暂时命名为test-->
<mapper namespace="test">
    <select id="queryList" resultType="user">
        select * from user
    </select>
    <select id="queryById" parameterType="int" resultType="User">
        select * from user where id=#{id}
    </select>
</mapper>

Mybatis调用接口Dao的接口方法，创建UserMapper接口

public interface UserMapper {
    List<User> queryList();
    List<User> queryById();
}

修改UserMapper.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" >
<!--namespace 为Dao接口的全限定名：包名+接口名-->
<mapper namespace="com.tjetc.dao.UserMapper">
    <select id="queryList" resultType="com.tjetc.entity.User">
        select * from user
    </select>
    <select id="queryById" parameterType="int" resultType="com.tjetc.entity.User">
        select * from user where id=#{id}
    </select>
</mapper>

测试：

@Test
public void testQueryList1() throws IOException {
        //实例化SqlSessionFactoryBuilder对象
        SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
        //创建SqlSessionFactory对象
        SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(Resources.getResourceAsReader("mybatis.xml"));
        //创建SqlSession对象
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //获取UserDao对象（代理对象）
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        //userDao。queryList()方法
        List<User> users = userMapper.queryList();
        //打印结果
        System.out.println(users);
    	//关闭session
        sqlSession.close();
    }

    @Test
    public void testQueryById1() throws IOException {
        //实例化SqlSessionFactoryBuilder对象
        SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
        //创建SqlSessionFactory对象
        SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(Resources.getResourceAsReader("mybatis.xml"));
        //创建SqlSession对象
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //获取UserDao对象（代理对象）
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        //userDao。queryById()方法
        User user = userMapper.queryById(1L);
        //打印结果
        System.out.println(user);
        //关闭session
        sqlSession.close();
    }

mybatis.xml配置详细说明

properties配置

resources目录下创建db.properties

driverName=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
username=root
password=123456

修改mybatis.xml配置

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <properties resource="db.properties"></properties>
    <settings>
        <!--指定 MyBatis 所用日志的具体实现,STDOUT_LOGGING表示控制台输出日志信息-->
        <setting name="logImpl" value="STDOUT_LOGGING"/>
    </settings>
    <typeAliases>
        <!--使用别名-->
        <typeAlias type="com.tjetc.entity.User" alias="User"></typeAlias>
    </typeAliases>
    <!--配置环境（可以配置多个环境）-->
    <environments default="dev">
        <!--开发环境-->
        <environment id="dev">
            <!--使用JDBC事务管理-->
            <transactionManager type="JDBC"></transactionManager>
            <!--使用连接池技术-->
            <dataSource type="POOLED">
                <!--数据库驱动-->
                <property name="driver" value="${driverName}"/>
                <!--连接字符串-->
                <property name="url" value="${url}"/>
                <!--数据库用户名-->
                <property name="username" value="${username}"/>
                <!--数据库密码-->
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>
    <!--映射文件-->
    <mappers>
        <mapper resource="mapper/UserMapper.xml"></mapper>
    </mappers>
</configuration>

typeAliases配置

类型别名是java类型的简写。它仅在XML配置文件中，用于简化合格的class名字

也可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean

<typeAliases>
  <package name="com.tjetc.entity"/>
</typeAliases>

每一个在包 com.tjetc.entity 中的 Java Bean，在没有注解的情况下，会使用 Bean 的首字母小写的非限定类名来作为它的别名。比如 com.tjetc.entit.User 的别名为 user；若有注解，则别名为其注解值，例如

@Alias("adm")
public class Admin{
    //....
}

下面是一些为常见的 Java 类型内建的类型别名。它们都是不区分大小写的，注意，为了应对原始类型的命名重复，采取了特殊的命名风格

typeHandlers

无论是mybatis设置一个参数给PreparedStatement，还是从PreparedStatement中返回ResultSet，都要面临一个问题：Java类型与JDBC类型之间的转换。

Java类型面向的是内存，JDBC类型面向的是各种关系型数据库，因此两者有很大的不同。

数据类型映射，是ORM框架中最关键的问题。

自定义类型映射器

你可以重写类型映射器，也可以创建自己的非标准类型映射器。

需要实现org.apache.ibatis.type.TypeHandler接口，或继承类org.apache.ibatis.type.BaseTypeHandler

<!-- mybatis-config.xml -->
<typeHandlers>
  <typeHandler handler="org.mybatis.example.ExampleTypeHandler"/>
</typeHandlers>

objectFactory配置

当mybatis每次创建一个新的结果集对象时，都需要使用objectFactory实例。

如果希望重写默认ObjectFactory的行为，可以自定义对象工厂

environments配置

1、mybatis允许你同时配置多个environments。如开发、测试、生产，可以同时配置三个环境。还可以同时对多个不同类型的数据库操作。

注意：虽然你可以同时配置多个环境，但是对于一个SqlSessionFactory实例，只能选择一个环境使用。因此，如果你想同时连接两个数据库，必须要创建两个SqlSessionFactory。

2、transactionManager配置

这里有两种事务管理类型可选，type=[JDBC | MANAGED]

JDBC：依赖于从dataSource返回的Connection对象，直接使用JDBC管理事务

MANAGED：由JavaEE容器管理整个事务

注意：如果使用Spring整合mybatis，无需配置TransactionManager，因为Spring会用自己的事务环境重写mybatis的配置

3、dataSource配置

使用标准数据源接口javax.sql.DataSource配置数据库的JDBC连接

这里有三种数据源类型可选：type="[UNPOOLED | POOLED | JNDI]")

UNPOOLED数据源

这个数据源的实现会每次请求时打开和关闭连接。虽然有点慢，但对那些数据库连接可用性要求不高的简单应用程序来说，是一个很好的选择。性能表现则依赖于使用的数据库，对某些数据库来说，使用连接池并不重要，这个配置就很适合这种情形

POOLED

采用数据库连接池配置，可以优化性能，是当前web项目配置首选。
JNDI

这个数据源实现是为了能在如 EJB 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上下文的数据源引用

databaseIdProvider配置

DatabaseIdProvider元素主要是为了支持不同厂商的数据库，即同时支持多个数据库

这个配置非常有用，项目如何同时支持多种数据库？

传统做法是生成多套mapper文件，在mybatis.xml中配置使用那套映射文件。这个做法的很大缺陷是：多套映射文件中，会有很多接口的实现是相同的，如果代码修改，需要同时修改多套文件。这给开发额外增加了很大的工作量。

MyBatis 工作原理

1、SqlSession与Connection

DefaultSqlSession是SqlSession接口的实现类

BaseExcecutor中封装了对数据库Connection的管理

数据库的Connection从dataSource中获取，并用Transaction包装

2、SqlSession的getMapper

调用session.getMapper()，输入映射接口，返回接口的实现对象

UserMapper mapper = session.getMapper(UserMapper.class);

调用MapperRegistry的getMapper()方法

断点观察SqlSession-->>configuration -->>mappedStatements(映射文件中的sql读取后，都存于此处)

使用JDK的动态代理类Proxy，根据映射接口，创建动态代理对象

标签：xml,入门,配置,UserMapper,id,mybatis,sqlSession,Mybatis,public
来源： https://www.cnblogs.com/seventeen9588/p/16392164.html

本站声明： 1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享；
2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关；
3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关；
4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除；
5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

ICode9