SSM框架——详细整合教程（Spring+SpringMVC+MyBatis）

使用SSM（Spring、SpringMVC和Mybatis）已经有6个多月了࿰c;项目在技术上已经没有什么难点了࿰c;基于现有的技术就可以实现想要的功能࿰c;当然肯定有很多可以改进的地方。之前没有记录SSM整合的过程࿰c;这次刚刚好基于自己的一个小项目重新搭建了一次࿰c;而且比项目搭建的要更好一些。以前解决问题的过程和方法并没有及时记录࿰c;以后在自己的小项目中遇到我再整理分享一下。这次࿰c;先说说三大框架整合过程。个人认为使用框架并不是很难࿰c;关键要理解其思想࿰c;这对于我们提高编程水平很有帮助。不过࿰c;如果用都不会࿰c;谈思想就变成纸上谈兵了！！！先技术࿰c;再思想。实践出真知。

1、基本概念

1.1、Spring

    Spring是一个开源框架࿰c;Spring是于2003 年兴起的一个轻量级的Java 开发框架࿰c;由Rod Johnson 在其著作Expert One-On-One J2EE Development and Design中阐述的部分理念和原型衍生而来。它是为了解决企业应用开发的复杂性而创建的。Spring使用基本的JavaBean来完成以前只可能由EJB完成的事情。然而࿰c;Spring的用途不仅限于服务器端的开发。从简单性、可测试性和松耦合的角度而言࿰c;任何Java应用都可以从Spring中受益。 简单来说࿰c;Spring是一个轻量级的控制反转（IoC）和面向切面（AOP）的容器框架。

1.2、SpringMVC

    Spring MVC属于SpringFrameWork的后续产品࿰c;已经融合在Spring Web Flow里面。Spring MVC 分离了控制器、模型对象、分派器以及处理程序对象的角色࿰c;这种分离让它们更容易进行定制。

1.3、MyBatis

   MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code࿰c;并且改名为MyBatis 。MyBatis是一个基于Java的持久层框架。iBATIS提供的持久层框架包括SQL Maps和Data Access Objects（DAO）MyBatis 消除了几乎所有的JDBC代码和参数的手工设置以及结果集的检索。MyBatis 使用简单的 XML或注解用于配置和原始映射࿰c;将接口和 Java 的POJOs（Plain Old Java Objects࿰c;普通的 Java对象）映射成数据库中的记录。

2、开发环境搭建

如果需要࿰c;参看之前的博文：http://blog.csdn.net/zhshulin/article/details/30779873

3、Maven Web项目创建

4、SSM整合

    下面主要介绍三大框架的整合࿰c;至于环境的搭建以及项目的创建࿰c;参看上面的博文。这次整合我分了2个配置文件࿰c;分别是spring-mybatis.xml࿰c;包含spring和Mybatis的配置文件࿰c;还有个是spring-mvc的配置文件࿰c;此外有2个资源文件：jdbc.propertis和log4j.properties。完整目录结构如下（最后附上源码下载地址࿰c;不建议直接使用源码࿰c;因为此教程已经有了全部代码）：

使用框架都是较新的版本：

   Spring 4.0.2 RELEASE

   Spring MVC 4.0.2 RELEASE

   MyBatis 3.2.6

4.1、Maven引入需要的JAR包 为了方便后面说的时候不需要引入JAR包࿰c;我这里直接给出所有需要的JAR包࿰c;这都是基本的JAR包࿰c;每个包的是干什么的都有注释࿰c;就不再多说了。

pom.xml

4.2、Spring与MyBatis的整合 所有需要的JAR包都引入以后࿰c;首先进行Spring与MyBatis的整合࿰c;然后再进行JUnit测试࿰c;先看一个项目结构图：

4.2.1、建立JDBC属性文件 jdbc.properties（文件编码修改为utf-8）

