标签:pac 系统 targe 通过 分享 代码 source 没有 result
初学 Spring 整合 Mybatis,虽然网贴无数,但是每次试行下来,总会发生这样那样的问题。最终经过数天的不断尝试,总算是成功运行了,遇到的多数坑也一一绕过,特此记录已备查:
一、关于依赖包
网上的很多帖子杂七杂八加入了各种依赖包,有时看的人头晕脑胀,经过实测,实际需要的依赖包,只有下面三组:
<!-- 1.基础Spring依赖 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> </dependency>
<dependency> <groupId>org.springframework</groupId> <artifactId>spring-beans</artifactId> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context-support</artifactId> </dependency> <!-- 2.基础日志系统依赖 --> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> </dependency> <!--3.单元测试依赖 --> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> </dependency> <!--spring单元测试依赖 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-test</artifactId> </dependency> <!-- 4.基础数据库依赖 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-jdbc</artifactId> </dependency> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> </dependency> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> </dependency> <dependency> <groupId>commons-dbcp</groupId> <artifactId>commons-dbcp</artifactId> </dependency>
以上有两个可选项:
spring-beans 不引入也不会报错,只是出于习惯,将该包作为 spring 的基础依赖包引入;
commons-dbcp 取决你是否使用其作为数据源管理,如果使用 spring-jdbc 管理数据源,则不需要引入这个这个依赖;
其他包为必须项,不引入就会引发常见的【坑1】
二、关于文件结构:
java 代码的结构,按照常规标准创建。mybatis generator 一级一些文章建议将映射配置文件放在src 里,但这会导致【坑2】,因此对于 resources 文件的配置,强烈建议如下结构创建:
mapper 目录:存储数据库映射配置文件,建议为映射接口名加 Mapper;
mybatis 目录:mybatis 的私有配置文件,由于目前初学,并没有加入实际的配置内容;
properties目录:数据库连接信息等配置文件;
spring 目录:spring 相关的配置文件,例如数据源、mybatis 整合等;
根目录下的 applicationContext 作为IoC主入口配置文件;
log4j 为日志的配置文件,不放在根目录需要增加类读取(这步未实践)
三、配置文件内容
1、主入口文件 applicationContext.xml
<!-- propertyConfigurer 读取properties 目录中属性文件 --> <bean id="propertyConfigurer" class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"> <property name="locations"> <list> <value>classpath:properties/*.properties</value> </list> </property> </bean> <!-- 导入单独的相关配置文件 --> <import resource="spring/applicationContext-datasource.xml"/> <import resource="spring/applicationContext-mybatis.xml"/> <!-- 自动扫描注解的bean,经过实测,base 到src 的根目录空间就可以了,不用详细至 service 层的目录 --> <context:component-scan base-package="com.test" />
2、db 的 properties 文件写法比较常规,无需单独指出,只是务必注意任何符号千万不要是全角的(坑3)
3、 数据源配置文件applicationContext-datasource.xml,注意数据源管理类的使用(坑4)
<!-- 定义数据源,具备最基本的数据连接即可,其余的附加配置在生产环境中注意配置就好 --> <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close"> <property name="driverClassName" value="${jdbc.driverClassName}"/> <property name="url" value="${jdbc.url}"/> <property name="username" value="${jdbc.username}"/> <property name="password" value="${jdbc.password}"/> </bean>
<!-- spring管理事务 --> <bean id="txManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"> <property name="dataSource" ref="dataSource" /> </bean>
4、spring 整合 mybatis 配置文件 applicationContext-mybatis.xml,务必注意 MapperScanner 的配置和映射文件的配置,(坑5)
<!-- 通过扫描的模式,自动注入bean,务必注意这里的 basePackage 指向到映射接口所在的包 --> <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="com.test.dao" /> <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/> </bean> <!-- 配置sqlSessionFactory --> <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="configLocation" value="classpath:mybatis/mybatis-config.xml"/> <property name="dataSource" ref="dataSource" /> <property name="mapperLocations"> <list> <value>classpath:mapper/*.xml</value> </list> </property> </bean>
5、映射文件的配置 xxxMapper.xml,(坑6)
<mapper namespace="com.test.dao.IUserDAO"> <resultMap id="BaseResultMap" type="com.test.pojo.User"> <id property="userId" column="USER_ID"/> <result property="userName" column="USER_NAME"/> <result property="userPassword" column="USER_PASSWORD"/> <result property="userEmail" column="USER_EMAIL"/> </resultMap> <select id="getAllUsers" resultMap="BaseResultMap"> SELECT * from t_user </select> </mapper>
四、那些我踩过的坑
坑1:ClassNotFound,对于繁杂的依赖,有时搞不清楚,会遗漏,或者加入一些无用的,文一所陈列的为最小依赖包范围;
坑2:所有配置都对,就是无法加载映射文件,后来发现是因为 src下的非 java 文件未编译至 target 目录下的 classes 环境所导致,虽然可以通过 mave的 plugin 来自动复制,但是没必要,建议还是写在 resource 目录为好;
坑3:这是作为国人比较无奈的,有时不留神会写下一些全角符号而又未发现,编译并不报错,只会在测试或者运行时莫名其妙的提示错误;
坑4:准确来说,这不是个坑,取决于参考代码是使用的什么,如果使用 dbcp 管理,就务必不要忘了导入 commons-dbcp 依赖;
坑5:接近成功的最后一次大坑,检查了所有的,都没有错,死活就是无法生成对象,最后经过请教别人提醒,再次检查才发现,由于修改过映射接口包的名字,而这里忘了同步修改,再次呕血
坑6:这算是个学习坑吧,如果数据库表名包含下划线,最好定义 BaseResultMap 来指定字段和 pojo 对象属性的映射关系,不然无法映射成功
以上,就是最近一周学习 spring+mybatis 的收获,学习 java 直接从中段开始,果然有些费力啊!!!
标签:pac 系统 targe 通过 分享 代码 source 没有 result
原文地址:http://www.cnblogs.com/bashenandi/p/spring-with-mybatis-concept.html