您的位置:

Mybatis入门指南

一、Mybatis基础

Mybatis是一种半自动化的持久化框架,能够帮助我们方便地完成持久层代码的编写。在Mybatis中,我们使用xml文件完成对数据库的操作。

Mybatis可以通过3种方式引入到项目中:

1、通过配置文件方式


<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.2</version>
</dependency>

2、通过Spring集成方式


<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>2.1.1</version>
</dependency>

3、通过Spring Boot集成方式


spring:
  datasource:
    url: jdbc:mysql://localhost:3306/test
    username: root
    password: root
mybatis:
  config-location: classpath:mybatis-config.xml
  mapper-locations:
    - classpath:mapper/*.xml

二、Mybatis配置文件

Mybatis的配置文件是一个必不可少的部分,它决定了Mybatis框架的基本运行方式。它主要包含以下几个部分:

1、databaseIdProvider:数据库厂商标识

2、typeAliases:类型别名

3、environments:环境信息

4、mappers:映射文件

三、映射文件

映射文件是Mybatis框架的核心部分,它描述了Java对象与SQL语句之间的映射关系。

下面我们来看一个示例:

Java对象:


public class User {
    private int id;
    private String username;
    private String password;
    // 省略getter和setter方法
}

SQL语句:


CREATE TABLE user (
  id int(11) NOT NULL AUTO_INCREMENT,
  username varchar(50) DEFAULT NULL,
  password varchar(50) DEFAULT NULL,
  PRIMARY KEY (id)
);

映射文件:


<mapper namespace="com.mybatis.example.dao.UserDao">
    <resultMap type="User" id="userMap">
        <id property="id" column="id" />
        <result property="username" column="username" />
        <result property="password" column="password" />
    </resultMap>
    <select id="getUserById" resultMap="userMap"> 
        select id, username, password from user where id = #{id}
    </select>
</mapper>

四、Mybatis注解

除了xml文件完成映射关系之外,我们还可以使用注解的方式来完成映射关系。通过注解的方式,我们可以更加方便快捷地完成映射关系的定义。

下面是一个使用注解的示例:

Java对象:


public class User {
    private int id;
    private String username;
    private String password;
    // 省略getter和setter方法
}

SQL语句:


CREATE TABLE user (
  id int(11) NOT NULL AUTO_INCREMENT,
  username varchar(50) DEFAULT NULL,
  password varchar(50) DEFAULT NULL,
  PRIMARY KEY (id)
);

映射文件:


@Component
//@Mapper注解可以被@ComponentScan扫描到
@Mapper
public interface UserMapper {
    @Select("select id, username, password from user where id = #{id}")
    User getUserById(int id);
}

五、Mybatis调用方式

Mybatis有3种基本的调用方式:

1、SqlSession接口的调用方式

2、Mapper接口与xml的混合方式

3、Mapper接口的注解方式

下面是三种调用方式的示例:

方式一:SqlSession调用方式


String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

SqlSession sqlSession = sqlSessionFactory.openSession();
try {
    User user = sqlSession.selectOne("com.mybatis.example.dao.UserDao.getUserById", 1);
    System.out.println(user.getUsername());
} finally {
    sqlSession.close();
}

方式二:Mapper接口与xml的混合方式


String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

SqlSession sqlSession = sqlSessionFactory.openSession();
try {
    UserDao userDao = sqlSession.getMapper(UserDao.class);
    User user = userDao.getUserById(1);
    System.out.println(user.getUsername());
} finally {
    sqlSession.close();
}

方式三:Mapper接口的注解方式


@Autowired
private UserMapper userMapper;

@Test
public void testSelect() {
    User user = userMapper.getUserById(1);
    System.out.println(user.getUsername());
}

六、Mybatis插件

Mybatis插件可以在Mybatis的增删改查操作中增加拦截器,实现一些自定义的业务逻辑。

下面是一个示例:

定义拦截器:


@Intercepts({
    @Signature(type = StatementHandler.class, method = "prepare", args = { Connection.class, Integer.class })
})
public class MyInterceptor implements Interceptor {

    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        // 实现自定义的逻辑
        return invocation.proceed();
    }

    @Override
    public Object plugin(Object target) {
        return Plugin.wrap(target, this);
    }

    @Override
    public void setProperties(Properties properties) {
        // 获取自定义的一些配置信息
    }

}

在Mybatis配置文件中使用插件:


<plugins>
    <plugin interceptor="com.mybatis.example.interceptor.MyInterceptor">
        <property name="someValue" value="100"/>
    </plugin>
</plugins>

七、小结

Mybatis是一种相对成熟、易用的ORM框架,在日常开发中可以大幅度提高开发效率。了解其基础知识能够更好地为我们的开发工作提供支持。