driver=com.mysql.jdbc.Driver url=jdbc:mysql://10.221.10.111:8080/db_zsl username=demao password=demao #定义初始连接数 initialSize=0 #定义最大连接数 maxActive=20 #定义最大空闲 maxIdle=20 #定义最小空闲 minIdle=1 #定义最长等待时间 maxWait=60000

4.2.2、建立spring-mybatis.xml配置文件 这个文件就是用来完成spring和Mybatis的整合的。这里面也没多少行配置࿰c;主要的就是自动扫描࿰c;自动注入࿰c;配置数据库。注释也很详细࿰c;大家看看就明白了。

spring-mybatis.xml

<?xml version="1.0" encoding="UTF-8"?>

<context:component-scan base-package=“com.cn.hnust” />

<bean id="datasource" class="org.apache.commons.dbcp.basicDatasource"
	destroy-method="close">
	<property name="driverClassName" value="${driver}" />
	<property name="url" value="${url}" />
	<property name="username" value="${usernamE}" />
	<property name="password" value="${passworD}" />
	<!-- 初始化连接大小 -->
	<property name="initialSize" value="${initialSizE}"></property>
	<!-- 连接池最大数量 -->
	<property name="maxActive" value="${maxActivE}"></property>
	<!-- 连接池最大空闲 -->
	<property name="maxIdle" value="${maxIdlE}"></property>
	<!-- 连接池最小空闲 -->
	<property name="minIdle" value="${minIdlE}"></property>
	<!-- 获取连接最大等待时间 -->
	<property name="maxWait" value="${maxWait}"></property>
</bean>

<!-- spring和MyBatis完美整合࿰c;不需要mybatis的配置映射文件 -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
	<property name="datasource" ref="datasource" />
	<!-- 自动扫描mapping.xml文件 -->
	<property name="mapper@R_450_5352@ns" value="classpath:com/cn/hnust/mapping/*.xml"></property>
</bean>

<!-- DAO接口所在包名࿰c;Spring会自动查找其下的类 -->
<bean class="org.mybatis.spring.mapper.MapperScAnnerConfigurer">
	<property name="basePackage" value="com.cn.hnust.dao" />
	<property name="sqlSessionFactoryBeAnname" value="sqlSessionFactory"></property>
</bean>

<!-- (事务管理)transaction manager, use JtatransactionManager for global tx -->
<bean id="transactionManager"
	class="org.springframework.jdbc.datasource.DatasourcetransactionManager">
	<property name="datasource" ref="datasource" />
</bean>

4.2.3、Log4j的配置

  为了方便调试࿰c;一般都会使用日志来输出信息࿰c;Log4j是Apache的一个开放源代码项目࿰c;通过使用Log4j࿰c;我们可以控制日志信息输送的目的地是控制台、文件、GUI组件࿰c;甚至是套接口服务器、NT的事件记录器、UNIX Syslog守护进程等；我们也可以控制每一条日志的输出格式；通过定义每一条日志信息的级别࿰c;我们能够更加细致地控制日志的生成过程。

  Log4j的配置很简单࿰c;而且也是通用的࿰c;下面给出一个基本的配置࿰c;换到其他项目中也无需做多大的调整࿰c;如果想做调整或者想了解Log4j的各种配置࿰c;参看我转载的一篇博文࿰c;很详细：

http://blog.csdn.net/zhshulin/article/details/37937365

下面给出配置文件目录：

log4j.properties

#定义LOG输出级别 log4j.rootLogger=INFO,Console,File #定义日志输出目的地为控制台 log4j.appender.Console=org.apache.log4j.ConsoleAppender log4j.appender.Console.Target=System.out #可以灵活地指定日志输出格式࿰c;下面一行是指定具体的格式 log4j.appender.Console.layout = org.apache.log4j.PatternLayout log4j.appender.Console.layout.ConversionPattern=[%c] - %m%n

#文件大小到达指定尺寸的时候产生一个新的文件 log4j.appender.File = org.apache.log4j.RollingFileAppender #指定输出目录 log4j.appender.File.File = logs/ssm.log #定义文件最大大小 log4j.appender.File.MaxFileSize = 10MB

