在MyBatis中使用接口映射的步骤详解_Java

前言

在mybatis中使用接口映射是一种基于java接口而非xml映射文件的方式来绑定sql查询和操作。这种方法使用注解来指定sql语句，并将其直接关联到接口方法上。通过这种方式，可以省去编写xml映射文件的工作，而且使得sql语句和java代码的关系更直观。

1. 定义一个mapper接口

首先，定义一个接口来表示你的数据库操作。例如，如果你有一个user表，你可以创建一个usermapper接口：

public interface usermapper {
    @select("select * from users where id = #{id}")
    user getuserbyid(integer id);
    
    @insert("insert into users(name, email) values(#{name}, #{email})")
    @options(usegeneratedkeys = true, keyproperty = "id")
    void insertuser(user user);
    
    @update("update users set name=#{name}, email=#{email} where id=#{id}")
    void updateuser(user user);
    
    @delete("delete from users where id=#{id}")
    void deleteuser(integer id);
}

这个接口定义了基本的增删改查操作，并通过注解@select、@insert、@update、@delete与sql语句相关联。

2. 配置mybatis使用注解

接下来，在mybatis配置文件中指定你的接口。你无需指定xml文件，因为你用注解定义了sql语句。

mybatis-config.xml 示例（无需mapper xml声明）

<configuration>
    <environments default="development">
        <environment id="development">
            <transactionmanager type="jdbc"/>
            <datasource type="pooled">
                <property name="driver" value="com.mysql.cj.jdbc.driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis"/>
                <property name="username" value="root"/>
                <property name="password" value="password"/>
            </datasource>
        </environment>
    </environments>
    
    <mappers>
        <mapper class="org.example.mapper.usermapper"/>
    </mappers>
</configuration>

3. 在代码中使用mapper接口

创建sqlsessionfactory和sqlsession，然后通过sqlsession获取mapper接口的实例。

try (sqlsession session = sqlsessionfactory.opensession()) {
    usermapper mapper = session.getmapper(usermapper.class);
    
    // 使用mapper操作数据库
    user user = mapper.getuserbyid(1);
    system.out.println(user.getname());
    
    // 更多的数据库操作...
}

4. 深入源码分析

在mybatis初始化过程中，当你调用getmapper(class<t> type)方法时，mybatis内部使用了jdk动态代理来创建mapper接口的实现。

public <t> t getmapper(class<t> type) {
    return configuration.<t>getmapper(type, this);
}

在configuration类中，getmapper方法会调用mapperregistry中的getmapper方法，该方法最终调用了mapperproxyfactory来创建mapper代理：

public <t> t getmapper(class<t> type, sqlsession sqlsession) {
    final mapperproxyfactory<t> mapperproxyfactory = (mapperproxyfactory<t>) knownmappers.get(type);
    if (mapperproxyfactory == null) {
        throw new bindingexception("type " + type + " is not known to the mapperregistry.");
    }
    try {
        return mapperproxyfactory.newinstance(sqlsession);
    } catch (exception e) {
        throw new bindingexception("error getting mapper instance. cause: " + e, e);
    }
}

mapperproxyfactory创建代理对象：

public t newinstance(sqlsession sqlsession) {
    final mapperproxy<t> mapperproxy = new mapperproxy<>(sqlsession, mapperinterface, methodcache);
    return newinstance(mapperproxy);
}

protected t newinstance(mapperproxy<t> mapperproxy) {
    return (t) proxy.newproxyinstance(mapperinterface.getclassloader(), new class[]{mapperinterface}, mapperproxy);
}

mapperproxy是实际的代理类，它实现了invocationhandler接口。每当你调用一个mapper接口的方法时，都会调用invoke方法。在这个方法中，mybatis会判断该调用是否对应一个sql操作，并执行相应的sql语句：

public object invoke(object proxy, method method, object[] args) throws throwable {
    if (object.class.equals(method.getdeclaringclass())) {
        return method.invoke(this, args);
    } else {
        final mappermethod mappermethod = cachedmappermethod(method);
        return mappermethod.execute(sqlsession, args);
    }
}