mybatis之mybatis-config.xml 配置详解

本文详细介绍了MyBatis配置文件的各项参数设置,包括缓存、延迟加载、执行器类型等,以及环境配置、数据源设置等内容。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

<?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>  
        <!-- 这个配置使全局的映射器启用或禁用缓存 -->  
        <setting name="cacheEnabled" value="true" />  
        <!-- 全局启用或禁用延迟加载。当禁用时,所有关联对象都会即时加载 -->  
        <setting name="lazyLoadingEnabled" value="true" />
<!-- 当启用时,有延迟加载属性的对象在被调用时将会完全加载任意属性。否则,每种属性将会按需要加载 -->  
        <setting name="aggressiveLazyLoading" value="true" />  
<!-- 允许或不允许多种结果集从一个单独的语句中返回(需要适合的驱动) -->  
        <setting name="multipleResultSetsEnabled" value="true" />  
<!-- 使用列标签代替列名。不同的驱动在这方便表现不同。参考驱动文档或充分测试两种方法来决定所使用的驱动 -->  
        <setting name="useColumnLabel" value="true" />  
<!-- 允许JDBC支持生成的键。需要适合的驱动。如果设置为true则这个设置强制生成的键被使用,尽管一些驱动拒绝兼容但仍然有效(比如Derby) -->  
        <setting name="useGeneratedKeys" value="true" />  
<!-- 指定MyBatis如何自动映射列到字段/属性。PARTIAL只会自动映射简单,没有嵌套的结果。FULL会自动映射任意复杂的结果(嵌套的或其他情况) -->  
        <setting name="autoMappingBehavior" value="PARTIAL" />  
<!--当检测出未知列(或未知属性)时,如何处理,默认情况下没有任何提示,这在测试的时候很不方便,不容易找到错误。
NONE : 不做任何处理 (默认值)
WARNING : 警告日志形式的详细信息
FAILING : 映射失败,抛出异常和详细信息
-->
<setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
<!-- 配置默认的执行器。SIMPLE执行器没有什么特别之处。REUSE执行器重用预处理语句。BATCH执行器重用语句和批量更新 -->  
        <setting name="defaultExecutorType" value="SIMPLE" /> 
<!-- 设置超时时间,它决定驱动等待一个数据库响应的时间 -->  
        <setting name="defaultStatementTimeout" value="25000" />  
<!--设置查询返回值数量,可以被查询数值覆盖  -->
<setting name="defaultFetchSize" value="100"/>
<!-- 允许在嵌套语句中使用分页-->
<setting name="safeRowBoundsEnabled" value="false"/>
<!--是否开启自动驼峰命名规则(camel case)映射,即从经典数据库列名 A_COLUMN 到经典 Java 属性名 aColumn 的类似映射。-->
<setting name="mapUnderscoreToCamelCase" value="false"/>
<!--MyBatis 利用本地缓存机制(Local Cache)防止循环引用(circular references)和加速重复嵌套查询。 默认值为 SESSION,这种情况下会缓存一个会话中执行的所有查询。 若设置值为 STATEMENT,本地会话仅用在语句执行上,对相同 SqlSession 的不同调用将不会共享数据。-->
<setting name="localCacheScope" value="SESSION"/>
<!-- 当没有为参数提供特定的 JDBC 类型时,为空值指定 JDBC 类型。 某些驱动需要指定列的 JDBC 类型,多数情况直接用一般类型即可,比如 NULL、VARCHAR OTHER。-->
<setting name="jdbcTypeForNull" value="OTHER"/>
<!-- 指定哪个对象的方法触发一次延迟加载。-->
<setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/> 
    </settings>  

    <!-- 别名定义 -->  
    <typeAliases>  
        <typeAlias alias="pageAccessURL" type="com.lgm.mybatis.model.PageAccessURL" />  
    </typeAliases>  

    <!--自定义类型处理器 -->
    <typeHandlers>
