ibatis教程怎么使用？,ibatis是什么

iBatis是一个通过SQL映射实现数据库操作的轻量级持久层框架，核心在于SqlMapConfig.xml配置文件和SQL映射文件的编写，掌握这两个文件即可快速上手。

ibatis入门教程：从零开始搭建环境

环境搭建是iBatis入门的第一步，多数开发者初次接触时容易卡在配置文件上，下面按实际搭建顺序列出关键步骤,每一步都附带可验证的操作路径。

加载中

【 ibatis视频教程】

擅长写bug的王同学

207611-

原视频地址

• 添加依赖：iBatis 2.x版本通常使用单独的jar包，如果你用Maven，可以在pom.xml中加入ibatis-2-2-0.jar的依赖，注意旧版iBatis在中央仓库中可能标记为org.apache.ibatis.ibatis，如果不用Maven,直接下载jar包放入classpath。
• 创建全局配置文件：在src目录下新建SqlMapConfig.xml，这是所有配置的入口，文件内部需要声明DTD，并配置<properties>、<settings>、<environments>和<mappers>等元素。
• 配置数据源：在<environments>中定义<dataSource>，使用JDBC连接池，如SimpleDataSourceFactory，并指定驱动、URL、用户名和密码，建议将数据库连接信息外置到db.properties，通过<properties resource="db.properties"/>引入。
• 定义POJO类：创建一个简单的JavaBean，例如User类，包含id、name、email属性，并生成getter/setter，POJO不需要实现任何接口,iBatis通过反射进行映射。
• 编写SQL映射文件：新建User.xml，在<sqlMap>中定义<insert>、<select>等操作，映射文件中需指定namespace，但iBatis 2.x不强制,推荐使用全限定名。
• 注册映射文件：在SqlMapConfig.xml的<mappers>中添加<sqlMap resource="com/example/User.xml"/>。
• 初始化SqlMapClient：通过XmlSqlMapClientBuilder解析配置文件，构建SqlMapClient实例，这个对象是线程安全的，通常在应用启动时创建一次,后续所有DAO操作都通过它完成。

完成以上步骤后，就可以编写一个简单的测试类，调用sqlMapClient.insert("User.insertUser", user)来验证是否成功，注意，iBatis 2.x中执行SQL时传入的字符串参数是映射文件中的<insert>、<select>等标签的id属性，并且需要带命名空间前缀（如User.insertUser）。

ibatis配置文件详解：掌握全局配置

SqlMapConfig.xml是iBatis的全局配置中心，很多初学者因为不熟悉标签含义而导致运行时异常，下面列出最常用的5个配置元素,并说明它们的典型用法。

重点配置说明：

• <settings>中的cacheModelsEnabled默认关闭，开启后需在映射文件中配置<cacheModel>。lazyLoadingEnabled控制是否启用延迟加载,建议在多表关联场景下开启。
• <environments>可以配置多个<environment>，每个<environment>需要指定id属性，并在<sqlMapConfig>的default属性中指定默认使用的环境ID。
• 数据源配置：iBatis内置了SimpleDataSourceFactory、DbcpDataSourceFactory和JndiDataSourceFactory，大多数场景使用SimpleDataSourceFactory，直接配置JDBC参数即可，注意，生产环境一般推荐使用连接池,如DBCP。

事务管理

iBatis的事务管理器有两种：JDBC和JTA。JDBC事务通过Connection的commit/rollback控制，适合单数据库场景；JTA事务需配置JTA事务管理器，用于分布式事务，多数应用中，使用JDBC事务管理器即可。

注册映射文件的两种方式

• resource：基于classpath加载，如<sqlMap resource="com/example/User.xml"/>。
• url：基于文件系统路径加载，如<sqlMap url="file:///D:/config/User.xml"/>。

ibatis映射文件实战：sql映射实例

SQL映射文件是iBatis的核心，你需要在其中定义所有数据库操作语句，下面以一个完整的User表增删改查为例,展示映射文件的写法。

定义结果映射

使用<resultMap>来映射查询结果到Java对象，在<resultMap>中，<result>标签的property对应POJO属性，column对应数据库字段。

<resultMap id="userResult" class="User">
    <result property="id" column="id"/>
    <result property="name" column="name"/>
    <result property="email" column="email"/>
</resultMap>

插入操作

<insert>标签中写SQL语句，使用占位符引用参数对象的属性，可以通过<selectKey>获取自增主键值。