log4j.appender.File.Threshold = ALL log4j.appender.File.layout = org.apache.log4j.PatternLayout log4j.appender.File.layout.ConversionPattern =[%p] [%d{yyyy-MM-dd HH:mm:ss}][%c]%m%n

4.2.4、JUnit测试

  经过以上步骤（到4.2.2࿰c;log4j不配也没影响）࿰c;我们已经完成了Spring和Mybatis的整合࿰c;这样我们就可以编写一段测试代码来试试是否成功了。

4.2.4.1、创建测试用表 既然我们需要测试࿰c;那么我们就需要建立在数据库中建立一个测试表࿰c;这个表建的很简单࿰c;sql语句为：

drop table IF EXISTS user_t;

create table user_t ( id int(11) NOT NULL AUTO_INCREMENT, user_name varchar(40) NOT NULL, password varchar(255) NOT NULL, age int(4) NOT NULL, PRIMARY KEY (id) ) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8;

/*Data for the table user_t */

insert into user_t(id,user_name,password,age) values (1,‘测试’,‘sfasgfaf’,24);

4.2.4.2、利用MyBatis Generator自动创建代码 参考博文：http://blog.csdn.net/zhshulin/article/details/23912615

   这个可根据表自动创建实体类、MyBatis映射文件以及DAO接口࿰c;当然࿰c;我习惯将生成的接口名改为IUserDao࿰c;而不是直接用它生成的UserMapper。如果不想麻烦就可以不改。完成后将文件复制到工程中。如图：

4.2.4.3、建立service接口和实现类 目录结构：

下面给出具体的内容：

IUserservice.jave

package com.cn.hnust.service;

import com.cn.hnust.pojo.User;

public interface IUserservice { public User getUserById(int userId); }

UserserviceImpl.java package com.cn.hnust.service.impl;

import javax.Annotation.resource;

import org.springframework.stereotype.service;

import com.cn.hnust.dao.IUserDao; import com.cn.hnust.pojo.User; import com.cn.hnust.service.IUserservice;

@service(“userservice”) public class UserserviceImpl implements IUserservice { @resource private IUserDao userDao; @Override public User getUserById(int userId) { // TODO Auto-generated method stub return thiS.UserDao.SELEctByprimaryKey(userId); }

}

4.2.4.4、建立测试类 测试类在src/test/java中建立࿰c;下面测试类中注释掉的部分是不使用Spring时࿰c;一般情况下的一种测试方法；如果使用了Spring那么就可以使用注解的方式来引入配置文件和类࿰c;然后再将service接口对象注入࿰c;就可以进行测试了。