<!-- <typeHandler handler="com.xhm.util.BooleanTypeHandlder" /> -->
<!--扫描整个包下的自定义类型处理器-->
<package name="com.xhm.util"/>
    </typeHandlers>

    <!--plugins插件之 分页拦截器  -->
    <plugins>
    <plugin interceptor="com.xhm.util.PageInterceptor"></plugin>
    </plugins>

    <!--配置environment环境-->
    <environments default="development">  
        <!-- 环境配置1,每个SqlSessionFactory对应一个环境 -->  
        <environment id="development1">  
            <!-- 事务配置 type= JDBC、MANAGED 1.JDBC:这个配置直接简单使用了JDBC的提交和回滚设置。它依赖于从数据源得到的连接来管理事务范围。   
                2.MANAGED:这个配置几乎没做什么。它从来不提交或回滚一个连接。而它会让容器来管理事务的整个生命周期(比如Spring或JEE应用服务器的上下文)。 默认情况下它会关闭连接。然而一些容器并不希望这样,因此如果你需要从连接中停止它,将closeConnection属性设置为false -->  
            <transactionManager type="JDBC" />  
        <!-- <transactionManager type="MANAGED">   
             <property name="closeConnection" value="false"/>   
             </transactionManager> -->  
            <!-- 数据源类型:type = UNPOOLED、POOLED、JNDI 1.UNPOOLED:这个数据源的实现是每次被请求时简单打开和关闭连接。它有一点慢,这是对简单应用程序的一个很好的选择,因为它不需要及时的可用连接。   
                不同的数据库对这个的表现也是不一样的,所以对某些数据库来说配置数据源并不重要,这个配置也是闲置的 2.POOLED:这是JDBC连接对象的数据源连接池的实现,用来避免创建新的连接实例时必要的初始连接和认证时间。   
                这是一种当前Web应用程序用来快速响应请求很流行的方法。 3.JNDI:这个数据源的实现是为了使用如Spring或应用服务器这类的容器,容器可以集中或在外部配置数据源,然后放置一个JNDI上下文的引用 -->  
            <dataSource type="UNPOOLED">  
                <property name="driver" value="com.mysql.jdbc.Driver" />  
                <property name="url" value="jdbc:mysql://localhost:3306/xhm" />  
                <property name="username" value="root" />  
                <property name="password" value="root" />  
                <!-- 默认连接事务隔离级别 <property name="defaultTransactionIsolationLevel" value=""   
                    /> -->  
            </dataSource>  
        </environment>  
  
        <!-- 环境配置2 -->  
        <environment id="development2">  
            <transactionManager type="JDBC" />  
            <dataSource type="POOLED">  
                <property name="driver" value="com.mysql.jdbc.Driver" />  
                <property name="url" value="jdbc:mysql://localhost:3306/xhm" />  
                <property name="username" value="root" />  
                <property name="password" value="root" />  
                <!-- 在任意时间存在的活动(也就是正在使用)连接的数量 -->  
                <property name="poolMaximumActiveConnections" value="10" />  
                <!-- 任意时间存在的空闲连接数 -->  
                <property name="poolMaximumIdleConnections" value="5" />  
                <!-- 在被强制返回之前,池中连接被检查的时间 -->  
                <property name="poolMaximumCheckoutTime" value="20000" />  
                <!-- 这是给连接池一个打印日志状态机会的低层次设置,还有重新尝试获得连接,这些情况下往往需要很长时间(为了避免连接池没有配置时静默失败) -->  
                <property name="poolTimeToWait" value="20000" />  
                <!-- 发送到数据的侦测查询,用来验证连接是否正常工作,并且准备接受请求。 -->  
                <property name="poolPingQuery" value="NO PING QUERY SET" />  
                <!-- 这是开启或禁用侦测查询。如果开启,你必须用一个合法的SQL语句(最好是很快速的)设置poolPingQuery属性 -->  
                <property name="poolPingEnabled" value="false" />  
                <!-- 这是用来配置poolPingQuery多次时间被用一次。这可以被设置匹配标准的数据库连接超时时间,来避免不必要的侦测 -->  
                <property name="poolPingConnectionsNotUsedFor" value="0" />  
            </dataSource>  
        </environment>  
  
        <!-- 环境配置3 -->  
        <environment id="development3">  
            <transactionManager type="JDBC" />  
            <dataSource type="JNDI">  
                <property name="data_source" value="java:comp/env/jndi/mybatis" />  
                <property name="env.encoding" value="UTF8" />  
                <!-- <property name="initial_context" value=""/> <property name="env.encoding"   
                    value="UTF8"/> -->  
            </dataSource>  
        </environment>  
    </environments>  
  
    <!-- 映射文件,mapper的配置文件 -->  
    <mappers>
<!--直接映射到相应的mapper文件-->
<mapper resource="com/xhm/mapper/UserMapper.xml"/>
<!--扫描包路径下所有xxMapper.xml文件-->
<package name="com.xhm.mapper"/>
    </mappers>  
  
