Java环境中MyBatis与Spring或Spring MVC框架的集成方法

内容摘要
与Spring3集成

Spring作为基础框架，可以集成后端框架，如Hibernate，MyBatis等。
前面是介绍单独使用MyBatis的，大致逻辑是：

sqlSessionFactory <- configuration file (包括数
文章正文

与Spring3集成
Spring作为基础框架，可以集成后端框架，如Hibernate，MyBatis等。

前面是介绍单独使用MyBatis的，大致逻辑是：
sqlSessionFactory <- configuration file (包括数据库连接配置)
IXxxMapper <- sqlSession <- sqlSessionFactory
                     <- mapper interface <- mapper xml
得到IxxMapper后，就可以调用其方法进行数据交互了。

和Spring集成时，上面的这些对象需要作为bean来管理：
dataSource bean <- 数据库连接配置
sqlSessionFactory bean <- dataSource
                                     <- configuration file
userMapper bean <- sqlSessionFactory
                          <- mapper interface
1. 在pom.xml中加入依赖： 

<properties> 
 <mybatis.spring.version>1.2.1</mybatis.spring.version> 
 <dbcp.version>1.4</dbcp.version> 
 <spring.version>3.1.2.RELEASE</spring.version> 
</properties> 
 
<dependencies> 
 <dependency><!-- mybatis的几个对象包装成spring的bean --> 
  <groupId>org.mybatis</groupId> 
  <artifactId>mybatis-spring</artifactId> 
  <version>${mybatis.spring.version}</version> 
 </dependency> 
 <dependency><!-- spring上下文用spring-jdbc连接数据库 --> 
  <groupId>org.springframework</groupId> 
  <artifactId>spring-jdbc</artifactId> 
  <version>${spring.version}</version> 
 </dependency> 
 <dependency><!-- dataSource是BasicDataSource的实例 --> 
  <groupId>commons-dbcp</groupId> 
  <artifactId>commons-dbcp</artifactId> 
  <version>${dbcp.version}</version> 
 </dependency> 
 <dependency> 
  <groupId>org.springframework</groupId> 
  <artifactId>spring-test</artifactId> 
  <version>${spring.version}</version> 
 </dependency> 
</dependencies>

2. 在类路径下创建beans-da.xml文件： 

<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
 xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd"> 
 
 <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource"><!-- 数据库连接bean --> 
  <property name="driverClassName" value="com.mysql.jdbc.Driver" /> 
  <property name="url" value="jdbc:mysql://localhost:3306/hbatis?characterEncoding=utf8" /> 
  <property name="username" value="root" /> 
  <property name="password" value="123456" /> 
 </bean> 
  
 <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"><!-- sqlSessionFactory bean --> 
  <property name="dataSource" ref="dataSource" /><!-- 数据源 --> 
  <property name="configLocation" value="classpath:Configuration.xml" /><!-- 配置文件 --> 
 </bean> 
  
 <bean id="userMapper" class="org.mybatis.spring.mapper.MapperFactoryBean"><!-- user映射bean--> 
  <property name="sqlSessionFactory" ref="sqlSessionFactory" /> 
  <property name="mapperInterface" value="com.john.hbatis.mapper.IUserMapper" /><!-- 映射接口 --> 
 </bean> 
</beans>

3. 测试类： 

@ContextConfiguration(locations = { "classpath:beans-da.xml" }) 
public class SpringIntegrationTest extends AbstractTestNGSpringContextTests { 
  private static final Logger log = LoggerFactory.getLogger(SpringIntegrationTest.class); 
   
  @Resource 
  IUserMapper mapper; 
   
  @Test 
  public void queryTest() { 
    User user = mapper.getUserById(1); 
    log.info("Name: {}, address: {}", user.getName(), user.getAddress()); 
  } 
}

与SpringMVC集成
这里我们建立在与Spring3集成基础上来讲：
1. 往pom.xml添加SpringMVC和Freemarker依赖： 

<properties> 
 <freemarker.version>2.3.19</freemarker.version> 
 <servlet.version>2.5</servlet.version> 
</properties> 
 
<dependency>  
 <groupId>org.freemarker</groupId>  
 <artifactId>freemarker</artifactId>  
 <version>${freemarker.version}</version>  
</dependency> 
<dependency> 
 <groupId>javax.servlet</groupId>  
 <artifactId>servlet-api</artifactId>  
 <version>${servlet.version}</version> 
 <scope>provided</scope> 
</dependency>

2. 在web.xml中加入Spring的监听器和SpringMVC的servlet： 

<listener> 
 <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class><!-- 监听容器事件，初始化和关闭Web应用上下文并调用ContextCleanupListener清理资源 --> 
</listener> 
<listener> 
 <listener-class>org.springframework.web.context.ContextCleanupListener</listener-class><!-- Web应用关闭时，清理ServletContext中spring相关的可销毁资源 --> 
</listener> 
 
<servlet> 
 <servlet-name>hbatis</servlet-name> 
 <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> 
 <!--<init-param> 
  <param-name>contextConfigLocation</param-name> 
  <param-value>/WEB-INF/hbatis-servlet.xml</param-value> 
 </init-param>--><!-- 未配置时，SpringMVC会到WEB-INF目录下找${project.name}-servlet.xml --> 
 <load-on-startup>1</load-on-startup> 
</servlet> 
<servlet-mapping> 
 <servlet-name>hbatis</servlet-name> 
 <url-pattern>*.htm</url-pattern> 
</servlet-mapping>

3. 在WEB-INF下新建：

Spring配置文件applicationContext.xml：

<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
 xmlns:p="http://www.springframework.org/schema/p" 
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
 xmlns:context="http://www.springframework.org/schema/context" 
 xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd 
 http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd"> 
 
 <context:property-placeholder location="classpath:/database.properties" /><!-- 数据库配置文件 --> 
 
 <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" 
  p:driverClassName="${driverClassName}" 
  p:url="${url}" 
  p:username="${user_name}" 
  p:password="${password}" /><!-- 数据源配置 --> 
  
 <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"><!-- sqlSessionFactory对象 --> 
  <property name="dataSource" ref="dataSource" /><!-- 数据源 --> 
  <property name="configLocation" value="classpath:Configuration.xml" /><!-- myBatis配置文件 --> 
  <!--<property name="mapperLocations" value="classpath*:com/john/hbatis/model/*.xml" />--><!-- 可以在Configuration.xml或此处配置映射文件，但其中不能有相同id的parameterMap, resultMap或sql等 --> 
 </bean> 
  
 <bean id="mapperConfigurer" class="org.mybatis.spring.mapper.MapperScannerConfigurer"><!-- 扫描指定包以获取映射器 --> 
  <property name="basePackage" value="com.john.hbatis.mapper" /> 
 </bean> 
</beans>

类路径下的database.properties：

driverClassName=com.mysql.jdbc.Driver 
url=jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf8 
user_name=root 
password=123456


注：因为MapperScannerConfigurer可能会导致username取的是系统用户的账号，而造成数据库连接失败，所以改成其它值：user_name。

SpringMVC配置文件hbatis-servlet.xml：

<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
 xmlns:context="http://www.springframework.org/schema/context" 
 xmlns:mvc="http://www.springframework.org/schema/mvc" 
 xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd 
 http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd 
 http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd"> 
 
 <mvc:annotation-driven /><!-- 注册RequestMappingHandlerMapping, RequestMappingHandlerAdapter和ExceptionHandlerExceptionResolver以提供对@RequestMapping,@ExceptionHandler等注解的支持 --> 
 
 <context:component-scan base-package="com.john.hbatis.controller" /><!-- 扫描控制器包下有特定注解的类，并实例化和依赖注入 --> 
 
 <!-- FreeMarker视图处理器 --> 
 <bean id="viewResolverFtl" class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">  
  <property name="viewClass" value="org.springframework.web.servlet.view.freemarker.FreeMarkerView"/>  
  <property name="contentType" value="text/html;charset=utf-8"/>  
  <property name="prefix" value="" />  
  <property name="cache" value="false"/>  
  <property name="viewNames">  
    <array>  
      <value>*.ftl</value>  
    </array>  
  </property>  
  <!--<property name="suffix" value=".ftl"/>-->  
  <property name="order" value="0"/><!-- 优先级，数值越小优先级越高 -->  
 </bean> 
 
 <bean id="freemarkerConfig" class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">  
  <property name="templateLoaderPaths">  
    <list>  
      <value>/WEB-INF/ftl/</value><!-- 模板加载路径 -->  
    </list>  
  </property>  
 </bean> 
</beans>

4. MVC：
控制层：UserController.java

@Controller 
@RequestMapping("/article") 
public class UserController { 
 
  @Autowired 
  IUserMapper mapper; 
 
  @RequestMapping("/list") 
  public String showAll(ModelMap modelMap) { 
    List<Article> articles = mapper.getArticlesByUserId(1); 
    modelMap.addAttribute("articles", articles); 
    return "main.ftl"; 
  } 
}

视图层：main.ftl:

<#list articles as article> 
  <div>${article.id}. ${article.title}: ${article.content}</div> 
</#list>

5. 启动工程，浏览器输入：http://localhost:8080/hbatis/article/list.htm查看结果。
代码注释
上一篇Linux查看系统配置常用命令下一篇JavaEE7+Websockets+GlassFish4打造聊天室

作者：喵哥笔记

IDC笔记

学的不仅是技术，更是梦想！