<insert id="insertUser" parameterClass="User">
    INSERT INTO user (name, email) VALUES (#name#, #email#)
    <selectKey keyProperty="id" resultClass="int">
        SELECT LAST_INSERT_ID()
    </selectKey>
</insert>

查询操作

<select>标签需要指定resultMap或resultClass，如果查询结果字段与POJO属性完全一致，可以直接用resultClass；否则推荐使用resultMap。

<select id="getUserById" parameterClass="int" resultMap="userResult">
    SELECT  FROM user WHERE id = #id#
</select>

更新和删除

更新和删除操作不需要结果映射,直接写SQL即可。

<update id="updateUser" parameterClass="User">
    UPDATE user SET name = #name#, email = #email# WHERE id = #id#
</update>
<delete id="deleteUser" parameterClass="int">
    DELETE FROM user WHERE id = #id#
</delete>

多条件查询

iBatis 2.x支持动态SQL标签，如<isNotEmpty>、<isEqual>等,用于根据条件动态拼接查询语句。

<select id="searchUsers" parameterClass="java.util.Map" resultMap="userResult">
    SELECT  FROM user WHERE 1=1
    <isNotEmpty prepend="AND" property="name">
        name LIKE '%$name$%'
    </isNotEmpty>
    <isNotEmpty prepend="AND" property="email">
        email = #email#
    </isNotEmpty>
</select>

注意：$name$表示直接拼接字符串，存在SQL注入风险，建议仅在确实需要模糊查询且参数可信时使用，否则优先使用#name#预编译。

ibatis与mybatis区别：选择更适合你的框架

行业共识认为，iBatis和MyBatis本质上是同一个框架的迭代版本，但MyBatis在3.0版本后进行了大量重构，两者在API、配置方式、动态SQL和接口绑定上有显著差异,下面用表格对比主要区别：

迁移建议：如果你正在维护旧项目，iBatis 2.x仍然可以正常工作，但新项目建议直接使用MyBatis，MyBatis在社区活跃度、文档完善度和功能丰富度上远超iBatis，iBatis 2.x的配置逻辑和映射思想与MyBatis高度相似,学通iBatis后就很容易上手MyBatis。

ibatis使用教程java：常见问题与优化技巧

在实际开发中，使用iBatis时可能会遇到性能、分页、缓存等问题,下面列出几个常见场景及对应的解决方案。

分页查询

iBatis本身不提供万能分页方案，需要结合数据库方言,常见做法有两种：

• 使用

  

  RowBounds：在查询时传入RowBounds对象，指定偏移量和行数，但RowBounds实际上是内存分页，对于大数据量效率很低,多数情况下不推荐使用。

• 手动编写分页SQL：在映射文件中写带LIMIT的SQL（MySQL）或ROWNUM（Oracle），通过参数传入起始位置和页面大小,这是生产环境中更常用的方式。

二级缓存

iBatis支持二级缓存，通过<cacheModel>在映射文件中配置，缓存模型可以基于内存、LRU、FIFO等策略，开启二级缓存后，同一个SqlMapClient实例下的查询结果会被缓存，适合读多写少的场景，但要注意，更新操作会自动清空相关缓存，如果有多表关联更新,需要手动配置缓存刷新规则。

批量操作

iBatis没有内置的批量Executor，但可以通过SqlMapClient的startBatch()和executeBatch()方法实现批量提交，将多个insert/update语句放入批次中，最后一次性提交，能显著减少数据库交互次数,具体操作：

sqlMapClient.startBatch();
for (User user : userList) {
    sqlMapClient.insert("User.insertUser", user);
}
sqlMapClient.executeBatch();

注意，批量操作在事务中执行时,需要在批次结束后手动提交事务。

避免N+1查询

当查询主表数据并关联子表数据时，如果使用嵌套查询（<resultMap>中的<result property="orders" column="id" select="Order.selectByUserId"/>），会导致每一条主记录都执行一次子查询，产生N+1问题，解决方法是改用嵌套结果映射，通过一次连接查询将关联数据一次性查出，并用<resultMap>的<collection>或<association>进行映射。

iBatis教程常见问题解答

问题1：iBatis和MyBatis可以混用吗？

从技术层面看，iBatis 2.x和MyBatis 3.x的API、配置文件格式完全不同，混用意味着在同一个项目中同时维护两套配置和调用方式，极易导致混乱，因此行业共识认为不建议混用，如果项目在升级过程中，建议统一迁移到MyBatis，迁移成本并不高,因为SQL映射逻辑基本一致。

问题2：iBatis如何实现软删除？

软删除通常通过更新SQL实现，不真正删除数据，在映射文件中编写update语句，将deleted标记字段设为1，查询时自动过滤deleted=0的记录。

<update id="softDeleteUser" parameterClass="int">
    UPDATE user SET deleted = 1 WHERE id = #id#
</update>

然后在所有查询语句中添加AND deleted = 0条件，你可以将这一条件封装在基础映射文件中,或者通过动态SQL统一生成。

问题3：iBatis映射文件中的占位符和有什么区别？

占位符会被预编译为，由JDBC驱动处理参数转义，能有效防止SQL注入，是推荐用法，占位符直接拼接字符串，不会进行预编译，存在SQL注入风险，但适用于表名、字段名等不能使用预编译参数的位置，在实际开发中，用户输入的数据必须使用,仅在需要动态改变表名或排序字段等场景下谨慎使用。

iBatis 2.x虽然已逐渐被MyBatis取代，但其清晰的SQL映射思想和稳定的性能依然在大量遗留系统中发挥作用，掌握iBatis的配置和映射原理，可以让你在维护旧项目时游刃有余,也为学习MyBatis打下坚实基础。