</configuration> 

转载于:https://my.oschina.net/u/2971326/blog/897254

<think>好的,我需要解决用户关于MyBatis配置文件mybatis-config.xml路径和内容的疑问。用户提到“classpath:mybatis/mybatis-config.xml”,所以首先得明确classpath在项目中的位置。首先,classpath通常指项目编译后的资源目录,比如在Maven项目中,src/main/resources目录下的文件会直接在classpath根目录下。如果用户配置的是classpath:mybatis/mybatis-config.xml,那这个文件应该位于resources/mybatis目录下。需要确认用户的项目结构是否正确,比如是否在正确的位置创建了mybatis文件夹,并将配置文件入其中。接下来,关于配置文件的内容,用户提供的引用中提到了mybatis-config.xml的基本结构,比如environments配置数据源、事务管理,以及mappers指定映射文件的位置。需要把这些内容整理出来,说明各个部分的作用,比如settings中的日志配置,typeAliases别名处理等。用户可能遇到的问题是配置文件路径错误导致MyBatis无法加载,或者配置内容有误导致连接数据库失败。需要给出典型的配置示例,并指出常见配置项,如数据库驱动、URL、用户名密码,以及日志输出的设置方法,如使用STDOUT_LOGGING来在控制台打印SQL日志。另外,用户之前的问题是关于SQL日志的配置,所以需要确保在当前的回答中提到的日志配置部分与之前的指引一致,比如引用中的settingname="logImpl"value="STDOUT_LOGGING",这对应之前提到的MyBatis原生配置方法。可能需要强调在mybatis-config.xml中设置这个选项,而不是在application.yml中,取决于用户使用的是纯MyBatis还是整合了Spring Boot。 最后,生成相关问题时要围绕配置文件的路径、内容、常见配置错误以及与其他框架整合时的注意事项,帮助用户扩展可能遇到的其他问题。</think>### MyBatis配置文件`mybatis-config.xml`路径及内容解析 --- #### 一、配置文件路径说明 `classpath:mybatis/mybatis-config.xml`表示该配置文件位于**项目的资源目录(classpath)下的`mybatis`文件夹中**。具体路径取决于项目结构: 1. **Maven/Gradle项目**: - 标准资源目录:`src/main/resources/mybatis/mybatis-config.xml` - 编译后路径:`target/classes/mybatis/mybatis-config.xml`(Maven)或`build/resources/main/mybatis/mybatis-config.xml`(Gradle)[^1] 2. **非Maven项目**: - 需确保`mybatis-config.xml`位于类加载器可识别的资源路径中,例如`WEB-INF/classes/mybatis/` --- #### 二、配置文件核心内容 以下为典型的`mybatis-config.xml`结构(包含事务管理、数据源、日志配置等): ```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> <!-- 全局参数设置 --> <settings> <!-- 开启日志输出(控制台打印SQL) --> <setting name="logImpl" value="STDOUT_LOGGING"/> <!-- 开启驼峰命名映射 --> <setting name="mapUnderscoreToCamelCase" value="true"/> </settings> <!-- 数据源配置 --> <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/test_db"/> <property name="username" value="root"/> <property name="password" value="123456"/> </dataSource> </environment> </environments> <!-- 映射文件配置 --> <mappers> <mapper resource="mybatis/UserMapper.xml"/> </mappers> </configuration> ``` **关键配置项说明**: 1. **`<settings>`**:定义全局行为,如日志实现、缓存策略等[^4] 2. **`<environments>`**:配置数据库连接池和事务管理器[^2] 3. **`<mappers>`**:指定Mapper XML文件路径(支持`resource`、`class`、`package`等方式)[^1] --- #### 三、常见问题排查 1. **配置文件未找到**: - 检查文件是否位于`resources/mybatis`目录 - 确认Maven的`pom.xml`中是否包含资源声明: ```xml <resources> <resource> <directory>src/main/resources</directory> <includes> <include>**/*.xml</include> </includes> </resource> </resources> ``` 2. **配置未生效**: - 确认MyBatis初始化时正确加载了配置文件(如`SqlSessionFactoryBuilder`的输入流路径) - 若整合Spring Boot,需在`application.yml`中指定配置文件路径: ```yaml mybatis: config-location: classpath:mybatis/mybatis-config.xml ``` --- ###
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值