   如果测试成功࿰c;表示Spring和Mybatis已经整合成功了。输出信息使用的是Log4j打印到控制台。

package org.zsl.testmybatis;

import javax.Annotation.resource;

import org.apache.log4j.Logger; import org.junit.before; import org.junit.Test; import org.junit.runner.RunWith; import org.springframework.context.ApplicationContext; import org.springframework.context.support.ClassPathXmlApplicationContext; import org.springframework.test.context.ContextConfiguration; import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;

import com.alibaba.fastjson.JSON; import com.cn.hnust.pojo.User; import com.cn.hnust.service.IUserservice;

@RunWith(SpringJUnit4ClassRunner.class) //表示继承了SpringJUnit4ClassRunner类 @ContextConfiguration(@R_450_5352@ns = {“classpath:spring-mybatis.xml”})

public class TestMyBatis { private static Logger logger = Logger.getLogger(TestMyBatis.class); // private ApplicationContext ac = null; @resource private IUserservice userservice = null;

// @Before // public void before() { // ac = new ClassPathXmlApplicationContext(“applicationContext.xml”); // userservice = (IUserservicE) ac.getBean(“userservice”); // }

@Test
public void test1() {
	User user = userservice.getUserById(1);
	// System.out.println(user.getUserName());
	// logger.info("值："+user.getUserName());
	logger.info(JSON.toJSONString(user));
}

}

测试结果：

至此࿰c;完成Spring和Mybatis这两大框架的整合࿰c;下面在继续进行SpringMVC的整合。

4.3、整合SpringMVC 上面已经完成了2大框架的整合࿰c;SpringMVC的配置文件单独放࿰c;然后在web.xml中配置整合。

4.3.1、配置spring-mvc.xml 配置里面的注释也很详细࿰c;在此就不说了࿰c;主要是自动扫描控制器࿰c;视图模式࿰c;注解的启动这三个。

<?xml version="1.0" encoding="UTF-8"?>

<context:component-scan base-package=“com.cn.hnust.controller” /> text/html;charset=UTF-8

<!-- 配置文件上传࿰c;如果没有使用文件上传可以不用配置࿰c;当然如果不配࿰c;那么配置文件中也不必引入上传组件包 -->
<bean id="multipartResolver"  
    class="org.springframework.web.multipart.commons.CommonsMultipartResolver">  
    <!-- 默认编码 -->
    <property name="defaultEncoding" value="utf-8" />  
    <!-- 文件大小最大值 -->
    <property name="maxUploadSize" value="10485760000" />  
    <!-- 内存中的最大值 -->
    <property name="maxInMemorySize" value="40960" />  
</bean> 

4.3.2、配置web.xml文件 这里面对spring-mybatis.xml的引入以及配置的spring-mvc的Servlet就是为了完成SSM整合࿰c;之前2框架整合不需要在此处进行任何配置。配置一样有详细注释࿰c;不多解释了。

web.xml

<?xml version="1.0" encoding="UTF-8"?>

Archetype Created Web Application contextConfig@R_450_5352@n classpath:spring-mybatis.xml encodingFilter org.springframework.web.filter.CharacterEncodingFilter true encoding UTF-8 encodingFilter /* org.springframework.web.context.ContextLoaderListener org.springframework.web.util.IntrospectorCleanupListener

<!-- Spring MVC servlet -->
<servlet>
	<servlet-name>SpringMVC</servlet-name>
	<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
	<init-param>
		<param-name>contextConfig@R_450_5352@n</param-name>
		<param-value>classpath:spring-mvc.xml</param-value>
	</init-param>
	<load-on-startup>1</load-on-startup>
	<async-supported>true</async-supported>
</servlet>
<servlet-mapping>
	<servlet-name>SpringMVC</servlet-name>
	<!-- 此处可以可以配置成*.do࿰c;对应struts的后缀习惯 -->
	<url-pattern>/</url-pattern>
</servlet-mapping>
<welcome-file-list>
	<welcome-file>/index.jsp</welcome-file>
</welcome-file-list>

4.3.3、测试 至此已经完成了SSM三大框架的整合了࿰c;接下来测试一下࿰c;如果成功了࿰c;那么恭喜你࿰c;如果失败了࿰c;继续调试吧࿰c;作为程序员就是不停的与BUG做斗争！

4.3.3.1、新建jsp页面

showUser.jsp 此页面仅输出一下用户名࿰c;完成一个完整的简单流程。

<%@ page language=“java” import=“java.util.*” pageEncoding=“utf-8”%>

${user.userNamE}

4.3.3.2、建立UserController类 UserController.java 控制器

package com.cn.hnust.controller;

import javax.Annotation.resource; import javax.servlet.http.httpServletrequest;

import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.Annotation.requestMapping;

import com.cn.hnust.pojo.User; import com.cn.hnust.service.IUserservice;

@Controller @requestMapping("/user") public class UserController { @resource private IUserservice userservice;

@requestMapping("/showUser")
public String toIndex(httpServletrequest request,Model model){
	int userId = Integer.parseInt(request.getParameter("id"));
	User user = thiS.Userservice.getUserById(userId);
	model.addAttribute("user", user);
	return "showUser";
}

}

4.3.3.3、部署项目 输入地址：localhost:8080/项目名称/user/showUser?id=1

至此࿰c;SSM三大框架的整合就完成了࿰c;在此基础上可再添加其他功能。